NODInfra

Enviar Mensagem

Enviar botão PIX

POSThttps://api.nodinfra.com.br/send/pix-button
URL completa: https://api.nodinfra.com.br/send/pix-button

Envia um botão nativo do WhatsApp que abre para pagamento PIX com a chave informada. O usuário visualiza o detalhe do recebedor, nome e chave.

Regras principais

  • pixType aceita: CPF, CNPJ, PHONE, EMAIL, EVP (case insensitive)
  • pixName padrão: "Pix" quando não informado - nome de quem recebe o pagamento

Campos comuns

Este endpoint herda os campos opcionais padronizados da tag "Enviar Mensagem": delay, readchat, readmessages, replyid, mentions, track_source, track_id e async.

Exemplo de payload

{
  "number": "5511999999999",
  "pixType": "EVP",
  "pixKey": "123e4567-e89b-12d3-a456-426614174000",
  "pixName": "Loja Exemplo"
}

Corpo da requisição

numberstringobrigatório

ID do chat para o qual a mensagem será enviada. Pode ser um número de telefone em formato internacional, um ID de grupo (`@g.us`), um ID de usuário (com `@s.whatsapp.net` ou `@lid`).

exemplo: 5511999999999

pixTypestringobrigatório

Tipo da chave PIX. Valores aceitos: CPF, CNPJ, PHONE, EMAIL ou EVP

exemplo: EVP

pixKeystringobrigatório

Valor da chave PIX (CPF/CNPJ/telefone/email/EVP)

exemplo: 123e4567-e89b-12d3-a456-426614174000

pixNamestringopcional

Nome exibido como recebedor do PIX (padrão "Pix" se vazio)

exemplo: Loja Exemplo

asyncbooleanopcional

Enfileira o envio para processamento assíncrono

delayintegeropcional

Atraso em milissegundos antes do envio (exibe "digitando..." no WhatsApp)

readchatbooleanopcional

Marca o chat como lido após enviar a mensagem

readmessagesbooleanopcional

Marca mensagens recentes como lidas após o envio

replyidstringopcional

ID da mensagem que será respondida

mentionsstringopcional

Lista de números mencionados separados por vírgula

track_sourcestringopcional

Origem de rastreamento (ex.: chatwoot, crm-interno)

track_idstringopcional

Identificador de rastreamento (aceita valores duplicados)

Respostas

200Botão PIX enviado com sucesso
400Requisição inválida
401Não autorizado
500Erro interno do servidor

Testar endpoint

POSThttps://api.nodinfra.com.br/send/pix-button
cURL
curl -X POST 'https://api.nodinfra.com.br/send/pix-button' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'