Chamadas do WhatsApp Business num número Coexistence
Num número Coexistence, as chamadas de voz e vídeo continuam a funcionar na app WhatsApp Business como antes: um cliente liga, o telemóvel toca e a equipa atende. O que não está disponível é a Calling API da Meta, que exige um número em utilização com a Cloud API e não com a app WhatsApp Business. Software, automatizações e agentes de IA trabalham com as mensagens desse número, não com as suas chamadas.
A easyCoexistence liga o número através da Coexistence, por isso as chamadas continuam a tocar no telemóvel, enquanto a sua IA e as automatizações tratam das mensagens escritas no mesmo número, através da API oficial da Meta.
Tabela de funcionalidades Coexistence da Meta para chamadas de voz e vídeo no lado da Cloud API; no lado da app não há alterações.
Mínimo diário de mensagens, em destinatários únicos, que uma empresa precisa de ter antes de usar a Calling API.
As chamadas iniciadas pela empresa não estão disponíveis para números de empresa nos Estados Unidos, Canadá, Egipto, Vietname e Nigéria.
O campo webhook que uma aplicação subscreve para eventos da Calling API, salvo se usar SIP.
Os clientes ainda podem ligar para um número Coexistence?
Sim. A documentação Coexistence da Meta inclui uma tabela com o que muda num número quando é partilhado com a Cloud API, e para chamadas de voz e vídeo a coluna da app indica "Sem alteração". O cliente toca no botão de chamada no chat, a app WhatsApp Business toca no telemóvel e quem o tiver atende, exatamente como antes da integração.
Uma chamada não passa para a API. As chamadas não são espelhadas para o software como as mensagens, nenhum webhook de mensagens as reporta, e o histórico de chamadas é um dos elementos que ficam na app. Para a equipa ao telefone nada muda; para os sistemas ligados ao número, as chamadas simplesmente ficam fora do que veem.
Porque é que a Calling API não pode ser usada nele?
Porque a Meta criou a Calling API para números que vivem apenas na Cloud API. A mesma tabela Coexistence marca as chamadas de voz e vídeo como "Não suportado" do lado da Cloud API, e os pré-requisitos da própria Calling API começam pelo número.
- O número da empresa está em utilização com a Cloud API, e não com a app WhatsApp Business.
- A app subscreve o campo webhook de chamadas, salvo se usar SIP.
- A app tem a permissão
whatsapp_business_messagingpara o número. - A empresa tem um limite diário de mensagens de pelo menos 2 000 destinatários únicos.
- As funcionalidades de chamada estão ativadas no número de telefone da empresa.
O que significa isto para automatizações e agentes de IA?
Funcionam com mensagens. Uma automatização corre quando chega uma mensagem, e uma chamada telefónica não é uma mensagem, por isso não inicia nenhuma execução, não aciona nenhuma resposta de IA e não chega a nenhum webhook. Um agente de IA ligado ao número não consegue atender, fazer nem transferir uma chamada.
A opção prática é fazer das chamadas parte do que a sua IA sabe. Coloque nas instruções uma linha como: "Se o cliente pedir para falar por telefone, diga que uma pessoa lhe ligará de volta a partir deste número durante o horário de atendimento e pergunte qual o melhor horário." A equipa retorna então a chamada a partir da app WhatsApp Business. Os clientes que preferirem falar continuam a ter uma pessoa, e a IA trata de tudo o que pode ser feito por escrito.
E se precisar de chamadas através da API?
Então as chamadas têm de acontecer num número que não é partilhado com a app. Existem duas vias. Registe um segundo número apenas na Cloud API e ative lá as chamadas, mantendo o número Coexistence para mensagens e chamadas na app. Ou mova este número da app WhatsApp Business para apenas a Cloud API, o que implica abdicar para sempre da app telefónica nesse número.
Verifique primeiro as condições. A Calling API exige o limite de 2 000 mensagens, e a Meta não oferece chamadas iniciadas pela empresa a partir de números de empresa nos Estados Unidos, Canadá, Egipto, Vietname e Nigéria. As chamadas iniciadas pelo utilizador estão disponíveis em todos os locais onde existe a Cloud API.
Como é que as chamadas aparecem na monitorização?
Num número Coexistence, na maioria dos casos não aparecem, e isso é esperado. Os sinais de chamada da Meta pertencem a números que usam a Calling API: o campo webhook de chamadas, um campo can_receive_call_sip no estado de saúde, e tipos de restrição de chamadas em account_update, como RESTRICTED_USER_INITIATED_CALLING.
A monitorização de um número Coexistence acompanha o lado das mensagens: se a ligação está ativa, a classificação de qualidade e se a Meta entrega as mensagens iniciadas pela empresa. Uma chamada perdida só é visível na app do telemóvel, por isso uma equipa que dependa de chamadas deve continuar a acompanhar o registo de chamadas aí, tal como fazia antes da ligação.
Erros comuns
- Planear um agente de voz de IA num número Coexistence. A Calling API não suporta números partilhados com a app WhatsApp Business.
- Esperar que uma chamada perdida acione uma automatização. As automatizações correm com mensagens recebidas, e as chamadas nunca chegam à API.
- Mudar o número principal para apenas API só para ter chamadas. A app deixa de existir nesse número; um segundo número mantém ambas.
A monitorização cobre a ligação, a qualidade e a saúde de envio do número. A partir de US$ 9 por número ligado por mês, descendo até US$ 0,75 à medida que adiciona números, com os primeiros 3 dias grátis.
Perguntas frequentes
As chamadas continuam a funcionar no WhatsApp Web depois da Coexistence?
A tabela da Meta indica que as chamadas não mudam do lado da app. Os dispositivos associados são desassociados durante a integração e os suportados podem voltar a ser associados, à exceção do WhatsApp para Windows e WearOS.
A sua IA consegue ver quem ligou?
Não. O histórico de chamadas fica na app WhatsApp Business e não é partilhado com a API, por isso nem as ferramentas nem as automatizações o recebem.
A Meta vai adicionar chamadas aos números Coexistence?
A Meta ainda não anunciou. Hoje a sua tabela Coexistence marca as chamadas como não suportadas do lado da Cloud API, por isso planeie em função disso.
O histórico de chamadas faz parte da sincronização do histórico?
Não. A sincronização de contactos e do histórico feita na integração abrange contactos e mensagens individuais; o histórico de chamadas de voz e vídeo fica na app WhatsApp Business.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em