curl --request POST \
--url https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "5511999999999",
"type": "template",
"template": {
"name": "pedido_pronto",
"language": {
"code": "pt_BR"
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "Rafael"
},
{
"type": "text",
"text": "7539"
}
]
}
]
}
}
'{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "5511999999999",
"wa_id": "5511999999999"
}
],
"messages": [
{
"id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=",
"message_status": "accepted"
}
]
}{
"error": {
"message": "(#132000) Number of parameters does not match the expected number of params",
"type": "OAuthException",
"code": 132000,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Templates
Enviar template
Envia uma mensagem de template aprovado pela Meta. É o único tipo aceito quando a janela de 24 horas está fechada.
POST
/
v1
/
{phone_number_id}
/
messages
curl --request POST \
--url https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "5511999999999",
"type": "template",
"template": {
"name": "pedido_pronto",
"language": {
"code": "pt_BR"
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "Rafael"
},
{
"type": "text",
"text": "7539"
}
]
}
]
}
}
'{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "5511999999999",
"wa_id": "5511999999999"
}
],
"messages": [
{
"id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=",
"message_status": "accepted"
}
]
}{
"error": {
"message": "(#132000) Number of parameters does not match the expected number of params",
"type": "OAuthException",
"code": 132000,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Use
Como a associação é feita pelo nome, os parâmetros podem ser enviados em qualquer ordem.
type: "template" para iniciar ou retomar uma conversa quando a janela de 24 horas está fechada. O template precisa estar aprovado pela Meta.
Os valores das variáveis são informados em components, e o formato depende do parameter_format definido em Criar template.
Variáveis posicionais
No formatoPOSITIONAL, os valores são preenchidos na ordem das variáveis {{1}}, {{2}}:
{
"messaging_product": "whatsapp",
"to": "5511999999999",
"type": "template",
"template": {
"name": "pedido_pronto",
"language": { "code": "pt_BR" },
"components": [
{
"type": "body",
"parameters": [
{ "type": "text", "text": "Rafael" },
{ "type": "text", "text": "7539" }
]
}
]
}
}
Variáveis nomeadas
No formatoNAMED, cada parâmetro indica a qual variável pertence, pelo campo parameter_name:
{
"messaging_product": "whatsapp",
"to": "5511999999999",
"type": "template",
"template": {
"name": "retirada_equipamento",
"language": { "code": "pt_BR" },
"components": [
{
"type": "body",
"parameters": [
{ "type": "text", "parameter_name": "nome", "text": "Rafael" },
{ "type": "text", "parameter_name": "numero_os", "text": "7539" }
]
}
]
}
}
O formato usado no envio precisa corresponder ao formato definido na criação do template. Um template criado como
NAMED não aceita parâmetros posicionais, e o inverso também se aplica.Idioma
Olanguage.code precisa ser o mesmo idioma aprovado para aquele nome, como pt_BR. Um template existe de forma independente em cada idioma.
Para cabeçalho com mídia e botões dinâmicos, consulte a visão geral de templates da Meta.Autorizações
Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.
Parâmetros de caminho
ID do número que envia a mensagem. Descubra com GET /me.
Corpo
application/json
Sempre whatsapp.
Opções disponíveis:
whatsapp Exemplo:
"whatsapp"
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"
Sempre template.
Opções disponíveis:
template Exemplo:
"template"
Template aprovado e os valores das suas variáveis.
Show child attributes
Show child attributes
Sempre individual.
Opções disponíveis:
individual Exemplo:
"individual"
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.
Resposta
Envio aceito pela Meta. Não confirma a entrega.