Como usar o relatório da API do WhatsApp para habilitar um fallback de SMS ou VoIP
·
Principais Conclusões
O Flow Builder automatiza o rastreamento de entrega. Você pode detectar quando as mensagens do WhatsApp falham e acionar ações de fallback instantâneas como SMS ou Voz.
Os fallbacks garantem a entrega da mensagem. Os canais de SMS e Voz compensam as mensagens do WhatsApp não entregues devido a números inválidos, desinstalações de aplicativos ou problemas de conectividade.
Insights em tempo real através do Google Sheets. Registre automaticamente o status de entrega (enviado, entregue, lido, rejeitado) para visualizar o desempenho e identificar números problemáticos.
Relatório de Heatmap do WhatsApp. Monitore o desempenho da campanha no Flow Builder para entender o engajamento, otimizar as taxas de entrega e ajustar fluxos.
Configuração de integração simples. É necessário ter uma conta Bird, um número local e uma conta do Google para conectar a lógica de mensagens e os painéis de relatórios.
Otimização orientada por dados. Use os registros de rejeição para criar listas de contatos refinadas, reduzir o desperdício de mensagens e fortalecer a eficiência da comunicação multicanal.
Automação baseada em tempo. A sincronização de timestamps opcional garante rastreamento preciso em fusos horários globais para campanhas em escala empresarial.
Destaques de Perguntas e Respostas
O que faz a API de relatórios do WhatsApp?
Ele rastreia os status de entrega de mensagens - enviado, entregue, lido ou rejeitado - para que você possa monitorar o desempenho da campanha e tomar medidas em entregas falhadas.
Por que usar SMS ou Voz como alternativa?
Os fallback garantem que sua mensagem ainda chegue aos clientes se a entrega do WhatsApp falhar devido a números inválidos, falta de conectividade ou a desinstalação do aplicativo.
Como faço para configurar relatórios com o Flow Builder?
Conecte seu fluxo do WhatsApp a uma Planilha do Google através do Flow Builder. Cada status de mensagem (enviada, entregue, rejeitada) é registrado em tempo real para fácil análise.
Quais são os motivos mais comuns pelos quais as mensagens do WhatsApp falham?
Números de telefone inválidos, sinal de rede fraco ou usuários que não têm o WhatsApp instalado são as principais causas.
Como funciona o processo de fallback?
Quando uma mensagem é rejeitada, o Flow Builder aciona automaticamente um canal secundário—SMS ou Voz—para entregar a mensagem sem intervenção manual.
Posso visualizar o desempenho da campanha?
Sim. O Heatmap do Flow Builder permite que você veja quais mensagens foram entregues, lidas ou rejeitadas, ajudando a otimizar sua estratégia de divulgação.
Quais são os pré-requisitos antes da configuração?
Você precisa de uma conta Bird, de um número local de SMS ou de voz, e de uma conta do Google conectada ao painel.
Posso rastrear os tempos de entrega por região?
Sim. Você pode usar uma etapa de "Buscar Variáveis" para chamar a API do TimeZoneDB e registrar carimbos de data/hora de acordo com o fuso horário local do cliente.
Qual é o benefício empresarial de ativar os planos de contingência?
Você maximiza o alcance, reduz interações perdidas e melhora a satisfação do cliente garantindo que cada mensagem—transacional ou promocional—seja entregue.
Onde posso aprender mais?
Explore a documentação da API do WhatsApp e da API de Conversas da Bird para templates, configuração de campanhas e melhores práticas de versionamento.
Com o Flow Builder do Bird, você pode saber automaticamente se uma mensagem do WhatsApp foi entregue e usar SMS ou Voz como uma opção de fallback para garantir que você alcance seu cliente.
À medida que mais e mais empresas interagem com seus clientes pelo WhatsApp, pode ser demorado e caro entender quais usuários têm contas no WhatsApp e quais não têm.
Para essas empresas, entender quais usuários não estão recebendo suas mensagens da API do WhatsApp pode ajudar você a otimizar os resultados de suas mensagens em massa, aumentar conversões e engajamento, e garantir a conexão com opções de fallback.
Com os Fluxos do Bird, você pode compreender automaticamente se uma mensagem do WhatsApp foi entregue, e usar SMS ou Voz como opções de fallback para garantir que você alcance seu cliente. Aprenda como obter mais dados de cada mensagem de SMS para otimizar suas campanhas. Neste post do blog, você aprenderá como:
Configurar sua lógica de fluxo com os Fluxos
Ver os resultados da sua campanha de mensagens da API do WhatsApp com o Mapa de Calor do Fluxo
Construir uma lista de números de telefone do WhatsApp que foram rejeitados
Este guia ajudará se suas mensagens de modelo do WhatsApp já estiverem aprovadas e você já estiver enviando mensagens em massa com o Construtor de Fluxo. Se você estiver tendo problemas para obter a aprovação de suas mensagens de modelo ou ainda não conseguir enviar sua primeira mensagem do WhatsApp, certifique-se de ler nosso guia de Melhores Práticas para Mensagens do WhatsApp.
Requisitos
Antes de começar a construir a lógica e o fluxo dentro do Flow Builder, você precisa ter os seguintes requisitos prontos:
Com isso, você pode seguir estes passos para ver os resultados da sua campanha de transmissão e construir alternativas de SMS/Voz para ajudar a garantir a entregabilidade usando o Flow Builder.
Passo 1: Crie um novo fluxo no Flow Builder com um Webhook do WhatsApp
Para o primeiro passo, comece um novo fluxo usando este modelo:
1. Faça login no seu Painel do Bird e vá para Fluxos.
2. Faça o download do fluxo de amostra que você usará.
3. Importe o fluxo com a função de importação. E publique o fluxo.
4. O fluxo ficará parecido com a imagem abaixo. Então, clique no botão Publicar e copie a URL do Webhook gerada.
5. Navegue até e abra seu Fluxo da Campanha de Transmissão do WhatsApp. Clique na etapa Enviar mensagem do modelo WhatsApp, role até o final e ative o botão de relatório de status. Insira a URL do Webhook copiada no campo disponível, como visto na captura de tela abaixo. Não se esqueça de Publicar novamente.
Passo 2: Registre os detalhes das mensagens do WhatsApp em uma nova Planilha Google
Nesta etapa, você aprenderá como conectar seu fluxo ao Google Sheets para que possa acompanhar a entrega e o status da mensagem. Em seguida, use esse insight para otimizar a entrega via WhatsApp e criar lógica de fallback para garantir que você atinja seu cliente.
1. Crie uma nova planilha do Google com o seguinte nome (“Relatório de Campanha do WhatsApp”) e colunas:
Hora: Isso mostrará o horário em que sua mensagem foi rejeitada
Mensagem_De: Quem é o remetente da mensagem
Mensagem_Para: Quem é o destinatário da mensagem
Status: Qual é o status atual da mensagem
Descrição: Qual é o motivo da rejeição da mensagem
2. Integre sua conta do Google com o painel Bird para que você possa conectar a planilha que acabou de criar com seu fluxo
3. Conecte suas colunas do “Relatório de Campanha do WhatsApp” com cada coluna do seu novo fluxo dentro do Flow Builder
Parte 3: Criar lógica de fallback para SMS / Voz
Nesta etapa, você poderá adicionar canais de fallback (SMS ou Voz) à sua lógica de fluxo se uma mensagem do WhatsApp for rejeitada.
Essas são algumas das razões mais comuns pelas quais as mensagens são rejeitadas nesta fase:
O número de telefone de seus clientes é inválido
Eles não têm sinal no momento em que as mensagens foram enviadas
Não usam o WhatsApp ou não o têm instalado em seu telefone celular
Uma vez que você abra o fluxo em Flows, verá quatro ramos diferentes (veja a imagem abaixo). Esses ramos estão alinhados com os status de mensagem da API do WhatsApp:
Canal | Significado do status | Ação recomendada |
|---|---|---|
Enviado | Mensagem chegou aos servidores do WhatsApp | Monitorar / aguardar o próximo estado de entrega |
Entregue | Mensagem entregue ao destinatário | Caminho de sucesso — continue a jornada normal |
Lido | O usuário abriu a mensagem | Considere uma mensagem de acompanhamento ou de CTA |
Rejeitado | Falha na entrega (número inválido, offline, não é usuário do WhatsApp) | Acionar fallback: SMS ou Voz |
Nesta etapa, você adicionará seu canal de fallback ao ramo rejeitado. O ramo rejeitado capturará todos os seus clientes que não receberam sua mensagem do WhatsApp com sucesso. Isso faz parte de uma estratégia mais ampla para desviar consultas para canais de menor custo.
1. Adicione a ação “Enviar SMS” ou “Chamada de Saída” como um passo no ramo rejeitado. Este ramo será usado como a rota de fallback uma vez que as mensagens forem rejeitadas pela API do WhatsApp Business. O SMS também é eficaz para coletar feedback dos clientes por meio de formulários. Por exemplo, se uma mensagem não for entregue com sucesso, o Flow Builder enviará uma mensagem de SMS ou voz.
2. Use o Flow Heatmap para monitorar o fluxo e ver os resultados da sua campanha da API do WhatsApp. Você poderá ver quantas mensagens foram enviadas, entregues, rejeitadas e muito mais.
Use nosso Heatmap para entender os resultados e a entregabilidade das suas campanhas de transmissão da API do WhatsApp. Para obter insights mais amplos sobre a campanha, aprenda como usar o Competitive Tracker da Bird para comparar seu desempenho.
Parte 4: Adicione um carimbo de data/hora ao seu fluxo (opcional)
A variável de carimbo de data/hora padrão nas Flows é baseada no fuso horário UTC. Você pode usar um passo “Buscar variáveis” dentro do Flow Builder para fazer uma solicitação GET para http://api.timezonedb.com e sincronizar automaticamente com o fuso horário do cliente. As variáveis de saída devem ser formatadas. Por favor, registre-se e obtenha sua própria chave de API gratuita.
Dica: Certifique-se de monitorar o tratamento de falhas do fluxo para garantir que seu fluxo continue mesmo que a solicitação falhe.
Esses são os passos simples que você precisa seguir para começar a usar SMS ou Voz como uma alternativa quando suas mensagens do WhatsApp não forem entregues com sucesso.
Conclusão
Seu fluxo agora é capaz de criar um Mapa de Calor e mostrar os resultados de suas campanhas de divulgação pelo WhatsApp. Agora você sabe como usar Fluxos para personalizar a experiência do seu cliente. Para continuar construindo projetos e interagir com seus clientes através de uma única API, consulte nossa API do WhatsApp e a documentação da API de Conversas. Quando trabalhar com APIs, siga as melhores práticas de versionamento de API para integrações sustentáveis.
