Referência de Coexistência

O que é

O modo oficial da Meta para executar a aplicação WhatsApp Business e a Cloud API simultaneamente num único número de telefone. Não é uma API diferente: é a mesma Cloud API, integrada para que a aplicação continue a funcionar nesse número depois.

Porque é que as equipas a utilizam

Quatro razões explicam quase todas as ligações.

• Manter o número já impresso em viaturas, recibos e num site.
• Adicionar envio pela API, webhooks e templates sem transferir ninguém para uma ferramenta nova.
• Manter as conversas fora da caixa de entrada partilhada de um fornecedor.
• Permitir que uma agência mantenha muitos números de clientes, cada um no portefólio empresarial do próprio cliente.

Como funciona a comunicação

Ambas as superfícies veem a mesma conversa. O que a API envia aparece na aplicação. O que a equipa escreve na aplicação chega ao software como um evento smb_message_echoes, impedindo que a automação responda por cima de uma pessoa.

Comportamento da faturação

A Meta cobra as conversas, não as mensagens, e fatura-as através do método de pagamento da sua própria WhatsApp Business Account. As respostas dentro da janela de atendimento ao cliente de 24 horas são gratuitas. Abrir uma conversa fora dessa janela exige um template e é cobrado.

Dispositivos ligados

A Coexistência não é um dispositivo ligado e não utiliza um. Um dispositivo ligado é o cliente de consumo com sessão iniciada noutro local, que é aquilo que as ferramentas não oficiais automatizam e que os termos do WhatsApp proíbem. Nada nesta solução utiliza esse mecanismo.

Limitações funcionais

Definidas pela Meta e idênticas em todos os fornecedores.

• As conversas de grupo não estão disponíveis através da API.
• Os templates não podem ser enviados a partir da aplicação no telemóvel, apenas através da API.
• O throughput de envio é fixo, em vez de aumentar com a qualidade e o nível.
• A partilha do histórico de conversas é decidida uma vez, durante a integração.

Elegibilidade

O número tem de cumprir todos estes requisitos antes de poder ser ligado.

• Já estar ativo na aplicação WhatsApp Business, e não na aplicação de consumo.
• Estar num Portefólio empresarial a que possa aceder.
• Não estar já ligado à aplicação de outro fornecedor.

Notas operacionais

Aspetos verdadeiros depois da ligação e fáceis de ignorar.

• A aplicação tem de ser aberta periodicamente ou a Meta desliga o lado da API.
• Uma desligação remove a substituição do webhook juntamente com a aplicação.
• A classificação de qualidade é consultada, não enviada, por isso nada anuncia uma descida.
• Um token revogado parece idêntico a um número removido sem uma segunda credencial.

Ressalva sobre a seleção da conta

Durante o Embedded Signup, o Portefólio empresarial e a WhatsApp Business Account são escolhidos em passos separados. Escolher a conta errada associa o número a um local não pretendido, e movê-lo depois exige desligá-lo e executar novamente todo o processo.

Decisões irreversíveis

A partilha do histórico de conversas existente é solicitada uma vez e não pode ser repetida. A sincronização também tem de começar nas 24 horas seguintes à integração e só pode ser executada uma vez. Se forem ignoradas, ambas produzem erros pouco claros em vez de avisos.

Desligar ou reverter

Um número pode ser desligado a qualquer momento, a partir do painel ou através do conector. A aplicação WhatsApp Business continua exatamente como antes, com as conversas e o histórico intactos, e a ligação não altera permanentemente nada no próprio número.

Erros comuns

• Tratar a Coexistência como uma API diferente. É a Cloud API com uma integração diferente.
• Criar uma solução à volta das conversas de grupo. Estão excluídas em todos os fornecedores.
• Assumir que uma nova ligação restaura o destino do webhook. Não restaura.

Perguntas frequentes

Continue a ler