Envie atualizações, códigos de verificação e respostas interativas de WhatsApp a partir de uma única API.
Entregue confirmações de pedido, códigos de verificação de uso único, mídia avançada e botões interativos ou menus de lista diretamente nos chats de WhatsApp dos seus clientes. A Bird valida os parâmetros dos templates e verifica a janela de atendimento ao cliente de 24 horas antes do envio, evitando chamadas com falha e cobranças inesperadas, enquanto transmite as confirmações de entrega e de leitura de volta para o seu app.
// Install the SDK
// npm install @messagebird/sdk
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);Envie sua primeira mensagem em minutos com nossos SDKs para TypeScript, Python, Go ou PHP, a CLI da Bird ou solicitações HTTP diretas. Comece imediatamente com os templates pré-aprovados da Bird enquanto seu próprio número do WhatsApp Business é verificado.
Templates e janela de 24 horas
Envie o formato certo dentro ou fora da janela de 24 horas.
O WhatsApp separa os contatos iniciados pela empresa das conversas ativas com clientes. Alcance clientes fora de um chat ativo com templates de utilidade, autenticação ou marketing aprovados pela Meta e, depois, passe a usar texto livre, mídia e menus interativos por 24 horas após o cliente enviar uma mensagem ou ligar para você.
Detecte janelas fechadas e variáveis incompatíveis antes do envio
A Bird acompanha a janela de atendimento ao cliente de 24 horas por destinatário e por número da empresa. Se o seu app tentar enviar uma mensagem de texto livre depois que a janela fechar, ou passar variáveis de template que não correspondem aos seus placeholders, a API rejeita a chamada antes que algo seja criado ou cobrado.
Mídia avançada, botões interativos e menus de lista
Com uma conversa aberta, envie imagens, PDFs, áudios, vídeos, localizações ou cartões de contato a partir de um único endpoint. Adicione botões de resposta rápida, menus de lista com várias opções, carrosséis de produtos ou solicitações de localização e contato para que os clientes toquem em vez de digitar.
Rastreamento de entrega em tempo real
Acompanhe as mensagens desde a aceitação pela API até a confirmação de leitura.
O envio no WhatsApp é assíncrono. Depois que a Bird aceita sua solicitação, os eventos de webhook e a linha do tempo de cada mensagem mostram quando ela é repassada ao WhatsApp, entregue no celular do cliente e aberta no chat.
Diagnostique rejeições com os detalhes de erro da Meta
Se uma mensagem falhar após a aceitação, por exemplo quando a janela de atendimento expira durante o envio ou a Meta bloqueia a entrega, a Bird registra a descrição da falha e o código de erro original da Meta no registro da mensagem, para que sua equipe saiba se deve tentar novamente ou trocar de canal.
Evite envios duplicados em novas tentativas de rede
Inclua uma chave de idempotência na sua solicitação de envio para que, em caso de timeout ou nova tentativa de um worker dentro do período de retenção, a resposta original seja reproduzida em vez de uma mensagem duplicada ser enviada.
order_ready
Eventos
Aceito
A Bird aceita a solicitação e retorna a identidade da mensagem.
Enviado
A mensagem avança pelo fluxo de envio.
Entregue
As observações do provedor atualizam o registro da mensagem quando disponíveis.
Leitura
Trate rejeições, falhas e observações ausentes como parte da mesma integração.
Harbor
Conta comercial
order_ready
Harbor
Conta comercial
Eventos
Aceito
A Bird aceita a solicitação e retorna a identidade da mensagem.
Enviado
A mensagem avança pelo fluxo de envio.
Entregue
As observações do provedor atualizam o registro da mensagem quando disponíveis.
Leitura
Trate rejeições, falhas e observações ausentes como parte da mesma integração.
Contexto para fluxos bidirecionais
Mantenha as respostas dos clientes vinculadas ao pedido ou ticket certo.
Cite uma mensagem anterior para que o cliente veja, no próprio chat, qual pergunta ou pedido você está respondendo. Quando um cliente toca em um botão de resposta rápida, escolhe uma opção de lista ou responde a uma mensagem recente, a Bird retorna a ação selecionada e a referência da mensagem citada para que seu app encaminhe a resposta imediatamente.
Adicione tags e metadados aos envios
Adicione até 20 tags filtráveis e 2 KB de metadados JSON personalizados a uma mensagem enviada. Segmente os logs de mensagens por campanha ou fluxo e mantenha os IDs internos de pedidos ou tickets vinculados ao registro de envio nas leituras da API e nos webhooks de entrega.
Opere a partir do seu código, terminal ou agente de IA
Envie mensagens de teste, inspecione linhas do tempo de entrega e filtre o histórico recente pela CLI da Bird ou conecte seu assistente de programação pelo servidor MCP da Bird, controlado pelas permissões de função e de remetente do seu espaço de trabalho.
Perguntas sobre envio no WhatsApp
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
Escale sem
perder o controle.
Organize equipes em espaços de trabalho, controle o acesso à API e rastreie alterações nos logs de auditoria.
Organização
Harbor
O acesso permanece no espaço de trabalho.
Produção/Chaves de API
Agente de entrega
AtivoAlex Lee
Admin
Hoje · UTC
Log de auditoria
Organização
Harbor
O acesso permanece no espaço de trabalho.
Produção/Chaves de API
Agente de entrega
AtivoAlex Lee
Admin
Hoje · UTC
Log de auditoria
Organização
Harbor
O acesso permanece no espaço de trabalho.
Produção/Chaves de API
Agente de entrega
AtivoAlex Lee
Admin
Hoje · UTC
Log de auditoria