Pular para o conteúdo principal
POST
Enviar botão com link
Envia uma mensagem com um botão que abre uma URL no navegador do celular do cliente. O cliente vê só o texto do botão, como Acompanhar entrega ou Pagar agora, e não o endereço completo. Isso deixa a mensagem mais limpa do que colar um link longo no texto. A janela de 24 horas precisa estar aberta.
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.

Estrutura da mensagem

A mensagem é do tipo interactive, com interactive.type igual a cta_url:

Botão

O botão fica em interactive.action, com name igual a cta_url e dois parâmetros:
A Meta não documenta um webhook para o toque no botão. Para medir cliques, inclua um parâmetro de rastreamento na URL, como ?origem=whatsapp ou um identificador do cliente, e registre o acesso no seu site.

Cabeçalho

O cabeçalho é opcional e aceita um texto ou uma mídia: A mídia do cabeçalho segue as mesmas regras e formatos de Enviar imagem, Enviar vídeo e Enviar documento: informe link ou id, nunca os dois.
No Testar, a mensagem já vem preenchida com cabeçalho de texto, texto, rodapé e o botão. Troque a url pelo endereço que o cliente deve abrir. Veja mais detalhes na documentação de botão com link 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:interactive
obrigatório

Sempre interactive.

Opções disponíveis:
interactive
Exemplo:

"interactive"

interactive
object
obrigatório

Mensagem com um botão que abre uma URL.

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.