WhatsAppApi
Adicione mensagens WhatsApp ao seu app.
Envie atualizações úteis, receba respostas de clientes e acompanhe cada mensagem ao longo do seu ciclo de vida. Use as APIs e SDKs publicados da Bird para conectar o WhatsApp às aplicações e fluxos com os quais seus clientes já contam.
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
},
});
console.log(msg.id, msg.status);Escolha seu SDK ou use HTTP diretamente. Esses exemplos são gerados a partir da operação publicada da Bird.
Uma solicitação clara
Escolha a mensagem certa para o momento.
Use um template aprovado para uma mensagem elegível iniciada pelo negócio, ou uma resposta de formato livre suportada dentro da janela de atendimento ao cliente. Mantenha remetente, destinatário, idioma e conteúdo explícitos.
Use os exemplos publicados
Comece pelo exemplo gerado de SDK ou HTTP acima. Siga o formato real de conteúdo e a validação da operação em vez de adivinhar um método a partir de uma ilustração de marketing.
Controle o ritmo da carga
Use a resposta de limitação de requisições e uma fila limitada. Quando uma aplicação distribui mensagens, mantenha um registro durável de cada destinatário pretendido e solicitação.
Um ciclo de vida compreensível
Acompanhe da aceitação até a resposta do cliente.
Uma solicitação aceita pela API inicia o processamento. Aceitação pela Meta, entrega e atualizações de leitura descrevem estágios posteriores; elas não garantem que o cliente concluiu sua tarefa de negócio.
Reconcilie com leituras de mensagens
Consuma os webhooks relevantes e consulte registros de mensagens ao investigar uma lacuna. Mantenha tentativas incertas separadas de falhas confirmadas.
Mantenha as decisões de retry precisas
Use as proteções de solicitação documentadas e a classificação de erros. Não presuma que uma tentativa incerta do provedor pode ser repetida indefinidamente com segurança.
Bird admite a solicitação e retorna a identidade da mensagem.
A mensagem passa pelo fluxo de envio.
Observações do provedor atualizam o registro da mensagem quando disponíveis.
Trate rejeição, falha e observações ausentes como parte da mesma integração.
Uma conversa, não apenas um endpoint
Leve o contexto útil para a resposta.
Use identificadores explícitos de botão ou lista de resposta e o estado de conversa da sua aplicação. Uma resposta pode citar uma mensagem anterior, mas essa referência é opcional e pode não estar disponível.
Mantenha os metadados no lugar certo
Metadados de saída pertencem ao registro de saída. Não presuma que eles são copiados na mensagem de entrada do cliente.
Conecte ferramentas com as mesmas permissões
CLI e MCP podem ajudar desenvolvedores a operar o canal. Eles continuam sujeitos ao mesmo acesso do espaço de trabalho, propriedade do remetente e regras de envio.
Perguntas sobre a WhatsApp API
Uma solicitação aceita significa que a mensagem foi entregue?
Posso enviar mensagens de formato livre a qualquer momento?
Existe um endpoint de lote na WhatsApp?
Como associo uma resposta interativa à minha aplicação?
Conecte a jornada completa
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Faça da primeira solicitação parte de uma integração funcional.
Configure seu espaço de trabalho, use um exemplo publicado e inspecione a resposta. Conecte respostas e eventos de entrega antes de expandir o tráfego.