Mensagens
Enviar PIX
Envia a chave PIX com botão de copiar. O cartão nativo de pagamento exige WhatsApp Cloud API.
Quando usar
Cobrança avulsa, checkout informal, doação. O destinatário vê a chave e toca em Copiar.
keyType: EMAIL, CPF, CNPJ, PHONE ou EVP (chave aleatória).
O botão payment_info nativo só renderiza em contas Cloud API. No companion ele pede para atualizar o WhatsApp — por isso o Wagzap envia cta_copy.
POST
/api/message/pix/{instance}Enviar PIX
Chave PIX com botão copiar.
Auth: TokenInstance
Body
| Campo | Tipo | Descrição | |
|---|---|---|---|
number | string | obrigatório | destino |
key | string | obrigatório | chave PIX |
keyType | string | EVP | CPF | CNPJ | EMAIL | PHONE | |
merchantName | string | nome do recebedor | |
contentText | string | texto do card |
cURL
curl -X POST https://api.wagzap.com.br/api/message/pix/vendas \
-H "token: $TOKEN_INSTANCE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999999999",
"key": "financeiro@empresa.com",
"keyType": "EMAIL",
"merchantName": "Empresa",
"contentText": "Pagar pedido #123"
}'Resposta
{
"success": true,
"messageId": "3EB08FCF27E532F1F5F5",
"data": { "messageId": "3EB08FCF27E532F1F5F5" }
}Erros
| HTTP | Mensagem |
|---|---|
| 400 | number and message required / payload inválido |
| 401 | missing token / invalid token |
| 403 | token does not match instance |
| 404 | instance not found |
| 429 | rate limit exceeded (padrão 100/min) |
| 502 | Falha no WhatsApp / instância desconectada |