Pular para o conteúdo principal
POST
Enviar contato
Envia um ou mais cartões de contato para um cliente com a janela de 24 horas aberta. É útil para passar o contato de um vendedor, do suporte ou de outra unidade.
O destinatário pode ser informado pelo número de telefone (to) ou pelo ID do usuário (recipient). Se os dois forem enviados, vale o to; para enviar pelo ID do usuário, deixe o to em branco. Veja a diferença em Destinatário.

Dados do contato

Cada item de contacts é um cartão. O único campo obrigatório é name.formatted_name, o nome exibido no cartão. Os demais são opcionais: Uma mensagem aceita até 257 contatos, mas o recomendado é enviar poucos, para facilitar a leitura do cliente.

Botões do cartão

O wa_id do telefone define os botões que o cliente vê: Informe no wa_id o número do contato no WhatsApp, com código do país e DDD, como 5511988887777.
Alguns dados, como endereço, aniversário e e-mail, podem não aparecer em todos os aparelhos do cliente.
No Testar, o cartão já vem preenchido com um contato de exemplo. Troque pelos dados do contato que você quer enviar. Veja mais detalhes na documentação de mensagens de contato da Meta.

Autorizações

Authorization
string
header
obrigatório

Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.

Parâmetros de caminho

phone_number_id
string
obrigatório

ID do número que envia a mensagem. Descubra com GET /me.

Corpo

application/json
messaging_product
enum<string>
padrão:whatsapp
obrigatório

Sempre whatsapp.

Opções disponíveis:
whatsapp
Exemplo:

"whatsapp"

to
string
obrigatório

Número do destinatário com código do país e DDD, como 5511999999999. Tem prioridade sobre recipient: para enviar pelo ID do usuário, deixe em branco.

Exemplo:

"5511999999999"

type
enum<string>
padrão:contacts
obrigatório

Sempre contacts.

Opções disponíveis:
contacts
Exemplo:

"contacts"

contacts
object[]
obrigatório

Cartões de contato enviados na mensagem. Aceita até 257 contatos, mas o recomendado é enviar poucos.

recipient_type
enum<string>
padrão:individual

Sempre individual.

Opções disponíveis:
individual
Exemplo:

"individual"

recipient
string

ID do usuário no WhatsApp (BSUID), recebido nos webhooks em from_user_id e contacts[].user_id, como BR.13491208655302741918. Usado quando to não é informado.

context
object

Responde citando uma mensagem anterior da conversa.

Resposta

Envio aceito pela Meta. Não confirma a entrega.