Como enviar mensagens do WhatsApp
Este guia trata do endpoint de envio, POST /v1/whatsapp/messages. Você monta um único payload JSON com um destinatário e exatamente um tipo de conteúdo: um template pré-aprovado ou uma mensagem de serviço com texto, imagem, vídeo, áudio, figurinha, documento, localização, cartões de contato ou algo para tocar. O Bird retorna 202 Accepted com um ID de mensagem e faz a entrega de forma assíncrona. Qual dos dois você pode enviar depende da janela de atendimento ao cliente. Cada solicitação envia uma mensagem para um destinatário, e não existe endpoint de envio em lote.
Um envio mínimo
O menor payload válido contém um destinatário to e um template com seu slug. Adicione language se quiser um idioma específico; se você omitir esse campo, o template é enviado no idioma padrão. Preencha as variáveis que o template declara por meio de parameters.
A chamada curl usa o host dos EUA; se sua chave começar com bk_eu1_, chame https://eu1.platform.bird.com. Os SDKs leem a região a partir da sua chave, por isso não definem host.
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
parameters: { code: "123456" },
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+15551234567",
template="bird_otp",
language="en",
parameters={"code": "123456"},
)
print(msg.id, msg.status)msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+15551234567",
Template: "bird_otp",
Language: "en",
Parameters: map[string]any{"code": "123456"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)$message = $bird->whatsapp->send(
to: '+15551234567',
template: 'bird_otp',
language: 'en',
parameters: ['code' => '123456'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"code":"123456"}' \
--template bird_otp \
--to +15551234567curl -X POST "https://{region}.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "+15551234567",
"template": {
"slug": "bird_otp",
"language": "en",
"parameters": {
"code": "123456"
}
}
}'A janela de atendimento ao cliente
O que você pode enviar depende de um único estado: se a janela de atendimento ao cliente está aberta.
O contato abre a janela ao enviar uma mensagem ou ligar para o número da sua empresa. Ela fica aberta por 24 horas e reinicia sempre que ele envia uma nova mensagem. Enquanto ela estiver aberta, você pode enviar uma mensagem de serviço, ou seja, qualquer conteúdo livre: texto, imagem, vídeo, áudio, figurinha, documento, localização, cartões de contato ou conteúdo interativo. Depois que ela expira, só um template pré-aprovado chega ao contato, e a resposta dele reabre a janela.
O Bird acompanha a janela por você, então uma mensagem de serviço enviada com a janela fechada é recusada antes que algo seja criado ou cobrado: a solicitação retorna 422 E15044 WhatsAppServiceWindowClosed. A verificação é feita com base no melhor esforço e, em caso de falha, deixa a solicitação passar. Por isso, um 202 não comprova que a janela estava aberta no momento do disparo. Se a janela expirar entre o aceite e o disparo, a falha ocorre de forma assíncrona, com service_window_expired no last_error da mensagem.
Consulte a janela de atendimento ao cliente para ver o ciclo de vida completo: o que a abre, o que a reinicia e como ela se relaciona com os preços.
Montando o payload
Destinatário
to indica um único destino, informado como número de telefone, ID de usuário com escopo de empresa ou ID de grupo. O número de telefone segue o formato E.164: um + inicial, o código do país e o número do assinante, como +14155550100. Nós validamos o número, então um valor que não pode ser um número real e discável (comprimento errado, prefixo não atribuído) é rejeitado com um 422 WhatsAppInvalidRecipient antes de qualquer cobrança. Não existe array de destinatários nem envio em lote, então, para alcançar várias pessoas que não estão em um mesmo grupo, você faz uma chamada por destinatário.
Um ID de usuário com escopo de empresa, como US.13491208655302741918, endereça um contato cujo número de telefone você não tem. É assim que você responde a um contato que entrou em contato sem informar o número. Três coisas mudam. O número de envio precisa pertencer ao mesmo portfólio empresarial ao qual o ID está vinculado. Um template de código de verificação de uso único exige um número de telefone: um template gerenciado pela Bird é recusado no aceite com um 422 WhatsAppRecipientNotSupportedForTemplate, e um template de autenticação criado pelo seu espaço de trabalho é aceito e depois falha, porque a Meta exige um número de telefone para ele. Um template com preço máximo é aceito e depois falha com o erro 131062 da Meta; envie-o para um número de telefone ou use um template com preço padrão.
to aceita mais um formato: um ID de grupo do WhatsApp, como wag_01krdgeqcxet5s7t44vh8rt9mg, que envia a mensagem para todos os participantes desse chat em grupo. Um envio para grupo omite from e informa a entrega para o grupo como um todo, e não para um único destinatário. Por isso, Enviando para um grupo do WhatsApp trata desse caso em uma página própria.
Template
template indica o template pré-aprovado a ser enviado:
slug(obrigatório): o slug do template, comobird_order_confirmation. Ele precisa corresponder a um template do seu catálogo (letras minúsculas, dígitos e sublinhados).language: a tag de idioma do template, comoenoupt-BR. Omita-a para enviar o idioma padrão do template. Se você indicar um idioma que o template não tem, a resposta será um422com a lista dos idiomas disponíveis. A mensagem aceita retorna o idioma resolvido.parameters: os valores que preenchem as variáveis do template, em um único objeto com chaves por nome (consulte Componentes e parâmetros). Omita-o para um template sem variáveis.components: os mesmos valores no formato de componentes da Meta, em vez deparameters. Alguns templates aceitam apenas esse formato.
Consulte seus templates, os idiomas de cada um e uma prévia renderizada na página Templates.
Componentes e parâmetros
Os templates contêm variáveis, nomeadas ({{ref}}, {{amount}}) ou numeradas ({{1}}, {{2}}). Preencha-as por meio de parameters, em um único objeto. O variables da versão do template lista as chaves que ele aceita e marca as opcionais. Cada chave é uma destas:
- o próprio nome de uma variável nomeada, como
order_id - o número de uma variável numerada, como
1 header_url,header_filenameouheader_locationpara um cabeçalho de mídia ou de localização, eheader_url_1,header_url_2e assim por diante para o cabeçalho de um cartão de carrosselbutton_urlpara o sufixo numerado de um botão de URL, ebutton_url_1,button_url_2e assim por diante para o botão de um cartão de carrossel. Um sufixo nomeado usa o próprio nome.codepara o código de um template de autenticação e para o valor de um botão de copiar código- uma entrada lida pelas vinculações de parâmetros do idioma
Cada valor é uma string, um número ou um booleano. header_location aceita um objeto com latitude e longitude. Se você omitir um cabeçalho de mídia, o template é enviado com a amostra aprovada. Um template importado da Meta não tem amostra, então ele precisa da chave do cabeçalho de mídia. As chaves que o idioma não usa são ignoradas.
{
"to": "+15551234567",
"from": "+13124495648",
"template": {
"slug": "order_update",
"language": "en",
"parameters": { "order_id": "A-4192", "first_name": "Ava" }
}
}No CLI, passe o objeto com --parameters:
bird whatsapp send --to +15551234567 --from +13124495648 \
--template order_update --language en \
--parameters '{"order_id":"A-4192","first_name":"Ava"}'Um template de autenticação cujo corpo diz {{1}} is your verification code e cujo botão copia o código recebe o código uma única vez como code. O Bird preenche o corpo e o botão com ele:
{
"parameters": { "code": "481920" }
}Um idioma cujas vinculações leem dados de contato, como bird.contact.first_name, não pode ser enviado como mensagem individual e retorna E15091. Nesse caso, envie-o em um broadcast, em que o contato de cada destinatário preenche os valores. Um broadcast ignora o destinatário cujos dados de contato deixam vazio um valor obrigatório. Envie parameters ou components, nunca os dois. Alguns templates aceitam apenas parameters: aqueles cujo idioma calcula os valores com vinculações de parâmetros e aqueles com variáveis nomeadas em um cartão de carrossel ou na URL de um botão.
Alguns modelos aceitam apenas components, porque uma única chave não consegue distinguir os espaços deles. Isso acontece quando um modelo numera {{1}} em mais de um bloco, como o cabeçalho e o corpo. Também acontece quando um bloco tem dois botões de URL com sufixos numerados, ou uma variável {{button_url}} ao lado de um botão de URL numerado. Enviar um modelo assim com parameters retorna 422.
Preencha um template por componente. components é a alternativa a parameters e a única forma para um template que uma única chave não consegue endereçar. Cada componente indica um type (header, body, button ou carousel) e um array parameters. Um carousel recebe um array cards em vez disso, com uma entrada por cartão aprovado, na ordem de aprovação. Cada cartão contém o próprio array components de entradas header, body e button. Cada parâmetro indica o próprio type (text, image, video, gif, document ou location) e traz o campo correspondente: text uma string simples, image/video/gif/document um url https público e location um ponto no mapa. Um template com parâmetros nomeados exige um name em cada parâmetro, correspondendo exatamente aos nomes que o template declara (consulte a Referência de campos). Um template posicional omite name e recebe os valores na ordem de {{n}}, de modo que o primeiro parâmetro preenche {{1}}. Em ambos os casos, parâmetros que não correspondem ao que o template declara retornam 422 WhatsAppTemplateParameterMismatch. Um componente header em um template gerenciado pela Bird é descartado, já que nenhum template gerenciado pela Bird declara uma variável de cabeçalho; já em um template criado pelo seu espaço de trabalho, ele é repassado, e é assim que um template de utilidade ou de marketing com cabeçalho de mídia recebe a imagem.
O mesmo modelo de código de verificação recebe o código como parâmetro do corpo e como parâmetro do botão, de forma posicional (sem name):
{
"components": [
{ "type": "body", "parameters": [{ "type": "text", "text": "481920" }] },
{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }
]
}Categoria e remetente
A categoria de um modelo (authentication, utility ou marketing) determina como a WhatsApp trata a mensagem e, junto com o país de destino, quanto ela custa.
Quem é o dono do remetente define se você precisa indicá-lo:
- Um modelo gerenciado pela Bird (o slug começa com
bird_) é enviado do número que a Bird mantém para essa categoria, então omitafrom. Defini-lo retorna422WhatsAppSenderNotAllowed. - Todo o resto indica o próprio remetente em
from: uma mensagem de serviço de qualquer tipo e qualquer modelo criado pelo seu espaço de trabalho. O número precisa pertencer ao seu espaço de trabalho. Omiti-lo retorna422WhatsAppSenderRequired, e um número do qual o espaço de trabalho não pode enviar retorna422WhatsAppSenderNotFound. Um modelo criado por você também precisa estar na mesma conta do WhatsApp Business que o número; caso contrário, o envio retorna422WhatsAppSenderWABAMismatch.
A configuração de números de telefone aborda os dois tipos de número e como conectar um número próprio.
Mensagens de serviço
Em vez de template, inclua exatamente um entre text, image, video, audio, sticker, document, location, contact_cards ou interactive. Os nove são mensagens de serviço, então exigem uma janela de atendimento ao cliente aberta. Todos também exigem from, um número que pertença ao seu espaço de trabalho; os números gerenciados pela Bird não podem enviá-las.
text:{ "body": "..." }, com até 4.096 caracteres. Adicione"preview_url": truepara exibir uma prévia do primeiro link embody.image,video,audio,sticker,document: cada um recebe uma URLhttpspública que o WhatsApp busca no momento do envio (url), então uma URL assinada precisa continuar válida até depois do envio. Uma URLhttpé rejeitada de imediato. O WhatsApp busca o próprio arquivo, então uma URL que ele não consegue acessar, uma que serve um tipo não suportado ou um arquivo acima do limite de tamanho do seu tipo é aceito e depois falha, commedia_rejectednolast_errorda mensagem e o motivo informado pelo próprio WhatsApp emdescription.image,videoedocumenttambém aceitam umcaptionopcional;documenttambém aceita umfilenameopcional;audioaceita uma flagvoiceopcional para exibição como mensagem de voz.location:{ "latitude": ..., "longitude": ... }(ambos obrigatórios, em graus decimais), além denameeaddressopcionais.contact_cards: um array de até cinco contatos compartilhados em uma única mensagem. Onamede cada cartão precisa deformatted_namee de pelo menos uma outra parte (first_name,last_name,middle_name,prefixousuffix);phone_numbers,emails,urlseaddressesaceitam até dez entradas cada, eorgebirthday(comoYYYY-MM-DD) são opcionais. Umphone_numberem E.164 dá ao cartão um botão que abre uma conversa com esse número.interactive: texto do corpo e algo para tocar, em um de seis tipos: botões de resposta, um menu de lista, um botão de link, um carrossel de mídia ou um único botão que pede ao destinatário sua localização ou seu número de telefone. Mensagens interativas descreve o formato de cada tipo na requisição, as respostas geradas por um toque e os limites.
{
"to": "+16505551234",
"from": "+13124495648",
"text": { "body": "Your order shipped: https://example.com/track/A1B2C3", "preview_url": true }
}Uma solicitação sem conteúdo, ou com mais de um tipo, é rejeitada com 422.
Citar uma mensagem
Defina in_reply_to_message_id como o ID de uma mensagem do WhatsApp para enviar sua mensagem como resposta a ela, assim como tocar em responder no app WhatsApp cita uma mensagem. O destinatário vê sua mensagem com a mensagem citada acima dela, e o campo é retornado em toda leitura da mensagem.
Também funciona no sentido inverso: uma mensagem recebida que o WhatsApp marca como resposta traz o ID da mensagem citada no mesmo campo, e é assim que você identifica qual das suas mensagens uma resposta responde. Uma mensagem recebida que o WhatsApp não marca não traz ID, e a resolução também pode falhar. Para uma correlação confiável, use identificadores explícitos de resposta interativa junto com o estado de conversa ou de tarefa armazenado pela sua aplicação. Os metadata de saída ficam no registro de saída e não são copiados automaticamente para a resposta.
A citação é resolvida antes de o envio ser aceito, então uma citação que não pode ser exibida faz a própria solicitação falhar, e nada é criado nem cobrado. Um id que não corresponde a nenhuma mensagem deste espaço de trabalho, ou a uma mensagem com mais de 15 dias, o prazo em que uma mensagem pode ser citada, retorna 404 E15071 WhatsAppReferencedMessageNotFound. Um id de uma mensagem que nunca chegou ao WhatsApp, ou de uma mensagem de outra conversa que não a definida por to e from deste envio, retorna 422 E15072 WhatsAppMessageNotQuotable. Se o Bird não conseguir acessar o armazenamento que responde a essa verificação, o envio retorna 503 E15073 WhatsAppMessageLookupUnavailable, e vale a pena tentar novamente. A citação funciona tanto em envios de template quanto em envios de formato livre.
{
"to": "+16505551234",
"from": "+13124495648",
"in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
"text": { "body": "Yes, that slot is still free." }
}Tags e metadados
Três campos opcionais anexam seu próprio contexto a uma mensagem; os três são retornados nas leituras de API e acompanham todos os eventos de webhook da mensagem:
tags: até 20 rótulos{ "name": ..., "value": ... }estruturados para dimensões de baixa cardinalidade pelas quais você filtra e gera relatórios (uma campanha, uma variante de experimento). Nomes e valores aceitam letras ASCII, dígitos, sublinhado e hífen; os nomes têm no máximo 32 caracteres e são únicos em um envio, e os valores têm no máximo 64. Filtre a lista de mensagens por tag (?tag=campaignou?tag=campaign:launch-week); a página Metrics detalha a entrega por tag.metadata: um objeto JSON arbitrário, de até 2 KB serializado, para o contexto de cada envio que você não precisa usar como dimensão de filtro (um ID de pedido interno, uma referência de sessão).reference: uma string de 1 a 255 caracteres pela qual você quer encontrar a mensagem, como um número de pedido ou de chamado.?reference=na lista de mensagens a compara exatamente, diferenciando maiúsculas de minúsculas, e várias mensagens podem compartilhar o mesmo valor. Defina esse campo só quando precisar pesquisar por ele e coloque qualquer outro dado emmetadata.
{
"tags": [{ "name": "campaign", "value": "order-confirmations" }],
"metadata": { "order_id": "ord_8271" },
"reference": "ord_8271"
}Referência de campos
| Campo | Tipo | Obrigatório | Limites / observações |
|---|---|---|---|
to | string | sim | Um destinatário por mensagem: um número de telefone E.164, um ID de usuário com escopo de empresa, que nenhum template de código de verificação de uso único ou de preço máximo aceita, ou um ID de grupo do WhatsApp (wag_…), que envia para todos os participantes desse grupo |
from | string (E.164) | não** | Omita para um template gerenciado pela Bird, que escolhe o próprio remetente, e para um envio a grupo, que usa o número do próprio grupo; obrigatório para uma mensagem de serviço e para um template criado pelo seu espaço de trabalho, e precisa ser um número que pertence ao seu espaço de trabalho |
template.slug | string | não** | Um slug de template que seu espaço de trabalho pode enviar; os slugs gerenciados pela Bird começam com bird_ |
template.language | string | não* | Tag de idioma do template (en, pt-BR); omita para enviar o idioma padrão do template |
template.parameters | objeto | não | Preenche as variáveis do template por nome, como ref ou code; no máximo 16 KB, e bird é reservado |
template.components | array | não | A alternativa a parameters, com uma entrada por componente: type é header, body, button ou carousel, e um carousel recebe cards em vez de parameters |
template.components[].parameters[].name | string | não† | O placeholder que este valor preenche, como ref; obrigatório e deve corresponder aos nomes declarados pelo template quando ele usa parâmetros nomeados, e omitido quando ele usa parâmetros posicionais |
text | objeto | não** | Mensagem de serviço em texto simples {body, preview_url?} (até 4.096 caracteres); consulte Texto simples |
image, video, audio, sticker, document | objeto | não** | Mensagem de serviço com mídia, com url (e caption ou filename opcionais, quando houver suporte); consulte Mensagens de serviço |
location | objeto | não** | Marcador {latitude, longitude, name?, address?}; consulte Localizações |
contact_cards | array | não** | Até 5 objetos de contato vCard estruturados; consulte Cartões de contato |
interactive | objeto | não** | Texto do corpo mais um tipo de conteúdo tocável; é uma mensagem de serviço, então exige uma janela de atendimento aberta. Consulte Mensagens interativas |
in_reply_to_message_id | string | não | Um ID de mensagem do WhatsApp mantido por este espaço de trabalho, citado na mensagem que você envia; retornado nas leituras. Consulte Citar uma mensagem |
tags | array | não | Até 20 rótulos {name, value}; nome ≤ 32 caracteres, valor ≤ 64, nomes únicos |
reference | string | não | De 1 a 255 caracteres; correspondência exata para ?reference= na lista de mensagens |
metadata | objeto | não | JSON arbitrário, até 2 KB serializado |
* language é opcional; se você o omitir, o template é enviado no idioma padrão.
† name é obrigatório em todos os parâmetros de um template com parâmetros nomeados. Omita-o em um template posicional. Consulte Componentes e parâmetros.
** Inclua exatamente um entre template ou um campo de conteúdo de mensagem de serviço (text, image, video, audio, sticker, document, location, contact_cards, interactive); consulte Mensagens de serviço.
O modelo assíncrono: o que significa 202
Um envio bem-sucedido retorna 202 Accepted com um ID de mensagem e status: accepted. O 202 só é retornado depois que o envio é aceito de forma durável; um envio nunca é aceito e depois descartado silenciosamente. Falhas definitivas que você pode corrigir falham imediatamente com um 422: um destinatário inválido, um slug ou idioma de template desconhecido, parâmetros incompatíveis ou uma mensagem de serviço enviada com a janela de atendimento ao cliente fechada (WhatsAppServiceWindowClosed). Um envio que a carteira não consegue cobrir também falha imediatamente, com 402 WalletInsufficientBalance. Uma mensagem que já tinha sido aceita quando a cobrança falha termina como rejected com insufficient_balance. A entrega em si acontece de forma assíncrona: a mensagem passa para sent quando a entregamos ao WhatsApp e depois para um status final (delivered ou failed) quando o recibo chega, informado por eventos, webhooks e pelos endpoints de leitura. Uma confirmação de leitura aparece separadamente, como um timestamp read_at e um evento whatsapp.read, e não como um status.
Uma observação sobre privacidade: para templates da categoria authentication, o API nunca retorna os valores preenchidos. O eco 202 e todas as leituras posteriores trazem um array components vazio para essas mensagens, para que um código de verificação nunca reapareça.
Como tentar novamente com segurança
Envie o cabeçalho Idempotency-Key com um valor único por envio lógico, e as novas tentativas passam a ser seguras. Se a sua primeira solicitação teve sucesso, mas você não recebeu a resposta (tempo esgotado, conexão interrompida), repeti-la com a mesma chave retorna o resultado original em vez de enviar e cobrar uma mensagem duplicada. A resposta repetida traz um cabeçalho Idempotency-Replay. Consulte idempotência para ver o formato da chave e o período de retenção.
Como receber a resposta
As mensagens recebidas ficam no mesmo recurso que as enviadas, e cada uma delas reinicia a janela de atendimento. Como receber mensagens do WhatsApp explica como lê-las pela API, como buscar a mídia enviada por um contato e como funciona o webhook whatsapp.received.
Custo e cobrança
O WhatsApp é cobrado por mensagem, com base na categoria do template e no país do destinatário; consulte preços do WhatsApp. Uma mensagem é cobrada em duas etapas, em dois momentos diferentes, e o objeto cost da mensagem informa ambas:
| Campo | O que é | Quando é registrado |
|---|---|---|
transaction_amount | Taxa da Bird pelo processamento do envio | Quando a Bird processa o envio aceito, antes do despacho |
passthrough_amount | Parcela da Meta no preço da mensagem, que a Bird repassa | Quando chega um recibo delivered ou read aplicável |
amount | A soma dos componentes precificados até o momento | Aumenta à medida que cada componente é registrado |
currency_code | A moeda da carteira da sua organização, comum aos dois componentes | Junto com o primeiro componente |
Os dois valores são strings decimais, sem impostos.
Observação: uma mensagem de serviço não tem parcela da Meta até 30 de setembro de 2026, e o mesmo vale para um template de utilidade entregue dentro de uma janela de atendimento ao cliente aberta. A partir de 1º de outubro de 2026, a Meta cobra pelos dois, exceto dentro de uma janela de ponto de entrada gratuito, e com 1.000 mensagens de serviço gratuitas por número de telefone comercial por mês: mudanças de preço de outubro de 2026.
Os dois componentes são precificados com base em dados diferentes. A tarifa da Bird usa a categoria do template enviado e o país do destinatário, obtido do código de país do número de telefone ou, em um envio endereçado a um ID de usuário com escopo de empresa, do prefixo de duas letras desse ID. A parcela da Meta usa a categoria que a própria Meta informa no recibo aplicável, que pode ser diferente da categoria do template: a Meta pode informar authentication-international quando suas regras de destino, localização da empresa e elegibilidade se aplicam. Consulte tarifas authentication-international do WhatsApp.
O que cost mostra depende de quanto a mensagem já avançou:
- No
202,costé nulo. Nada foi precificado ainda. - Após o processamento,
transaction_amounté preenchido eamountfica igual a ele.passthrough_amountcontinua nulo. - Após um recibo
deliveredoureadaplicável, uma cobrança da Meta registrada com sucesso preenchepassthrough_amount, eamountreflete os componentes registrados.
Um componente nulo significa que nenhum valor foi registrado nessa projeção; isso não prova que a mensagem foi gratuita. Um componente explicitamente precificado em zero mostra "0.00000".
As duas cobranças também falham de formas diferentes. A tarifa da Bird falha de forma fechada: quando não pode ser cobrada após o 202 porque a carteira não cobre o envio ou a rota não tem preço configurado, a mensagem termina como rejected com o código de erro insufficient_balance ou price_not_found, e nada é cobrado. Uma mensagem rejected nunca chegou ao WhatsApp, e é isso que a diferencia de failed. A parcela da Meta falha de forma aberta: se a carteira não tiver saldo suficiente ou a tarifa estiver ausente quando o recibo chegar, a cobrança é ignorada sem reverter o estado observado da mensagem. A segunda cobrança nunca atrasa a sua entrega.
Uma mensagem cobrada pela Bird mantém essa cobrança de saída se a entrega falhar depois. A tarifa da Meta é processada a partir de um callback delivered ou read aplicável quando a Meta informa preço regular com categoria e destino identificáveis. Os dois caminhos de callback usam a mesma identidade de tarifa e dependem da deduplicação do serviço de cobrança. Concilie recibos reenviados com os registros de cobrança, em vez de tratar a projeção da mensagem como um comprovante de débito permanente. Preços de serviço ou de entrada gratuita podem zerar o componente da Meta; um componente não resolvido não indica que a mensagem foi gratuita.
Use o razão de cobrança para a conciliação financeira. Os campos cost da mensagem são projeções das cobranças e podem atrasar ou ficar incompletos. Consulte métricas do WhatsApp para entender a diferença entre observações de mensagens e registros de cobrança.
Os eventos WhatsApp não informam custo. Para ver qualquer um dos componentes, leia a mensagem novamente com GET /v1/whatsapp/messages/{id}.
Próximos passos
- Mensagens de serviço: envie texto, mídia e conteúdo interativo dentro da janela de atendimento ao cliente
- Templates: escolha um template e informe as variáveis dele
- Recebimento de mensagens do WhatsApp: leia as respostas e baixe a mídia recebida
- Webhooks de status de mensagem: receba atualizações de entrega e de falha
- Idempotência: tente novamente com segurança usando o cabeçalho
Idempotency-Key
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.