# EasyCoexistence: Português (Portugal) (pt-pt)

EasyCoexistence is an independent Meta Tech Provider. It is not a Meta product and is not affiliated with or endorsed by Meta.

Product documentation (English): https://easycoexistence.com/llms-full.txt

## Servidor MCP do WhatsApp para Claude, ChatGPT e Cursor

https://easycoexistence.com/pt-pt/whatsapp-mcp-server

Um servidor MCP permite que um assistente de IA use o WhatsApp diretamente: lista os seus números, envia mensagens e templates, verifica o estado da ligação e aponta o webhook para o seu sistema. A EasyCoexistence executa um na Cloud API oficial da Meta, para que o número para o qual os seus clientes já enviam mensagens continue oficial e nunca fique em risco.

### O que é um servidor MCP do WhatsApp?

MCP, o Model Context Protocol, é a forma de um assistente de IA aceder a uma ferramenta que não possui. Adiciona um conector uma vez e, depois, o assistente pode chamar essa ferramenta em seu nome, em linguagem simples, sem código de ligação intermédio.

Um servidor MCP do WhatsApp expõe um número WhatsApp como uma dessas ferramentas. Em vez de escrever um script que autentica numa API, cria um payload e trata da resposta, pede: envie uma mensagem a este cliente, crie um template para atualizações de encomendas, diga-me se este número está saudável. O assistente faz as chamadas.

O que importa é a que WhatsApp acede. Há duas coisas completamente diferentes com o mesmo nome, e essa diferença determina se o número de um cliente sobrevive.

### Porque é que a maioria dos servidores MCP do WhatsApp faz bloquear números?

Quase todos os servidores MCP do WhatsApp que pode instalar atualmente funcionam através do WhatsApp Web. Iniciam sessão como um dispositivo ligado, tal como o cliente do navegador, e automatizam essa sessão.

Isso viola os termos do WhatsApp, que proíbem a utilização automatizada e em massa do cliente de consumo, e um dispositivo ligado é precisamente o cliente de consumo. Um número que faça isto pode ser bloqueado, e uma promessa de evitar bloqueios descreve algo que o fornecedor não controla.

Para um número pessoal, isso é um incómodo. Para o número para o qual os clientes de uma empresa já enviam mensagens, é o próprio negócio.

O conector da EasyCoexistence não funciona assim. Chama a Cloud API oficial da Meta, num número integrado através da funcionalidade Coexistência da própria Meta. Não há dispositivo ligado nem sessão a perder.

### O que pode realmente fazer com isto?

Dezasseis ferramentas, correspondentes às tarefas que alguém realmente pede.

Leitura: listar os números da sua conta, verificar o estado de um número, incluindo a sua classificação de qualidade, o nível de mensagens e o estado da ligação, e ler as credenciais da API quando forem necessárias noutro local.

Envio: enviar uma mensagem dentro da sessão de 24 horas; listar os templates do número, criar um novo, verificar se a Meta o aprovou e enviar um template aprovado para abrir uma conversa fora desse período.

Ligação: definir o destino do webhook, para que as mensagens recebidas sejam encaminhadas da Meta diretamente para o seu próprio servidor. E iniciar uma ligação, que devolve o link que um cliente abre para associar o seu número. Existe também uma ferramenta de documentação, para que o assistente possa consultar como algo funciona em vez de adivinhar.

É este último par que o torna mais do que um brinquedo de conversação. Um agente pode integrar um número e apontá-lo para o seu sistema sem que uma pessoa tenha de abrir um painel.

Partner API: mais cinco ferramentas configuram links de ligação alojados, para quando o seu próprio software permite que os clientes dele liguem os seus números. Consultam o estado da configuração, criam ou revogam a chave de API, definem o URL que recebe os eventos de estado e criam um link de ligação para um cliente.

### A empresa continua a usar a aplicação no telemóvel?

Sim, e essa é precisamente a razão pela qual isto funciona num número de que uma empresa já depende.

A Coexistência é o modo oficial da Meta para executar a aplicação WhatsApp Business e a Cloud API no mesmo número ao mesmo tempo. A equipa continua a responder a partir do telemóvel exatamente como antes, com as mesmas conversas, o mesmo histórico e o mesmo dispositivo, enquanto a API envia e recebe nessa mesma linha. O que a API envia aparece na aplicação, e o que a equipa escreve na aplicação fica visível para a API.

Assim, o agente não substitui ninguém. Responde quando pode, e uma pessoa retoma a mesma conversa no telemóvel quando quiser. Nenhum dos lados precisa de saber do outro.

1. Connect the number: Sign up, then run Meta's Embedded Signup and scan the code from the WhatsApp Business app. About two minutes, and nothing about the app changes.
2. Add the connector: In Claude, ChatGPT, Cursor or Claude Code, add a custom connector pointing at https://easycoexistence.com/api/mcp and sign in. OAuth, so no key is pasted anywhere.
3. Ask for something: "Which of my numbers is unhealthy?" or "Send Sarah the booking confirmation." The assistant picks the tool and makes the call.

- Enviar fora da sessão de 24 horas com texto simples. Fora desse período, só passa um template aprovado, por isso um agente que conheça apenas send_message fica sem responder à hora 25.
- Esperar conversas de grupo. Os números de Coexistência estão excluídos da API de grupos, em todos os fornecedores.
- Apontar o webhook para um URL que não consiga responder ao handshake GET da Meta. A Meta verifica o endpoint antes de entregar qualquer coisa, e um 404 silencioso parece exatamente uma configuração funcional até à primeira mensagem nunca chegar.

**O número do meu cliente pode ser bloqueado por causa disto?** Não. Esta é a Cloud API oficial da Meta, acedida através da funcionalidade Coexistência da própria Meta. O risco de bloqueio vem dos gateways não oficiais que iniciam sessão como um dispositivo ligado, um mecanismo completamente diferente.

**Com que assistentes funciona o conector?** Qualquer um que fale MCP por HTTP com OAuth: Claude, ChatGPT, Cursor, Claude Code e Codex atualmente. É um endpoint remoto único, por isso nada é executado na sua máquina.

**As minhas conversas passam pelos vossos servidores?** Não. As mensagens recebidas são encaminhadas da Meta diretamente para o webhook que indicar, e nunca armazenamos o conteúdo das conversas. Mantemos apenas o estado da conta e do número de telefone necessário para monitorizar a ligação.

**Posso usar um conector para vários clientes?** Sim. Uma conta pode conter tantos números quantos forem necessários, cada um faturado como uma ligação própria, e o conector lista-os todos. Não há qualquer restrição à utilização para empresas que presta serviço.

---

## Coexistência WhatsApp: a app e a API no mesmo número

https://easycoexistence.com/pt-pt/whatsapp-coexistence

A Coexistência é o modo oficial da Meta para usar a app WhatsApp Business e a Cloud API no mesmo número em simultâneo. A equipa continua a responder pelo telemóvel, com as mesmas conversas e o mesmo histórico, enquanto o software envia e recebe na mesma linha. Nada é migrado e nenhum número muda.

### Que problema resolve realmente a Coexistência?

Antes de existir, colocar um número empresarial na API do WhatsApp significava deixar de usar a app. O número era migrado, o telemóvel deixava de funcionar como cliente WhatsApp e quem tinha respondido aos clientes durante todo o dia passava, de repente, a fazê-lo através do software escolhido. A maioria das equipas pequenas não aceitava essa troca, por isso nunca automatizava nada.

A Coexistência elimina essa escolha. A app continua a funcionar exatamente como antes. A mesma pessoa responde pelo mesmo telemóvel, vê as mesmas conversas e não precisa de aprender nada. Entretanto, a API fica ligada ao mesmo número e pode enviar, receber e integrar-se com outros sistemas.

Assim, a questão deixa de ser abdicar ou não do telemóvel. Passa a ser decidir o que quer que o software trate, enquanto uma pessoa retoma a mesma conversa sempre que quiser.

### O que muda no telemóvel depois de ligar o número?

Quase nada, e esse é o objetivo. A app abre da mesma forma, a lista de contactos é a mesma e as conversas antigas continuam todas disponíveis. Ninguém tem de iniciar sessão num novo lugar.

O que muda é invisível no telemóvel. As mensagens enviadas pela API aparecem na conversa da app, por isso quem responde vê o contexto completo, em vez de apenas uma parte. As mensagens escritas na app ficam visíveis para a API, para que o software não responda por cima de alguém que já respondeu.

A Meta sincroniza aproximadamente seis meses de histórico quando um número é ligado pela primeira vez, o que significa que a API não começa às cegas. Há dois limites que convém conhecer desde o início: as conversas de grupo ficam excluídas da API nos números em Coexistência, em todos os fornecedores, e o número não pode estar na app de consumo do WhatsApp, apenas na app WhatsApp Business.

### Para quem é a Coexistência?

Para dois grupos, que procuram coisas opostas.

Uma empresa com um número e uma equipa pequena quer que o telemóvel continue a funcionar enquanto algo automatiza a parte repetitiva: confirmações, lembretes e a primeira resposta fora do horário de funcionamento. Não está a comprar software para substituir ninguém. Está a recuperar as noites.

Uma agência, consultora ou pessoa programadora procura a perspetiva oposta. Presta serviço a muitas empresas, cada uma com um número que não pode alterar nem migrar, e precisa de tornar esses números acessíveis aos sistemas que cria. A Coexistência é a única forma oficial de colocar uma API num número ao qual a equipa do cliente continua a responder manualmente.

Por baixo, ambas precisam da mesma coisa: a ligação tem de se manter ativa e alguém tem de reparar quando isso deixa de acontecer.

### Porque precisa uma ligação de Coexistência de ser monitorizada?

Porque pode deixar de funcionar sem ninguém ser avisado.

Um número tem uma classificação de qualidade e um nível de mensagens que a Meta ajusta com base na reação dos destinatários. As classificações descem. Os níveis mudam. Os tokens de acesso expiram. Um destino de webhook que deixa de responder não é simplesmente repetido para sempre. Nada disto gera um alerta no telemóvel e a app continua a funcionar normalmente, por isso o primeiro sinal costuma ser um cliente dizer que nunca recebeu a mensagem.

A Meta também aplica uma regra segundo a qual uma ligação sem atividade da API durante catorze dias precisa de atenção. Nada disso está oculto ou é injusto, mas é fácil deixar passar.

É isto que a EasyCoexistence monitoriza. A ligação é verificada continuamente e, se algo mudar, é de nós que recebe o aviso, não de um cliente.

1. Sign up: Create an account and add a card. The first 3 days are free, and nothing is charged until they end.
2. Run Embedded Signup: Meta's own flow opens, you pick the number, and you scan a code from the WhatsApp Business app. About two minutes.
3. Point it somewhere: Set the webhook destination to your own system, or add the MCP connector and let an assistant do it. The app on the phone carries on as before.

- Tentar ligar um número que está na app de consumo do WhatsApp. A Coexistência precisa da app WhatsApp Business e o número tem de ser transferido para lá primeiro.
- Partir do princípio de que as conversas de grupo vão aparecer. Ficam excluídas da API nos números em Coexistência, em todos os fornecedores, por isso nada construído à volta de grupos funcionará.
- Responder com texto livre mais de 24 horas depois da última mensagem do cliente. Fora dessa janela, só passa um template aprovado.
- Deixar o webhook apontado para um URL que não consegue responder ao pedido de verificação da Meta. A Meta verifica o endpoint antes de entregar qualquer coisa e uma falha silenciosa parece exatamente uma configuração funcional.

**A minha equipa tem de deixar de usar o telemóvel?** Não. Esse é precisamente o objetivo da Coexistência. A app WhatsApp Business continua a funcionar no mesmo número, com as mesmas conversas, e a API funciona em paralelo.

**Vou perder as conversas que já existem?** Não. Ficam na app e a Meta sincroniza cerca de seis meses de histórico com a API quando o número é ligado, para que o software tenha contexto em vez de começar vazio.

**Posso desfazer a ligação?** Sim. Um número pode ser desligado e a app continua a funcionar como sempre. Ligar o número não o altera permanentemente.

**É o mesmo que as APIs não oficiais do WhatsApp?** Não, e essa diferença determina se o número sobrevive. A Coexistência é uma funcionalidade oficial da Meta na Cloud API. Os gateways não oficiais controlam o WhatsApp Web como dispositivo ligado, violam os termos e fazem com que os números sejam banidos.

---

## APIs não oficiais do WhatsApp: o que leva números a ser banidos

https://easycoexistence.com/pt-pt/unofficial-whatsapp-api-risks

As APIs não oficiais do WhatsApp funcionam iniciando sessão como dispositivo ligado e automatizando a sessão do WhatsApp Web. Isso viola os termos do WhatsApp, a Meta deteta o padrão e o número é banido. A Cloud API oficial faz o mesmo através de uma interface suportada pela Meta, no número que a empresa já utiliza.

### Como funcionam as APIs não oficiais do WhatsApp?

Todas fazem a mesma coisa por baixo, independentemente do que dizem as campanhas de marketing. Abrem o protocolo utilizado pelo WhatsApp Web, emparelham-se com uma conta como dispositivo ligado e controlam essa sessão através de código. A biblioteca lê as mensagens recebidas do socket e envia as mensagens de saída através dele.

É por isso que são baratas, que se instalam em poucos minutos e que conseguem aceder a funcionalidades que a API oficial não expõe. Não há nenhuma conta a solicitar nem nenhuma revisão a ultrapassar. Lê-se um código e começa-se a enviar.

É também por isso que o número fica em risco. Nada nessa sessão é autorizado. Os termos do WhatsApp proíbem a utilização automatizada ou em massa do cliente de consumo, e um dispositivo ligado é o cliente de consumo. A conveniência e a exposição são o mesmo facto visto de dois lados.

### Como é que a Meta deteta isso?

Não é procurando o nome de uma biblioteca, como muitas pessoas presumem e por isso pensam que uma reescrita as salvará. A deteção é comportamental e observa o padrão do tráfego.

Os sinais são os que a automatização produz naturalmente. A proporção entre mensagens enviadas e respostas recebidas, já que as conversas reais são aproximadamente equilibradas e os envios em massa não são. A distância no grafo de contactos, porque escrever a pessoas que nunca escreveram para si e que não partilham contactos não se parece nada com uma utilização normal. A regularidade dos horários, já que as pessoas não enviam mensagens em intervalos constantes. As denúncias dos destinatários, que têm grande peso e chegam mais depressa.

É por isso que um gateway que funciona há um ano não é prova de segurança. É prova de que o tráfego ainda não ultrapassou um limiar. O limiar não depende da biblioteca que envia a mensagem.

### Quanto custa realmente um banimento?

Custa mais do que a automatização alguma vez valeu, que é precisamente o que costuma ser subestimado.

O número deixa de funcionar. Não a automatização, o número. Todas as conversas nele ficam inacessíveis e os clientes dessas conversas não fazem ideia do que aconteceu. Simplesmente deixam de receber respostas. Para uma empresa cujo número está impresso num veículo, numa montra, num cartão ou em milhares de faturas anteriores, o número está mais próximo de uma linha telefónica do que de um software.

O histórico desaparece com ele. O mesmo acontece à lista de contactos criada dentro dessas conversas. Existem recursos e, por vezes, resultam, mas são lentos e ninguém pode garantir o resultado.

Para uma agência, as contas são ainda piores, porque o número que deixa de funcionar pertence a um cliente a quem nunca foi explicado que esse era o mecanismo.

### Como funciona a via oficial?

A objeção à API oficial era real. Implicava migrar o número, o que fazia a aplicação WhatsApp Business deixar de funcionar no telemóvel, e nenhuma equipa pequena aceitaria isso.

A Coexistence eliminou essa objeção. É o modo da própria Meta para executar a aplicação Business e a Cloud API no mesmo número em simultâneo. A equipa continua a responder a partir do telemóvel, as conversas e o histórico permanecem onde estão e a API fica ligada a essa mesma linha. Não existe nenhum dispositivo ligado, nenhuma sessão mantida num servidor e nenhuma credencial que valha a pena roubar.

A troca existe, mas é pequena. O texto livre só funciona durante 24 horas após a última mensagem do cliente, os templates precisam de aprovação e as conversas de grupo não estão disponíveis. Em troca, o número não pode ser banido por causa do próprio mecanismo.

- Acreditar que uma biblioteca que anuncia proteção anti-banimento resolveu o problema. A deteção observa o comportamento do tráfego, não o código que envia, por isso a afirmação descreve algo que o fornecedor não pode controlar.
- Tratar meses de tempo de atividade como prova de segurança. Isso significa apenas que o tráfego ainda não ultrapassou um limiar, o que é uma afirmação diferente.
- Testar primeiro num número pessoal. Um banimento aí é incómodo, mas não ensina nada sobre o número empresarial, que suporta muito mais tráfego.
- Guardar uma sessão não oficial num servidor partilhado. Essas credenciais dão acesso total à conta e são um alvo conhecido.

**O meu número já está em risco se usar uma destas soluções?** A exposição existe enquanto a sessão estiver ativa. Nada é acionado numa data fixa, por isso um longo período de atividade não é tranquilizador. É possível mudar para a API oficial no mesmo número sem perder a aplicação.

**Posso mudar para a API oficial sem alterar o meu número?** Sim. A Coexistence liga o número que já utiliza e a aplicação WhatsApp Business continua a funcionar no telemóvel durante todo o processo. Nada é migrado.

**O que é que a API oficial não consegue fazer?** As conversas de grupo estão excluídas nos números Coexistence. O texto livre só funciona durante 24 horas após a última mensagem do cliente e, fora dessa janela, as mensagens têm de utilizar um template aprovado pela Meta.

**A via oficial custa mais?** A Meta cobra as suas próprias taxas de mensagens em qualquer dos casos, faturadas diretamente a si. A diferença é uma tarifa mensal fixa por número, em vez do risco de perder o número.

---

## Ligar o WhatsApp ao n8n com a Cloud API oficial

https://easycoexistence.com/pt-pt/integrations/n8n

Defina o destino do webhook como um nó Webhook do n8n e cada mensagem enviada para o número chega como acionador de um fluxo. As respostas regressam pela Cloud API ou pelo nosso servidor MCP, ao qual o n8n consegue aceder porque o MCP Client Tool suporta OAuth2. O telemóvel continua a funcionar durante todo o processo.

### Como chega uma mensagem do WhatsApp a um fluxo n8n?

A Meta entrega cada mensagem enviada para o número num único URL que indicar, através de um HTTP POST. Esse URL é toda a integração. Coloque um nó Webhook do n8n num URL de produção, defina-o como destino do webhook do número e o fluxo é executado a cada mensagem recebida.

O payload inclui o remetente, o texto ou a referência multimédia, um carimbo de data e hora e o id da mensagem. A partir daí, é um fluxo n8n normal: crie ramificações com base no conteúdo, procure o cliente, chame os restantes serviços que utiliza e decida se deve responder.

Como se trata de Coexistência, a mesma mensagem também fica na aplicação WhatsApp Business do telemóvel. Uma pessoa pode responder-lhe. O fluxo vê o que a pessoa enviou, e a pessoa vê o que o fluxo enviou, para que nenhuma resposta se sobreponha à outra.

### Como envia o fluxo uma resposta?

Com um nó HTTP Request contra a Cloud API, utilizando o phone number id e o access token do número. Ambos podem ser consultados no painel ou através do conector MCP, se preferir que um assistente os obtenha.

O que deve enviar depende do momento, e esta é a parte que costuma causar problemas. Nas 24 horas seguintes à última mensagem do cliente, o texto livre funciona e a resposta é o que o fluxo compôs. Fora dessa janela, só passa um template que a Meta já tenha aprovado. Um fluxo que envia apenas texto livre parece perfeito nos testes, porque os testes acontecem sempre segundos depois de uma mensagem, e depois deixa de funcionar no primeiro caso real durante a noite.

A estrutura robusta é uma ramificação: verifique há quanto tempo chegou a última mensagem recebida e escolha texto livre ou um template em conformidade.

### O n8n também pode utilizar o conector MCP?

Sim, e o n8n distingue-se neste ponto. O seu nó MCP Client Tool liga-se a um servidor MCP remoto e suporta OAuth2, que é o necessário para o nosso servidor, permitindo que um nó AI Agent num fluxo chame diretamente as nossas ferramentas.

É importante saber isto porque a maioria das plataformas de automação não consegue fazê-lo. Make e Zapier executam os seus próprios servidores MCP e nenhum funciona como cliente, pelo que nenhum consegue chegar a um servidor de terceiros. O n8n consegue.

É útil para a parte de atuação: um nó de agente que decide enviar uma mensagem, verificar o estado de um número ou consultar o estado de aprovação de um template enquanto um fluxo está a ser executado. Não substitui o webhook, porque o MCP não tem forma de ser ativado por uma mensagem recebida.

### Qual dos dois deve um fluxo utilizar?

Ambos, para partes diferentes, e essa divisão não é uma preferência.

O webhook é a forma como tudo começa. Um cliente escreve, a Meta entrega a mensagem ao seu nó Webhook e o fluxo é executado. Não existe um equivalente MCP para isto em nenhuma ferramenta, porque o protocolo funciona através de pedidos e respostas, em vez de permitir que algo lhe faça uma chamada de entrada.

O MCP Client Tool serve para um agente dentro desse fluxo agir sem ter de codificar a chamada manualmente. Se o fluxo já souber exatamente o que deve enviar, um nó HTTP Request contra a Cloud API é mais simples e tem menos pontos de falha. Se um agente estiver a decidir, o conector disponibiliza-lhe as dezasseis ferramentas e as regras incluídas nas respetivas descrições, incluindo a janela de 24 horas.

### Em que difere isto dos nós WhatsApp do n8n que já são utilizados?

A maioria das configurações WhatsApp do n8n encontradas atualmente baseia-se num gateway não oficial que inicia sessão como dispositivo ligado. É um produto diferente, com custos definidos pelo respetivo fornecedor, e coloca o número em risco, porque esse mecanismo viola os termos do WhatsApp e a Meta deteta o padrão de tráfego, não a biblioteca utilizada.

A outra opção comum é a API oficial sem Coexistência. Também é um produto diferente: funciona, mas migra o número. A aplicação WhatsApp Business deixa de funcionar nesse número e a equipa que respondia ao longo do dia tem de mudar para uma nova ferramenta. Para muitas pequenas empresas, isso não é aceitável, razão pela qual tantas acabaram por utilizar gateways não oficiais.

A Coexistência reúne o que faltava: API oficial, enquanto o telemóvel continua a funcionar.

- Utilizar um URL de teste do n8n como destino do webhook. Deixa de escutar quando fecha o editor, pelo que as mensagens são entregues a lado nenhum.
- Não responder ao pedido de verificação da Meta. A Meta envia um GET com um desafio antes de entregar qualquer coisa, e um nó que não o devolva nunca recebe mensagens.
- Responder com texto livre fora da janela de 24 horas. Falha silenciosamente do ponto de vista do fluxo e apenas um template aprovado é aceite.

**Preciso de um nó n8n separado para isto?** Não. Um nó Webhook recebe e um nó HTTP Request envia. Não há nada para instalar, porque a integração é um URL e uma chamada REST.

**A equipa pode continuar a responder a partir do telemóvel?** Sim. É isso que significa Coexistência. A aplicação WhatsApp Business continua a funcionar no mesmo número, e o fluxo e a pessoa veem as mensagens uns dos outros.

**Um fluxo pode gerir os números de vários clientes?** Sim. Aponte cada número para o mesmo webhook e crie uma ramificação com base no phone number id recetor do payload. Uma conta suporta tantos números quantos forem necessários.

**O que acontece se a minha instância n8n estiver indisponível?** A Meta tenta entregar as mensagens durante algum tempo e depois deixa de tentar. As mensagens continuam a chegar à aplicação WhatsApp Business no telemóvel, pelo que nada se perde para a empresa, apenas para o fluxo.

---

## Ligue o WhatsApp ao Claude com um conector personalizado

https://easycoexistence.com/pt-pt/integrations/claude

Adicione https://easycoexistence.com/api/mcp como conector personalizado no Claude e inicie sessão. O Claude pode listar os seus números, verificar o estado, enviar mensagens e templates e encaminhar webhooks para os seus sistemas, tudo através da Cloud API oficial da Meta, em vez de uma sessão num dispositivo ligado.

### Como o adiciono ao Claude?

No Claude, abra as definições e adicione um conector personalizado apontado para o endpoint MCP do EasyCoexistence. O Claude abre uma página de início de sessão, autoriza-o e as ferramentas aparecem. Não é necessário gerar uma chave nem colar nada num ficheiro de configuração, porque o conector usa OAuth.

O Claude Desktop usa o mesmo conector, adicionado em Definições, em Connectors. O seu ficheiro de configuração descreve apenas servidores locais que a própria aplicação inicia, por isso um endpoint remoto como este não é escrito aí.

Em qualquer dos casos, o próprio servidor é remoto. Nada é instalado, nada é executado em segundo plano no seu portátil e fechar a aplicação não interrompe nada. O número mantém-se ligado, esteja ou não o Claude aberto.

### O que pode fazer o Claude depois de ligado?

Faça perguntas em linguagem corrente e o Claude escolhe a ferramenta. Qual dos meus números está com problemas? Envia a confirmação da reserva a este cliente. Cria um template para atualizações de encomendas e avisa-me quando a Meta o aprovar. Aponta o webhook deste número para o meu servidor.

As ferramentas de leitura são usadas diariamente sem grande atenção: listar números, verificar a classificação de qualidade, o nível de mensagens e o estado da ligação, além de obter as credenciais quando outro sistema precisa delas. As ferramentas de envio abrangem texto livre dentro da janela da sessão e templates aprovados fora dela.

O par mais importante para quem presta serviços a clientes é iniciar uma ligação e definir um destino para o webhook. Em conjunto, permitem que o Claude faça o onboarding do número de um cliente e o ligue ao seu sistema sem ninguém abrir um painel.

### O número está protegido contra banimentos ao fazer isto?

Sim, devido ao que está por baixo, não a qualquer característica do Claude.

Os servidores MCP do WhatsApp que as pessoas normalmente encontram controlam o WhatsApp Web como dispositivo ligado. Isso viola os termos do WhatsApp e a Meta deteta-o pelo comportamento do tráfego, pelo que o número é banido, independentemente do assistente que emite as instruções. Usar um assistente cuidadoso não ajuda, porque é o mecanismo que está proibido.

Este conector chama a Cloud API oficial da Meta num número integrado através da funcionalidade Coexistence da própria Meta. Não existe dispositivo ligado, não é mantida nenhuma sessão e nada viola os termos. Aplicam-se, em vez disso, os limites habituais: texto livre apenas nas 24 horas seguintes à última mensagem do cliente, templates aprovados fora desse período e sem conversas de grupo.

**Funciona no Claude Code e nas aplicações Claude?** Sim. É um servidor MCP remoto por HTTP com OAuth, por isso qualquer sistema que suporte conectores personalizados pode utilizá-lo, incluindo Claude Code, ChatGPT e Cursor.

**O Claude vê as conversas dos meus clientes?** Apenas aquilo que pedir. As mensagens recebidas são encaminhadas pela Meta para o destino de webhook que indicar e nunca armazenamos o conteúdo das conversas.

**O Claude pode ligar um número novo sozinho?** Pode iniciar o processo. O conector devolve uma ligação que o proprietário da empresa abre para autorizar o seu próprio número através do fluxo da Meta, uma etapa que só ele pode concluir.

**O que acontece se o Claude tentar enviar fora da janela?** A Cloud API rejeita o envio e o Claude vê o erro, podendo recorrer a um template aprovado. Nada é descartado silenciosamente.

---

## Cloud API ou Coexistência do WhatsApp: de que precisa um número

https://easycoexistence.com/pt-pt/whatsapp-cloud-api-vs-coexistence

A Coexistência não é uma alternativa à Cloud API, mas uma forma de integrar um número nela. Um número apenas na Cloud API pertence inteiramente ao software. Um número em Coexistência usa a API e a aplicação WhatsApp Business ao mesmo tempo, permitindo que uma equipa continue a responder pelo telemóvel.

### A Cloud API e a Coexistência são realmente coisas diferentes?

Não, e esta forma de apresentar o tema induz muitas pessoas em erro. A Cloud API é a WhatsApp Business Platform alojada pela Meta. A Coexistência é um modo de integrar um número nessa mesma API, mantendo depois a aplicação WhatsApp Business ativa nesse número.

Assim, os endpoints são os mesmos, o formato das mensagens é o mesmo, os templates funcionam da mesma forma e a janela de 24 horas aplica-se de modo idêntico. Tudo o que for criado para uma funciona na outra.

O que muda é o que acontece ao telemóvel. Ao integrar um número da forma habitual, a aplicação Business deixa de funcionar nele: o número passa a pertencer ao software e quem respondia tem de responder através do que tiver sido criado. Ao integrar através da Coexistência, ambas as superfícies ficam ativas e cada uma vê o que a outra envia.

### Quando é a Cloud API simples a melhor escolha?

Quando ninguém precisa de responder manualmente nesse número, algo mais comum do que parece.

Um número de notificações que apenas envia atualizações de encomendas não tem um lado humano a preservar. Um número novo, comprado especificamente para uma integração, nunca esteve na aplicação de ninguém. Uma linha de apoio de grande volume que já funciona através de um sistema de atendimento tem o seu fluxo humano noutro local, e voltar a colocar a aplicação WhatsApp Business no meio iria fragmentá-lo.

Nestes casos, a Coexistência acrescenta uma limitação sem benefício: o throughput de um número em Coexistência é fixado pela Meta, em vez de crescer com a classificação de qualidade e o nível de mensagens, e o requisito periódico de atividade do dispositivo torna-se uma obrigação de manutenção sem qualquer vantagem.

### Quando é a Coexistência a única opção que funciona?

Quando o número já é usado por uma empresa e alguém já responde através dele.

Isto abrange a maioria das pequenas empresas e, na prática, todos os números que uma agência recebe de um cliente. O número está impresso num veículo, numa montra, em faturas e num site. Durante o dia, alguém responde a partir de um telemóvel e conhece cada cliente habitual pelo nome. Dizer a essa pessoa que a aplicação vai deixar de funcionar encerra a conversa, e foi por isso que tantas empresas acabaram em gateways não oficiais em vez da API oficial.

A Coexistência eliminou esse compromisso. A aplicação continua a funcionar, a equipa não precisa de aprender nada novo e o software obtém a mesma API que obteria de qualquer forma.

### Um número pode passar de uma opção para a outra mais tarde?

Um número pode ser desligado e ligado novamente, por isso a decisão não é permanente da forma que muitas pessoas receiam. O que é permanente é a escolha relativa ao histórico de conversas.

Quando um número se liga pela primeira vez através da Coexistência, a Meta pergunta se deve partilhar as conversas existentes com a API. Essa decisão é tomada uma única vez durante a integração e não pode ser revista depois. Se recusar e mais tarde quiser o contexto, a única opção é desligar e voltar a ligar o número.

Por isso, a escolha que merece atenção não é o modo de integração. É decidir se aceita o histórico nesse dia, porque essa é a única decisão que não pode ser recuperada mais tarde.

- Tratar a Coexistência como uma API inferior. É a mesma Cloud API, alcançada através de uma integração diferente, com os mesmos endpoints e as mesmas regras.
- Escolher a Coexistência para um número a que ninguém responde manualmente. Acrescenta uma obrigação de atividade do dispositivo e um limite fixo de throughput em troca de um fluxo de trabalho no telemóvel que não existe.
- Recusar o histórico de conversas durante a integração e esperar adicioná-lo mais tarde. Essa escolha é feita uma vez e não pode ser alterada.

**A Coexistência é mais lenta do que a Cloud API simples?** O throughput de um número em Coexistência é fixado pela Meta, em vez de crescer com a classificação de qualidade e o nível de mensagens. Para uso conversacional, esse limite raramente é uma restrição, mas pode sê-lo no envio de grande volume.

**Os templates funcionam da mesma forma em ambas?** Sim. Os templates são enviados à Meta para revisão e transmitidos através da API de forma idêntica. Num número em Coexistência, a aplicação no telemóvel não pode enviá-los, por isso tudo o que estiver fora da janela de 24 horas tem de passar pela API.

**Posso colocar um número novo em Coexistência?** Primeiro, tem de ser registado na aplicação WhatsApp Business, porque a Coexistência liga um número que a aplicação já está a utilizar. Para um número ao qual ninguém responderá manualmente, a integração normal da Cloud API é a opção mais adequada.

**Que opção usam as agências para números de clientes?** Quase sempre, a Coexistência. O número de um cliente é um número a que a equipa já responde, e migrá-lo retiraria a aplicação WhatsApp Business aos seus colaboradores, algo que nenhum cliente aceita.

---

## Erro 131047 do WhatsApp: mensagem de reengajamento

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131047

O erro 131047 indica que passaram mais de 24 horas desde a última mensagem desse cliente, pelo que a janela de atendimento ao cliente está fechada e o texto livre não será entregue. Só um template previamente aprovado pela Meta pode reabrir a conversa.

### O que causa o erro 131047?

Uma mensagem de texto livre enviada a alguém cuja última mensagem tem mais de 24 horas.

A WhatsApp Business Platform só permite que uma empresa escreva livremente dentro de uma janela de atendimento ao cliente. Essa janela abre quando o cliente envia uma mensagem e dura 24 horas. Dentro dela, pode enviar o que quiser. Fora dela, a API rejeita o texto livre com o código 131047, em vez de entregar algo que o destinatário não solicitou.

A razão por que isto aparece em produção e não nos testes é o momento do envio. Ao testar uma integração, envia-se uma mensagem e responde-se segundos depois, sempre dentro da janela. O primeiro caso durante a noite, ou o primeiro cliente que fica em silêncio durante um dia, é quando o erro aparece.

### Como se resolve?

Envie um template aprovado em vez de texto livre.

Os templates são mensagens que envia previamente à Meta e que a Meta analisa. Depois de aprovado, um template pode ser enviado a qualquer momento, incluindo a alguém que nunca lhe tenha escrito. O envio reabre a conversa e, assim que o cliente responde, dispõe de novas 24 horas de texto livre.

Por isso, a correção duradoura não é repetir o envio. É criar uma ramificação: antes de enviar, verifique há quanto tempo esse contacto enviou a última mensagem. Dentro de 24 horas, envie texto livre. Fora desse período, envie o template adequado à situação. Uma integração que só sabe enviar texto livre continuará a encontrar este erro, que para quem acompanha a conversa parecerá silêncio, e não um erro.

### Isto aplica-se a um número Coexistence?

Sim, com uma consequência adicional importante.

A janela funciona da mesma forma quer o número tenha sido integrado através de Coexistence, quer não, porque é uma regra da plataforma e não de um modo de integração. O que muda é quem pode agir. Num número Coexistence, a aplicação WhatsApp Business não pode enviar templates, pelo que tudo o que ocorrer fora da janela terá de passar pela API.

Isto significa que uma equipa que responde a partir do telemóvel pode responder livremente a uma conversa ativa, mas não pode reiniciar uma conversa parada a partir da aplicação. O reinício é uma tarefa da API, uma das razões práticas pelas quais uma empresa liga o número em primeiro lugar.

- Repetir a mesma mensagem de texto livre. A janela não reabre por si só, pelo que a nova tentativa falha da mesma forma.
- Medir a janela a partir da sua última mensagem, em vez da mensagem do cliente. É a mensagem do cliente que a abre.
- Partir do princípio de que é possível escrever e enviar um template no mesmo momento. A Meta analisa-o primeiro, normalmente em poucos minutos, mas por vezes durante um dia.

**Posso prolongar a janela de 24 horas?** Não. É definida pela Meta e nenhum fornecedor pode aumentá-la. A única forma de a reabrir é o cliente enviar-lhe uma nova mensagem.

**A resposta do cliente a um template reabre a janela?** Sim. Qualquer mensagem do cliente inicia novas 24 horas, incluindo uma resposta a um template enviado por si.

**Que categoria de template devo usar?** Utility para mensagens transacionais e marketing para mensagens promocionais. Os envios de marketing exigem um método de pagamento na sua própria WhatsApp Business Account.

**O erro 131047 é igual ao 131049?** Não. O 131047 corresponde à janela fechada. O 131049 corresponde à limitação da entrega pela Meta para proteger a saúde do ecossistema, uma condição diferente.

---

## Erro 131049 do WhatsApp: mensagem bloqueada para proteger o ecossistema

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131049

O erro 131049 significa que a Meta optou por não entregar esta mensagem, para manter um envolvimento saudável no ecossistema. Não está relacionado com a janela de 24 horas nem com um problema de template. A orientação da Meta é aguardar pelo menos 24 horas antes de voltar a tentar contactar esse destinatário.

### O que significa, na prática, o envolvimento no ecossistema?

É o termo da Meta para indicar se as pessoas que recebem as mensagens acolhem bem o que as empresas lhes enviam, medido em toda a plataforma e não apenas na sua conta.

Quando a plataforma considera que um determinado envio não será bem recebido, bloqueia a mensagem e devolve o erro 131049. Trata-se de uma avaliação da mensagem e do destinatário, não de uma regra fixa que tenha violado. Por isso, pode surgir numa conta cuja classificação de qualidade parece estar normal.

Acontece sobretudo em envios de marketing para destinatários que não interagiram e em grandes volumes de mensagens semelhantes enviados em conjunto. É um sinal sobre o padrão de envio, não uma penalização aplicada ao número.

### Porque é que enviar um template não resolve?

Porque o template nunca foi o problema.

Ao ver um envio bloqueado, é natural tentar um template, pois essa é a solução para a outra falha comum, 131047. Mas 131047 é uma regra relacionada com o tempo: a janela fechou e um template aprovado é a forma autorizada de a reabrir. O erro 131049 é uma decisão sobre esta mensagem específica para esta pessoa específica, e o percurso do template é o mesmo percurso de entrega.

Voltar a tentar imediatamente, com ou sem template, tende a reforçar o padrão que desencadeou o bloqueio. A própria orientação da Meta é aguardar pelo menos 24 horas antes de tentar novamente contactar esse destinatário e verificar se a mensagem era algo que provavelmente gostaria de receber.

### Como evitar que volte a acontecer?

Alterando o que é enviado, e não a forma como é enviado.

Envie mensagens a pessoas que tenham interagido recentemente, em vez de enviar para uma lista inteira. Varie o conteúdo, pois mensagens quase idênticas enviadas em volume são o padrão observado neste caso. Prefira mensagens úteis ligadas a uma ação do cliente, como uma encomenda ou reserva, em vez de promoções generalizadas.

Também vale a pena acompanhar em conjunto a classificação de qualidade e o nível de mensagens, porque ambos variam pela mesma razão subjacente: a reação negativa dos destinatários. Um número cuja qualidade esteja a diminuir costuma apresentar mais erros deste tipo antes de surgir algo mais grave. Detetar essa descida cedo permite ajustar o envio antes de sofrer limitações.

- Tratá-lo como um problema da janela de 24 horas e mudar para um template. É uma condição diferente, com o mesmo resultado.
- Voltar a tentar imediatamente. A orientação da Meta é aguardar pelo menos 24 horas para esse destinatário.
- Interpretá-lo como uma proibição. O número continua a funcionar; apenas esta mensagem não foi entregue.

**O meu número foi banido?** Não. O erro 131049 bloqueia uma mensagem. O número continua a funcionar e outros envios podem ser bem-sucedidos.

**Quanto tempo devo aguardar?** A orientação da Meta é aguardar pelo menos 24 horas antes de voltar a enviar para esse destinatário. Não existe um valor exato publicado.

**Isto afeta a minha classificação de qualidade?** É um sinal da mesma medida subjacente, por isso, quando surge com frequência, deve ser tratado como um alerta precoce sobre a qualidade e não como um erro isolado.

**Um fornecedor consegue contornar o problema?** Não. A Meta aplica-o no momento da entrega, por isso todos os fornecedores que usam a API oficial observam o mesmo comportamento.

---

## Erro 131048 do WhatsApp: limite de spam atingido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131048

O erro 131048 indica que a Meta está a restringir os envios deste número porque a sua qualidade diminuiu, geralmente depois de os destinatários bloquearem ou denunciarem mensagens. O número continua a funcionar. O que mudou foi a quantidade que pode enviar enquanto a qualidade recupera.

### O que faz baixar a qualidade de um número?

Reações negativas dos destinatários, que a Meta mede em vez de as inferir a partir do seu código.

Os sinais incluem bloqueios, denúncias e, de forma mais discreta, pessoas que simplesmente não respondem a mensagens que esperavam uma resposta. Um número que envia muitas mensagens e recebe poucas respostas comporta-se de forma diferente de um número onde existem conversas, e essa diferença acumula-se na classificação de qualidade.

A classificação passa por verde, amarelo e vermelho. É no vermelho que os envios começam a falhar com este erro. Nenhuma alteração é anunciada no telemóvel e a aplicação WhatsApp Business continua a funcionar normalmente, razão pela qual o primeiro sinal para a maioria das empresas é um envio falhar, e não um aviso.

### Como recupera um número?

Por si só, se parar o tipo de envios que causou a queda.

A qualidade é uma medida contínua. À medida que os envios recentes recebem melhores reações, a classificação sobe e o limite aumenta com ela. Não há nenhum recurso a apresentar nem nenhuma opção que um fornecedor possa ativar, o que também significa que ninguém lhe pode vender uma solução.

O que ajuda realmente é restringir quem recebe mensagens. Envie mensagens a pessoas que tenham interagido recentemente. Prefira mensagens utilitárias ligadas a uma ação do cliente em vez de promoções enviadas em massa. Corte tudo o que seja enviado para uma lista, em vez de para uma pessoa. O padrão que fez baixar a classificação é o mesmo que a mantém baixa, por isso a recuperação começa quando esse padrão muda.

### Como saberia antes de falhar?

Apenas acompanhando a própria classificação, razão pela qual este é o argumento mais claro para monitorizar uma ligação, em vez de apenas a ligar.

A Meta apresenta a classificação de qualidade e o nível de mensagens no número de telefone, e estes mudam antes de lhe causarem custos. Um número que passa de verde para amarelo é um aviso ainda a tempo de agir. Um número que chega a vermelho e começa a devolver este erro já perdeu envios, e nessa altura as mensagens afetadas desaparecem em vez de ficarem em fila.

A queda não aparece na aplicação WhatsApp Business, por isso uma equipa que responde a partir do telemóvel vê tudo normal até ao momento em que os envios param.

- Interpretá-lo como um erro no código de envio. O pedido está correto; o número está limitado.
- Mudar de fornecedor para o evitar. A classificação pertence ao número e acompanha-o.
- Esperar por uma notificação. Nenhuma alteração de qualidade é anunciada no telemóvel.

**Ainda posso receber mensagens?** Sim. A receção não é afetada e a aplicação WhatsApp Business continua a funcionar normalmente no número.

**Quanto tempo demora a recuperação?** A Meta não publica um valor. É uma medida contínua, por isso melhora à medida que os envios recentes melhoram, e não após um período fixo.

**Mudar para outro fornecedor repõe a situação?** Não. A qualidade está associada ao número de telefone, não a quem envia através dele.

**É o mesmo que ser banido?** Não. Um banimento remove o número. Isto limita a quantidade que um número funcional pode enviar até a sua qualidade recuperar.

---

## Erro 132001 do WhatsApp: template inexistente

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132001

O erro 132001 indica que o template que tentou enviar não existe no idioma pedido ou existe, mas não foi aprovado. Os templates são identificados pelo nome e pelo idioma em conjunto, pelo que o mesmo nome noutra região corresponde a um template diferente.

### Porque é que um template existente devolve 132001?

Quase sempre por causa do código de idioma.

Um template é identificado pelo nome e pelo idioma em conjunto. Um template criado como order_update em en_US não existe como order_update em en, em pt ou em pt_BR. Enviar o nome certo com a região errada produz exatamente este erro, e a mensagem é pouco esclarecedora sobre qual dos dois elementos está errado.

A segunda causa é o estado de aprovação. Um template criado, mas ainda pendente de revisão, não é enviado, tal como um template rejeitado. Ambos devolvem o mesmo código que um template nunca criado, por isso convém verificar o estado antes de assumir que o nome está errado.

### Como encontrar o nome e o idioma certos?

Apresente os templates do número e leia os dados apresentados, em vez de confiar no que foi configurado.

A listagem mostra o nome exato, o código de idioma exato e o estado de revisão de cada template, resolvendo de uma só vez as três causas deste erro. É também a única fonte fiável, porque um template pode ser editado ou rejeitado depois de o processo que o criou ter guardado o nome.

Através do conector MCP, isto é uma pergunta, não uma chamada à API: peça os templates aprovados num número e o assistente apresenta-os. No seu próprio código, é um único pedido Graph à WhatsApp Business Account, usando o ID do número de telefone e o token dessa ligação.

### Quanto tempo demora a aprovação?

Normalmente, alguns minutos; por vezes, até um dia.

A Meta revê todos os templates antes de estes poderem ser enviados. A maioria é aprovada rapidamente, mas o prazo não é garantido nem pode ser acelerado por um fornecedor. Isto é importante em processos que criam um template e tentam enviá-lo de imediato, porque o envio falha com este erro enquanto a revisão estiver pendente.

A abordagem robusta é criar os templates antecipadamente, ao configurar uma integração, e verificar o estado antes de depender de um deles. Um assistente com o conector pode fazer ambas as operações: submeter o template e indicar se foi aprovado, rejeitado ou continua em revisão.

- Enviar en quando o template foi criado como en_US. Para a API, são templates diferentes.
- Criar um template e enviá-lo na mesma execução. A Meta revê-o primeiro.
- Assumir que um template rejeitado continua a funcionar. Devolve exatamente este erro, tal como um template inexistente.

**Onde vejo o código de idioma exato?** Na listagem de templates desse número. Mostra o nome, o idioma e o estado em conjunto, sendo a única fonte fiável.

**Posso enviar um template pendente?** Não. Apenas os templates aprovados são entregues, e um template pendente devolve este mesmo erro.

**É preciso recriar um template rejeitado?** Pode editá-lo e voltar a submetê-lo. O que não pode fazer é enviá-lo enquanto estiver rejeitado.

**A aplicação WhatsApp Business pode enviar templates?** Não num número de Coexistência. Os templates são enviados através da API, uma das razões práticas para ligar um número.

---

## Erro 132000 do WhatsApp: número de parâmetros incompatível

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132000

O erro 132000 significa que as variáveis fornecidas não coincidem com as esperadas pelo template. Um template com dois marcadores precisa exatamente de dois valores, pela ordem. Surge frequentemente depois de alguém editar um template sem atualizar o código de envio.

### Como são contadas as variáveis do template?

Por componente, pela ordem, usando os marcadores numerados no texto do template.

Um corpo de template com o texto Hello {{1}}, your order {{2}} has shipped define duas variáveis, e um envio tem de fornecer exatamente dois valores para o componente do corpo. Fornecer um ou três devolve este erro. O mesmo acontece ao fornecer dois para o componente errado, porque os parâmetros do cabeçalho, do corpo e do botão são contados separadamente, em vez de serem reunidos numa única lista.

Por isso, o erro pode parecer errado à primeira vista: o número total de valores pode estar correto, mas a distribuição pelos componentes não.

### Porque surge num template que funcionava ontem?

Porque alguém editou o template e o código de envio não foi alterado com ele.

Os templates podem ser editados depois da aprovação, e adicionar ou remover um marcador altera silenciosamente o contrato do ponto de vista do remetente. A integração não recebe nenhum aviso, e o envio seguinte falha. Numa equipa em que o marketing edita templates no WhatsApp Manager e a engenharia é responsável pelo código de envio, esta é a forma mais comum de surgir o erro.

A solução é ler novamente o template, em vez de confiar num valor registado quando foi criado. A listagem de templates devolve a definição atual, que é a única versão relevante no momento do envio.

### Como fornecer os valores corretamente?

Criando o array de componentes de acordo com a estrutura do próprio template.

Cada componente indica o seu tipo e contém os seus próprios parâmetros pela ordem em que os marcadores aparecem. Um corpo com duas variáveis precisa de um componente de corpo com dois parâmetros de texto. Um template que também tenha uma variável no cabeçalho precisa igualmente de um componente de cabeçalho, com o seu próprio parâmetro, em vez de adicionar o valor do cabeçalho à lista do corpo.

Através do conector MCP, isto fica um passo mais distante: um assistente lê o template, identifica quantos marcadores existem em cada componente e preenche-os com base no que foi pedido. No seu próprio código, convém ler a definição do template no arranque, em vez de fixar uma estrutura que pode mudar.

- Reunir as variáveis do cabeçalho e do corpo numa única lista. São contadas por componente.
- Fixar a contagem de variáveis. Uma edição do template altera-a sem avisar o remetente.
- Enviar uma cadeia vazia para um marcador não utilizado. O template continua a defini-lo, por isso a contagem tem de coincidir.

**Posso enviar um template sem variáveis?** Sim. Se o template não definir nenhuma, não envie parâmetros. Fornecê-los mesmo assim devolve este erro.

**A ordem dos valores é importante?** Sim. Os marcadores são numerados e preenchidos pela ordem, por isso trocar dois valores produz uma mensagem errada, não um erro.

**Porque é que o mesmo envio funciona numa língua e não noutra?** Cada versão linguística é um template separado e pode ter um número diferente de marcadores depois de uma edição.

**É o mesmo que 132001?** Não. 132001 significa que o template não foi encontrado ou não está aprovado. 132000 significa que foi encontrado, mas as variáveis não coincidiram.

---

## Erro 2593107 do WhatsApp: limite de sincronização excedido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-2593107

O erro 2593107 indica que este número já usou a sua única sincronização de contactos e histórico de conversas. A sincronização ocorre uma vez por integração e não pode ser repetida, pelo que é necessário desligar o número e voltar a ligá-lo.

### A que sincronização se refere este erro?

É o passo que transporta os contactos existentes e o histórico de conversas de um número Coexistence para o lado da API, para que o software não comece sem contexto num número que uma empresa utiliza há anos.

Isto só existe devido à Coexistence. Um número integrado da forma habitual não tem histórico anterior da aplicação para transportar, pelo que não há nada para sincronizar. Um número Coexistence tem ambos, e a Meta disponibiliza uma transferência única no momento em que o número é ligado.

É também por isso que este erro é desconhecido até para quem trabalha com a Cloud API há muito tempo. Pertence a um modo de integração que nunca utilizou.

### Porque só pode ser executada uma vez?

Porque faz parte da integração, e não de uma capacidade contínua, e a Meta trata-a como uma decisão única tomada no momento da ligação.

Durante o Embedded Signup, o proprietário da empresa é questionado sobre se pretende partilhar o histórico de conversas existente. Responder afirmativamente permite executar a sincronização. Não existe nenhuma definição para a reativar mais tarde nem nenhum endpoint que a repita. Por isso, uma segunda chamada devolve este erro, e não um limite de frequência que desaparece.

A consequência prática é que esta escolha é mais importante do que parece no momento. Ao avançar rapidamente na integração e recusar o histórico por parecer mais seguro, toma-se uma decisão que só pode ser revista desligando e voltando a ligar completamente o número.

### O que acontece se for mesmo necessário repeti-la?

É necessário desligar o número e voltar a ligá-lo. Trata-se de uma operação real, não de uma definição.

Ao ligar novamente, o Embedded Signup é executado desde o início, incluindo a leitura do código no telemóvel, e surge uma nova oportunidade para aceitar o histórico. A aplicação WhatsApp Business permanece inalterada, pelo que a empresa não perde nada, mas esta não é uma ação silenciosa em segundo plano: é necessário estar junto do telemóvel.

Há uma consequência que convém planear. O desligamento remove o destino do webhook, porque esse destino existe como substituição numa subscrição da aplicação, e não no número. Ligar novamente restaura o envio e a monitorização, mas não a entrega no seu próprio servidor, a menos que algo volte a configurá-la.

- Repetir a chamada de sincronização. É uma operação única, pelo que a nova tentativa devolve o mesmo erro em vez de ter sucesso mais tarde.
- Recusar o histórico de conversas durante a integração por precaução. Esta escolha só pode ser revista ligando novamente o número.
- Ligar novamente sem planear a reposição do destino do webhook, que é removido juntamente com a aplicação.

**Isto acontece num número normal da Cloud API?** Não. A sincronização existe apenas para números Coexistence, porque só estes têm histórico anterior da aplicação para transportar.

**Quanto histórico é sincronizado?** A Meta sincroniza uma janela do histórico recente de conversas durante a integração. A quantidade exata é definida pela Meta, e não por um fornecedor.

**Ao ligar novamente, perco as conversas no telemóvel?** Não. A aplicação WhatsApp Business e as suas conversas não são alteradas ao desligar e voltar a ligar o lado da API.

**2593108 é o mesmo problema?** Não. Esse código significa que a sincronização foi tentada mais de 24 horas após a integração, e não que já tinha sido executada.

---

## Erro 2593108 do WhatsApp: sincronização fora da janela de 24 horas

https://easycoexistence.com/pt-pt/docs/whatsapp-error-2593108

O erro 2593108 indica que a sincronização dos contactos e do histórico de conversas começou mais de 24 horas depois de o número concluir o onboarding. Essa janela é definida pela Meta e, depois de expirar, a única forma de sincronizar é ligar novamente o número.

### A que janela de 24 horas se refere?

Não é a janela de mensagens, que está na origem da maior parte da confusão em torno deste erro.

A WhatsApp Business Platform tem uma conhecida janela de atendimento ao cliente de 24 horas, contada a partir da última mensagem de um cliente, que determina se é possível enviar texto livre. Este é um período completamente diferente. Começa no momento em que um número de Coexistência conclui o onboarding e determina apenas se ainda é possível importar contactos e histórico de conversas.

As duas janelas não têm qualquer relação além do número, e uma mensagem enviada com sucesso não indica que a janela de sincronização ainda esteja aberta.

### Porque é que esta janela passa despercebida?

Porque o onboarding e a integração costumam acontecer em dias diferentes, muitas vezes por pessoas diferentes.

Uma sequência típica é o proprietário de uma empresa ligar o número à tarde e, mais tarde nessa semana, uma agência ou um programador integrá-lo nos seus sistemas. Quando alguém pensa no histórico, a janela já fechou e a falha surge como um código de erro desconhecido, em vez de um aviso.

Vale a pena tratar a sincronização como parte do onboarding, e não da integração. Se o histórico for importante, tem de ser importado no mesmo dia em que o número é ligado, antes de qualquer outro trabalho.

### Quais são as opções depois de a janela fechar?

Desligar e ligar novamente o número ou aceitar começar sem histórico.

Ligar novamente reinicia o Embedded Signup, incluindo a leitura do código no telemóvel, e abre uma nova janela. Nada na aplicação WhatsApp Business é afetado, por isso a empresa mantém as suas conversas em qualquer dos casos. O custo é ter alguém novamente junto do telemóvel.

Começar sem histórico é muitas vezes suficiente. A API recebe tudo a partir do momento em que é ligada, e a maioria das integrações preocupa-se mais com conversas novas do que com as antigas. O histórico é mais importante quando é necessário consultar imediatamente o contexto anterior de um cliente, um caso mais específico do que parece à primeira vista.

- Confundir esta janela com a janela de mensagens. São períodos separados, que medem coisas diferentes.
- Deixar o histórico para quando começar o trabalho de integração. Nessa altura, a janela já fechou normalmente.
- Voltar a ligar o número sem restaurar o destino do webhook, que não sobrevive a uma desligação.

**Esta é a mesma janela de 24 horas das mensagens?** Não. Esta começa no onboarding e controla a sincronização. A janela de mensagens começa na última mensagem do cliente e controla o texto livre.

**É possível prolongar a janela?** Não. É definida pela Meta e nenhum fornecedor pode prolongá-la.

**Voltar a ligar o número tem algum custo?** Não há qualquer cobrança por voltar a ligar. O custo é ter alguém junto do telemóvel para ler novamente o código.

**E se nunca sincronizar o histórico?** A API continua a receber tudo a partir do momento em que o número é ligado. O histórico só é importante quando é necessário consultar imediatamente o contexto anterior.

---

## Erro do WhatsApp 131026: mensagem não entregue

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131026

O erro 131026 significa que a Meta não conseguiu entregar a mensagem a esse destinatário. A causa habitual é o número não estar registado no WhatsApp, embora um cliente desatualizado ou termos não aceites produzam o mesmo código.

### Porque é que um número aparentemente válido não pode receber a mensagem?

Porque ter um número de telefone não é o mesmo que ter o WhatsApp associado a esse número.

De longe, a causa mais comum é o destinatário nunca ter registado esse número no WhatsApp ou já o ter removido. O formato do número não revela isso, razão pela qual uma lista importada de um CRM produz estes erros em volume: contém números de telefone, mas apenas alguns são números do WhatsApp.

Duas causas menos comuns produzem o mesmo código. O destinatário pode estar a usar um cliente do WhatsApp demasiado antigo para receber o tipo de mensagem enviado ou pode não ter aceitado os termos exigidos por uma funcionalidade mais recente. Ambas estão fora do controlo de quem envia.

### O que deve acontecer quando recebe este erro?

Registe-o no contacto e deixe de enviar para esse número, em vez de voltar a tentar.

A condição está do lado do destinatário, por isso uma nova tentativa imediata produz normalmente o mesmo resultado, tal como uma tentativa agendada. Tratá-la como temporária faz com que uma integração consuma throughput com números que nunca receberão nada.

A resposta mais útil é marcar o contacto como não alcançável no WhatsApp e encaminhá-lo para outro canal. Isso também evita que a lista de contactos se deteriore silenciosamente. Se o número estiver de facto no WhatsApp, a correção cabe ao destinatário, não a si.

- Voltar a tentar segundo um agendamento. A condição está do lado do destinatário e não desaparece com o passar do tempo.
- Interpretá-lo como um problema de formato. O número chegou à Meta e foi rejeitado na entrega, não na validação.
- Enviar para uma lista de CRM sem filtragem. Um número de telefone não é necessariamente um número do WhatsApp.

**Posso verificar primeiro se um número está no WhatsApp?** Não de forma fiável, e a Meta não disponibiliza uma consulta para isso. Na prática, o primeiro envio é a verificação.

**Isto afeta a minha classificação de qualidade?** Destinatários inalcançáveis não são o mesmo que destinatários que bloqueiam ou denunciam a sua conta, mas enviar em grande volume para uma lista cheia deles é um padrão que pode ter efeitos noutros indicadores.

**O formato do número é o problema?** Normalmente, não. Números malformados devolvem antes um erro de parâmetro. Este código significa que o número foi compreendido, mas não foi possível contactá-lo.

**Devo remover o contacto?** Marque-o como inalcançável no WhatsApp, em vez de o eliminar. A pessoa pode registar esse número mais tarde.

---

## Erro 131042 do WhatsApp: problema de pagamento da conta empresarial

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131042

O erro 131042 significa que a Meta não consegue cobrar as mensagens porque a Conta do WhatsApp Business não tem um método de pagamento válido. Essas cobranças são faturadas diretamente pela Meta, pelo que a solução está no WhatsApp Manager, não junto de quem fornece o acesso à API.

### Quem está efetivamente a faturar quem?

São duas empresas, e apenas uma das cobranças tem alguma relação com o fornecedor.

A Meta cobra as conversas na Plataforma do WhatsApp Business e debita o método de pagamento associado à sua própria Conta do WhatsApp Business. Essa relação é entre a empresa e a Meta. Um fornecedor está ao lado dessa relação, cobrando pelo acesso e pelas ferramentas, e nunca vê essas cobranças de conversas.

É por isso que o erro não pode ser resolvido contactando o fornecedor, e que ninguém nessa posição pode adicionar um cartão em seu nome. Significa também que o custo das conversas não pode ser majorado por um fornecedor que nunca o recebe.

### Onde é definido o método de pagamento?

No WhatsApp Manager, na Conta do WhatsApp Business que detém o número.

Adiciona ou atualiza aí um método de pagamento, e a conta tem de ter um antes de determinados envios funcionarem. Os envios de templates de marketing exigem-no em particular, razão pela qual o erro aparece muitas vezes quando alguém tenta pela primeira vez fazer um envio promocional numa conta que sempre se limitou a responder aos clientes.

A API não pode fazer isto de propósito. Não existe um endpoint para associar um cartão, por definição, porque se trata de uma relação comercial ao nível da conta, não de uma operação de mensagens.

- Pedir ao fornecedor que resolva o problema. A relação de faturação é entre a empresa e a Meta, e nenhuma API pode associar um cartão.
- Assumir que a comissão do fornecedor inclui os custos das mensagens. São cobranças separadas de empresas diferentes.
- Tentar enviar templates de marketing numa conta sem método de pagamento. A Meta exige um para esses envios.

**A EasyCoexistence pode pagar à Meta por mim?** Não. As cobranças são feitas ao método de pagamento da sua própria Conta do WhatsApp Business, e não existe uma API para associar um.

**Porque é que isto só apareceu agora?** Muitas vezes, porque foi tentado o primeiro envio de um template de marketing. A Meta exige especificamente um método de pagamento para esses envios.

**Isto impede a receção de mensagens?** A receção não é afetada. O que falha é o envio pelo qual a Meta precisa de cobrar.

**É possível evitar totalmente as cobranças da Meta?** As respostas dentro da janela de 24 horas do serviço ao cliente são gratuitas. A Meta cobra pelas conversas iniciadas fora dessa janela.

---

## Erro 133010 do WhatsApp: número de telefone não registado

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133010

O erro 133010 significa que o número de telefone não concluiu o registo na WhatsApp Business Platform. Pode estar associado à conta e visível no painel, mas, até o registo terminar, não pode enviar nada.

### O que significa realmente o registo neste caso?

É o passo final que torna um número utilizável para enviar mensagens, separado da existência do número na WhatsApp Business Account.

A integração associa um número a uma conta e fornece os respetivos identificadores. O registo informa a plataforma de que o número está pronto para transacionar. É um passo que se ignora sem perceber, porque o painel já mostra o número nessa altura. Tudo parece ligado, mas o primeiro envio falha.

Num número Coexistence, é fácil não perceber isto por outro motivo: a aplicação WhatsApp Business no telemóvel continua a funcionar perfeitamente, por isso nada no dia a dia da empresa indica que falta concluir alguma coisa.

### Como é que a integração fica incompleta?

Normalmente, porque alguém fechou a janela.

O Embedded Signup da Meta é executado numa janela pop-up e inclui vários passos, entre eles a leitura de um código no telemóvel. Fechá-la depois de o número aparecer, mas antes de o processo terminar, deixa exatamente este estado. O mesmo acontece se o telemóvel perder a ligação a meio ou se a sessão expirar enquanto alguém procura o dispositivo.

A solução é executar o processo novamente, em vez de voltar a tentar o envio. Ao ligar novamente, o processo recomeça e conclui o registo. Repeti-lo não prejudica o número nem a aplicação WhatsApp Business.

- Voltar a tentar o envio. O registo não fica concluído porque foi tentada uma mensagem.
- Assumir que um número visível está a funcionar. Pode estar associado à conta e continuar não registado.
- Diagnosticar a partir do telemóvel. A aplicação WhatsApp Business funciona normalmente, quer o registo tenha terminado, quer não.

**O número perdeu-se?** Não. Ao executar novamente o processo de integração da Meta, o registo fica concluído e a aplicação WhatsApp Business não é afetada.

**Posso fazer o registo através da API?** O registo faz parte do processo de integração da Meta, que precisa de um navegador e do telemóvel. Não existe um atalho na API para evitar a leitura do código.

**Porque é que continuo a receber mensagens?** A receção e o envio não dependem do mesmo passo, por isso um número com a integração incompleta pode parecer ativo no telemóvel.

**É o mesmo que o erro 133006?** Não. O erro 133006 significa que o número precisa de verificação antes de o registo poder ocorrer. Este significa que o próprio registo nunca foi concluído.

---

## Erro 190 do WhatsApp: token de acesso expirado

https://easycoexistence.com/pt-pt/docs/whatsapp-error-190

O erro 190 significa que o token de acesso usado no pedido expirou ou foi invalidado. Todas as chamadas falham da mesma forma, fazendo parecer que o número desapareceu. Não desapareceu: a credencial deixou de funcionar e, normalmente, o número está bem.

### Por que motivo um token expirado parece um número perdido?

Porque todos os pedidos falham, e falham da mesma forma.

Consultar o número, verificar o seu estado, listar templates e enviar uma mensagem deixam de funcionar ao mesmo tempo. Do exterior, isto é indistinguível de o número ter sido removido da conta, e uma integração com uma só credencial não consegue distinguir as duas situações. Muitas pessoas concluem que foram desligadas quando nada disso aconteceu.

A diferença é importante porque as respostas são opostas. Uma credencial danificada é substituída. Um número removido tem de ser ligado novamente, o que exige o proprietário da empresa e o telemóvel.

### Como se distingue uma situação da outra?

Mantendo uma segunda credencial que consiga ler a mesma conta.

A EasyCoexistence mantém o token do cliente e o seu próprio token System User para cada ligação. Quando um é rejeitado, o outro lê a WhatsApp Business Account e esclarece qual dos dois falhou. Se o token do cliente for rejeitado, mas a segunda leitura funcionar, a credencial expirou e o número está saudável. Se ambos falharem, aconteceu algo ao próprio número.

Sem esse segundo leitor, a única forma de os distinguir é pedir ao proprietário da empresa que verifique, precisamente o tipo de interrupção que a monitorização deve evitar.

### Como são invalidados os tokens?

De várias formas, na maioria dos casos sem intenção.

Os tokens têm uma duração e expiram por si próprios. Alterar a palavra-passe da conta Meta invalida-os. Remover o acesso de uma aplicação em Business Settings também os invalida, tal como a Meta pode revogar um token que considere comprometido. Nenhuma destas situações apresenta primeiro um aviso, e nenhuma é visível na aplicação WhatsApp Business do telemóvel.

É por isso que a validade dos tokens deve fazer parte da monitorização, e não apenas de um gestor de erros. Quando um gestor de erros o deteta, os envios já falharam.

- Voltar a ligar o número. Se o problema for o token, isso pede ao proprietário da empresa um trabalho que nunca foi necessário.
- Tratá-lo como uma falha intermitente e repetir. Um token invalidado não recupera por si próprio.
- Depender de uma só credencial. Com um único token, não há forma de distinguir uma falha de credenciais de um número perdido.

**O número continua a funcionar?** Normalmente, sim. A app WhatsApp Business não é afetada e o próprio número está intacto. O que deixou de funcionar foi o acesso à API.

**O erro 0 é a mesma coisa?** Na prática, sim. A Meta comunica esta condição com ambos os códigos, dependendo do endpoint.

**Voltar a ligar resolve o problema?** Resolveria, mas é uma resposta pesada para um problema simples e exige o proprietário da empresa e o telemóvel para algo que uma nova credencial resolve.

**É possível impedir que os tokens expirem?** Os tokens System User podem ter uma duração longa, o que explica em parte a utilidade de manter um segundo token.

---

## Erro 130429 do WhatsApp: limite de throughput atingido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-130429

O erro 130429 indica que o limite de throughput da Cloud API para este número foi atingido. É um problema de taxa, não de volume: as mesmas mensagens, enviadas mais devagar, são aceites. Num número Coexistence, o limite máximo é fixado pela Meta.

### O que está realmente limitado?

A taxa a que as mensagens saem, não o número que pode enviar num dia.

A plataforma aceita um determinado número de mensagens por segundo para um número, e os pedidos acima desse limite são rejeitados em vez de serem colocados numa fila. Por isso, enviar dez mil mensagens não é, por si só, um problema; enviá-las todas no mesmo segundo é. Distribuído por alguns minutos, o mesmo lote é processado sem alterações.

Isto é diferente do escalão de mensagens, que determina com quantos clientes únicos pode iniciar conversas por dia, e da limitação por qualidade, que restringe um número cujos destinatários reagem negativamente. São três limites diferentes, com três códigos diferentes, frequentemente confundidos.

### É possível aumentar o limite?

Não num número Coexistence. A Meta fixa-o numa taxa definida e nenhum fornecedor pode aumentá-lo, algo importante antes de criar uma solução dependente de um limite superior.

Num número integrado da forma habitual, o throughput aumenta com a classificação de qualidade e o escalão de mensagens ao longo do tempo. Essa diferença é uma das poucas compensações reais da Coexistence e explica por que razão um número de difusão de grande volume costuma beneficiar mais de uma integração sem Coexistence.

Para uso conversacional, o limite máximo raramente é uma restrição. Torna-se relevante quando algo percorre uma lista e envia tão depressa quanto o código permite, um padrão que vale a pena evitar por si só.

### O que deve fazer o remetente?

Controle o ritmo de envio e volte a tentar com um backoff, em vez de repetir imediatamente.

Uma fila com uma taxa fixa é a resposta duradoura, porque transforma o limite numa propriedade do sistema, em vez de algo descoberto em produção. Quando isso for excessivo, um backoff exponencial para este código específico oferece grande parte do benefício.

Repetir rapidamente não funciona. Um ciclo que repete imediatamente após uma rejeição gera mais pedidos precisamente quando o número já ultrapassou a sua taxa, prolongando a condição em vez de a resolver.

- Repetir imediatamente. Mais pedidos no momento da rejeição mantêm o número acima da sua taxa.
- Confundir este erro com o escalão de mensagens. Esse escalão determina conversas únicas diárias, não mensagens por segundo.
- Conceber um número Coexistence com base num throughput crescente. Isso não acontece; o limite máximo é fixo.

**Isto significa que o meu número está restringido?** Não. É um limite de taxa normal. O número está saudável e as mesmas mensagens são processadas quando enviadas mais devagar.

**A que velocidade pode enviar um número Coexistence?** A Meta define uma taxa fixa para números Coexistence, em vez de a aumentar com a qualidade e o escalão.

**É o mesmo que 80007?** Não. Esse código é um limite de taxa da WhatsApp Business Account, não do throughput de mensagens de um número.

**Um fornecedor diferente enviará mais depressa?** Não. O limite pertence ao número e à Meta, não a quem chama a API.

---

## Ligar o WhatsApp ao Make pela Cloud API oficial

https://easycoexistence.com/pt-pt/integrations/make

Aponte o destino do webhook do número para um webhook personalizado do Make e cada mensagem recebida inicia um cenário. As respostas regressam pela Cloud API através de um módulo HTTP. O Make não pode usar o nosso servidor MCP, porque é ele próprio um servidor MCP, não um cliente.

### Como é que uma mensagem do WhatsApp inicia um cenário Make?

Crie um módulo de webhook personalizado no Make, copie o URL fornecido e defina-o como destino do webhook do número. A partir daí, a Meta entrega cada mensagem enviada para o número diretamente nesse URL como um HTTP POST, e o cenário é executado.

O payload inclui o remetente, o corpo da mensagem ou uma referência para multimédia, um carimbo de data e hora e o id da mensagem. A partir daí, é um cenário normal: encaminhe pelo conteúdo, procure o cliente e chame os restantes serviços que utilizar.

Como isto é Coexistence, a mesma mensagem também aparece na aplicação WhatsApp Business do telemóvel. Uma pessoa pode responder-lhe, o cenário vê o que foi enviado e nenhum dos dois acaba por responder por cima do outro.

### Porque é que o Make não pode usar o conector MCP?

Porque o Make é um servidor MCP, não um cliente MCP. Expõe os seus próprios cenários a assistentes como Claude e ChatGPT, que se ligam ao Make. Não se liga ao servidor MCP de outra entidade.

Essa direção explica tudo. O nosso conector é um servidor à espera de ser chamado, e o Make não tem nada que faça chamadas para um servidor, por isso os dois nunca se encontram. Isto é diferente do n8n, que tem um nó MCP Client Tool e pode consumir um servidor remoto através de OAuth.

Na prática, não tem custo. O caminho do webhook faz tudo o que um cenário precisa e é o caminho que reage às mensagens recebidas, algo que o MCP não consegue fazer em nenhuma ferramenta.

### Como é que um cenário envia uma resposta?

Com um módulo HTTP para a Cloud API, usando o phone number id e o access token do número. Ambos podem ser consultados no painel ou através do conector MCP, se preferir que um assistente os obtenha por si.

O que deve enviar depende do momento. Nas 24 horas seguintes à última mensagem do cliente, o texto livre funciona. Depois disso, só será entregue um template aprovado pela Meta, e um cenário que envie apenas texto livre deixará de responder no primeiro caso ocorrido durante a noite.

A estrutura mais robusta é um encaminhador: verifique há quanto tempo chegou a última mensagem recebida e siga o ramo de texto livre ou o ramo de template, conforme o caso.

- Deixar o webhook apontado para um URL do Make de um cenário que está desligado. A Meta entrega-lhe a mensagem, mas nada é executado.
- Não responder ao pedido de verificação da Meta. A Meta envia um GET com um desafio antes de entregar qualquer mensagem.
- Responder com texto livre fora da janela de 24 horas. Falha e, do ponto de vista do cenário, parece que nada aconteceu.

**O Make pode ligar-se ao vosso servidor MCP?** Não. O Make é um servidor MCP, não um cliente, por isso não consegue chamar o nosso servidor. O caminho do webhook cobre tudo o que um cenário precisa.

**Preciso de uma aplicação Make para o WhatsApp?** Não. Um webhook personalizado recebe e um módulo HTTP envia. A integração consiste num URL e numa chamada REST.

**A equipa pode continuar a responder pelo telemóvel?** Sim. É isso que Coexistence significa. A aplicação continua a funcionar com o mesmo número e o cenário vê o que a pessoa enviou.

**Um cenário pode servir vários clientes?** Sim. Aponte cada número para o mesmo webhook e encaminhe pelo phone number id recebido no payload.

---

## Ligue o WhatsApp ao Zapier através da Cloud API oficial

https://easycoexistence.com/pt-pt/integrations/zapier

Defina o destino webhook do número como um catch hook do Zapier e cada mensagem recebida aciona um Zap. As respostas regressam através da Cloud API com uma ação webhook. O Zapier não pode consumir o nosso servidor MCP, porque é um servidor MCP e não um cliente.

### Como é que uma mensagem recebida aciona um Zap?

Comece um Zap com o acionador Webhooks by Zapier, escolha Catch Hook e copie o URL gerado pelo Zapier. Defina esse URL como destino webhook do número e a Meta entrega-lhe diretamente todas as mensagens recebidas.

O payload inclui o remetente, o conteúdo da mensagem, um carimbo de data e hora e o id da mensagem, que é tudo o que a maioria dos Zaps usa para criar ramificações. Nada é executado na sua infraestrutura e não existe uma aplicação do Zapier para manter, porque a integração assenta num URL.

A aplicação WhatsApp Business continua a funcionar no mesmo número durante todo o processo, por isso uma pessoa pode assumir qualquer conversa que o Zap não trate.

### Porque é que o Zapier não usa o conector MCP?

Porque o Zapier executa um servidor MCP e não um cliente MCP. Assistentes como o Claude e o ChatGPT ligam-se ao Zapier para usar as respetivas ações. O Zapier não se liga a um servidor MCP de terceiros, por isso não consegue aceder ao nosso.

Na prática, o efeito é nulo. O MCP serve para um assistente agir quando uma pessoa pede, enquanto um Zap tem a estrutura oposta: algo acontece e a automação responde. Isso é território dos webhooks em qualquer ferramenta, incluindo as que têm clientes MCP.

Se também quiser incluir um assistente, o conector funciona no Claude ou no ChatGPT em conjunto com o Zap, e não dentro dele.

### Como é que um Zap envia uma resposta?

Com uma ação POST de Webhooks by Zapier contra a Cloud API, usando o phone number id e o access token do número a partir do painel.

O momento determina o que pode ser enviado. Nas 24 horas seguintes à última mensagem do cliente, o texto livre é entregue. Depois disso, só é aceite um template aprovado, e é aqui que a maioria dos Zaps falha em produção, porque os testes acontecem sempre poucos segundos depois de uma mensagem.

Um Zap que trate os dois casos precisa de um filtro de caminho baseado no tempo decorrido desde a chegada da última mensagem recebida. É um passo adicional e faz a diferença entre uma automação que funciona na terça-feira à tarde e outra que funciona às três da manhã.

- Usar um URL de teste do Zapier como destino. Deixa de escutar e as mensagens não são entregues a lado nenhum.
- Esquecer o GET de verificação da Meta. O catch hook tem de devolver o desafio antes de começar a entrega.
- Enviar texto livre fora da janela de 24 horas, o que falha silenciosamente do ponto de vista do Zap.

**Existe uma aplicação oficial do WhatsApp para o Zapier?** Não é necessária neste caso. Um catch hook recebe e uma ação webhook envia, mantendo a ligação à Cloud API oficial sem intermediário.

**O Zapier pode usar o vosso servidor MCP?** Não. O Zapier é um servidor MCP e não funciona como cliente, por isso não consegue ligar-se ao nosso.

**A minha equipa perde o telemóvel?** Não. A Coexistência mantém a aplicação WhatsApp Business a funcionar no mesmo número.

**O que acontece se o meu Zap estiver pausado?** A Meta tenta novamente durante algum tempo e depois para. As mensagens continuam a chegar à aplicação no telemóvel, por isso a empresa não perde nada.

---

## Ligue o WhatsApp ao ChatGPT com um conector personalizado

https://easycoexistence.com/pt-pt/integrations/chatgpt

Ative o modo de programador nas definições do ChatGPT, adicione o EasyCoexistence como conector e o ChatGPT poderá listar os seus números, verificar o estado, enviar mensagens e templates e encaminhar webhooks para os seus sistemas, tudo através da Cloud API oficial da Meta.

### Como o adiciono ao ChatGPT?

Abra as Definições, aceda a Conectores, depois a Avançadas e ative o modo de programador. É isso que disponibiliza a opção de adicionar um conector por URL, em vez de o escolher na lista integrada.

Adicione um conector que aponte para o endpoint MCP do EasyCoexistence. Na primeira vez que o ChatGPT chamar uma ferramenta, abrirá uma sessão de início de sessão, onde poderá autorizar o acesso. Nada é gerado, copiado ou colado, porque o conector utiliza OAuth em vez de uma chave de API.

O próprio servidor é remoto. Nada é instalado, nada é executado em segundo plano no seu computador e fechar o ChatGPT não afeta de forma alguma um número ligado.

### O que pode fazer o ChatGPT depois de estar ligado?

Faça perguntas em linguagem natural e o ChatGPT escolherá a ferramenta. Qual dos meus números não está saudável? Envie a este cliente a confirmação da reserva. Crie um template para atualizações de encomendas e avise-me quando a Meta o aprovar. Aponte o webhook deste número para o meu servidor.

As ferramentas de leitura permitem listar números, verificar a classificação de qualidade, o nível de mensagens e o estado da ligação, além de obter as credenciais quando outro sistema precisar delas. As ferramentas de envio abrangem texto livre dentro da janela da sessão e templates aprovados fora dela.

Uma das dezasseis ferramentas disponibiliza a nossa documentação ao ChatGPT em markdown, razão pela qual responde às perguntas sobre o funcionamento de tudo isto com base na nossa documentação, e não num palpite.

### O que não pode fazer?

Responder a uma mensagem recebida. É importante esclarecer isto, porque é o que a maioria das pessoas presume que um assistente fará.

O MCP funciona através de pedidos e respostas. O ChatGPT chama uma ferramenta quando lhe pede. Não existe nenhum mecanismo que permita a uma mensagem de WhatsApp de um cliente acordar o ChatGPT e fazê-lo responder sozinho às três da manhã. Nada no nosso conector altera isso, e nenhum servidor MCP de qualquer produto o faz.

As respostas automáticas seguem o caminho do webhook: a Meta entrega as mensagens recebidas a um sistema que gere, e esse sistema decide o que fazer. Os dois funcionam em conjunto e o conector pode até definir o destino do webhook por si.

- Esperar que responda automaticamente aos clientes. O MCP atua quando lhe é pedido; as mensagens recebidas precisam de um webhook.
- Procurar o EasyCoexistence na lista integrada de conectores. É adicionado por URL com o modo de programador ativo.
- Presumir que é necessária uma chave. O conector autoriza através de OAuth e não há nada para colar.

**Preciso de um plano ChatGPT pago?** Os conectores personalizados estão disponíveis através do modo de programador nas definições. A disponibilidade segue as regras dos planos da OpenAI, e não algo que controlemos.

**O ChatGPT vê as conversas dos meus clientes?** Apenas aquilo que solicitar. As mensagens recebidas são encaminhadas da Meta para o destino do webhook que indicar, e nunca armazenamos o conteúdo das conversas.

**Pode ligar um número novo?** Pode iniciar o processo. O conector devolve uma ligação que o proprietário da empresa abre para autorizar o seu próprio número através do fluxo da Meta.

**Funciona com a mesma conta que o Claude?** Sim. Uma conta EasyCoexistence, um endpoint e todos os assistentes que ligar veem os mesmos números.

---

## Ligar o WhatsApp ao Cursor através de MCP

https://easycoexistence.com/pt-pt/integrations/cursor

Adicione a EasyCoexistence à configuração MCP do Cursor e o editor poderá aceder a um número WhatsApp real sem sair do projeto: listar números, verificar o estado, enviar mensagens e templates aprovados e definir destinos de webhook para o que estiver a criar, tudo através da Cloud API oficial da Meta.

### Como o adiciona ao Cursor?

Abra as definições e procure a secção MCP. Depois, adicione um servidor que aponte para o endpoint da EasyCoexistence. O Cursor também lê um ficheiro mcp.json, uma opção melhor se estiver a configurar várias máquinas ou quiser manter a configuração no controlo de versões.

Depois de voltar a carregar, peça ao Cursor para listar os seus números. Na primeira vez, inicia sessão e, a partir daí, as ferramentas ficam disponíveis. Não é necessário instalar nenhum pacote nem gerar uma chave.

O servidor é remoto, por isso nada é executado junto ao editor e fechar o Cursor não afeta um número ligado.

### Porque haveria de querer o WhatsApp num editor?

Porque aquilo que está a criar costuma ser a própria integração, e sem isto o ciclo de feedback é lento.

Ligar um webhook, verificar se foi validado, enviar uma mensagem de teste para si próprio e consultar o estado de aprovação de um template: cada tarefa implica mudar para um painel e voltar. Com o conector, são perguntas feitas no local onde o código já está.

É também a forma mais rápida de configurar o número de um cliente enquanto trabalha no projeto dele. get_connect_link devolve a ligação que o cliente abre e set_webhook_destination aponta o número para o que está a criar, sem ninguém abrir um separador que não seja a janela da Meta.

- Esperar que receba mensagens. O MCP atua quando solicitado; o tráfego recebido precisa de um destino de webhook.
- Colocar um token na configuração. O conector usa OAuth e não precisa de nenhum segredo no ficheiro.
- Enviar texto livre para um contacto que não escreve há um dia. Fora das 24 horas, só um template aprovado é entregue.

**É necessário instalar alguma coisa?** Não. É um servidor remoto através de HTTP com OAuth, por isso o Cursor liga-se a ele em vez de o executar.

**Posso manter a configuração no controlo de versões?** Sim, através de mcp.json. Não contém nenhum segredo, porque a autorização ocorre através de OAuth na primeira utilização.

**Também funciona no Claude Code?** Sim, com um comando. O endpoint é o mesmo para todos os clientes.

**Pode enviar para qualquer número?** Envia a partir dos números ligados à sua conta para qualquer destinatário WhatsApp, respeitando as regras habituais da janela e dos templates.

---

## Ligar o WhatsApp ao Claude Code através de MCP

https://easycoexistence.com/pt-pt/integrations/claude-code

Execute um comando claude mcp add e o Claude Code poderá aceder a um número WhatsApp real: listar números, verificar o estado, enviar mensagens e templates e definir destinos de webhook, tudo na Cloud API oficial da Meta, em vez de uma sessão de dispositivo ligado.

### Como se adiciona?

Execute claude mcp add com o transporte http e o endpoint da EasyCoexistence, em qualquer terminal. Depois, execute /mcp dentro do Claude Code e faça a autenticação. As dezasseis ferramentas ficam disponíveis em todas as sessões nessa máquina.

Não é instalado nada além da entrada de configuração. O servidor é remoto, por isso não há nenhum processo para manter ativo nem qualquer sessão guardada no disco.

A autorização usa OAuth, o que significa que nenhum token fica no histórico da shell, num ficheiro oculto ou num repositório. Isto é mais importante aqui do que numa aplicação de ambiente de trabalho, porque a configuração do terminal pode ser adicionada a um repositório por acidente.

### Para que serve na prática?

Trabalho de agentes que cruza o WhatsApp e uma base de código ao mesmo tempo, que corresponde à maior parte do que fazem os nossos utilizadores pagantes.

Um agente pode integrar o número de um cliente com get_connect_link, apontá-lo para o serviço que está a criar com set_webhook_destination, enviar uma mensagem de teste e verificar se o webhook foi validado. É um ciclo que, de outra forma, envolve um painel, um telemóvel e muita espera.

É também assim que a documentação chega ao modelo. get_docs devolve a documentação do nosso produto em markdown, para que um agente que responda a perguntas sobre as regras de Coexistência, a janela de 24 horas ou a condição de 14 dias responda com base na nossa documentação, e não apenas no que recorda.

- Esperar que as mensagens recebidas cheguem ao agente. O MCP funciona por pedidos e respostas; a entrega requer um webhook.
- Adicioná-lo por projeto. A configuração é feita por máquina e fica disponível em todas as sessões.
- Enviar texto livre fora da janela num script. Verifique a hora da última mensagem recebida e escolha um template.

**Também funciona no Codex?** Qualquer sistema que comunique por MCP através de HTTP com OAuth pode usar o mesmo endpoint.

**É guardado algum token no disco?** Não. A autorização usa OAuth, por isso não há nenhum segredo no ficheiro de configuração.

**Um agente pode ligar um número sozinho?** Pode iniciar o processo. A ligação que devolve tem de ser aberta pelo responsável da empresa, porque o fluxo da Meta requer um navegador e o telemóvel.

**Fechar o terminal desliga alguma coisa?** Não. O servidor é remoto e o número continua ligado, independentemente do que esteja a correr localmente.

---

## Webhooks do WhatsApp: encaminhe mensagens diretamente para o seu servidor

https://easycoexistence.com/pt-pt/whatsapp-webhook

Um webhook do WhatsApp é um endpoint HTTPS que indica, e a Meta publica nele eventos como mensagens recebidas, estados de entrega, alterações de qualidade e atualizações da conta. Num número Coexistence, o destino pode ser o seu próprio servidor, para que as conversas nunca passem por um fornecedor.

### O que envia realmente a Meta para um webhook?

Eventos organizados por categorias, cuja distinção determina a sua arquitetura.

O percurso das mensagens transporta o que os clientes enviam e, num número Coexistence, cópias do que a sua equipa envia na aplicação WhatsApp Business. Esses campos são messages e smb_message_echoes, os únicos que contêm conteúdo das conversas.

O percurso operacional transporta tudo o resto: account_update quando muda o estado de uma ligação, phone_number_quality_update quando muda a qualidade ou o throughput, account_alerts, account_review_update, business_capability_update e phone_number_name_update. Estes eventos não contêm conteúdo das conversas e são a base da monitorização.

Um fornecedor que se coloca no percurso das mensagens recebe o primeiro grupo. Um que não o faça, não o recebe.

### Como verifica a Meta um endpoint?

Com um pedido GET antes de entregar qualquer conteúdo. Falhar esta etapa é a razão mais comum para uma configuração aparentemente concluída nunca receber uma mensagem.

A Meta chama o seu URL com hub.mode definido como subscribe, o seu hub.verify_token e um valor hub.challenge. O seu endpoint tem de devolver esse challenge no corpo da resposta, sem o envolver em JSON nem acrescentar nada. Se não o fizer, a Meta nunca começa a entregar eventos e nenhum painel o indicará.

O endpoint também tem de usar HTTPS. Um endpoint que devolve um 404 silencioso, ou que está atrás de uma camada de autenticação que rejeita a Meta, parece funcionar até a primeira mensagem nunca chegar.

### O destino pode apontar para o seu próprio servidor?

Sim, e é aqui que os fornecedores diferem.

A Meta permite a uma aplicação substituir o destino dos webhooks de uma determinada WhatsApp Business Account. Definimos esse override para o seu URL, transferindo para si os eventos do percurso das mensagens que iriam para o nosso callback. Mantemos os eventos operacionais, porque o painel e os alertas são construídos a partir deles.

A consequência é arquitetural, não uma política que publiquemos. O conteúdo das conversas não tem onde ser armazenado do nosso lado, porque nunca nos é entregue. Uma conta sem override usa o nosso callback predefinido, onde o handler elimina esses eventos sem os guardar.

### O que acontece ao destino quando um número volta a ligar-se?

É removido, uma falha para a qual quase ninguém se prepara.

O destino não é uma propriedade do número de telefone. É um override na subscrição da nossa aplicação à WhatsApp Business Account. Quando uma ligação é removida, pela regra de catorze dias de inatividade da Meta ou por outro motivo, a aplicação é desinstalada dessa conta e o override desaparece com ela.

Voltar a ligar restaura o envio e a monitorização. Não restaura a entrega para o seu servidor e nada comunica um erro, pelo que o primeiro sinal pode ser um cliente dizer que ninguém respondeu. Voltamos a aplicar o override em cada reconexão, porque isto aconteceu com um número real que voltou a ligar-se sem problemas e ficou silencioso.

- Devolver JSON no GET de verificação. A Meta quer o valor bruto de hub.challenge e mais nada.
- Usar um URL temporário ou de teste. A Meta continua a entregar-lhe eventos depois de a ferramenta que o gerou deixar de escutar.
- Partir do princípio de que o destino sobrevive a uma reconexão. Está associado a uma subscrição de aplicação e é desinstalado com ela.
- Colocar o endpoint atrás de uma autenticação que rejeita o pedido da Meta.

**As minhas mensagens passam pela EasyCoexistence?** Não. O override envia os eventos do percurso das mensagens diretamente da Meta para o seu endpoint. Os eventos de uma conta sem override usam o nosso callback e são eliminados sem serem guardados.

**Posso alterar o destino mais tarde?** Sim, a qualquer momento, no painel ou através do conector MCP. Passar null repõe o destino predefinido.

**O que acontece se o meu servidor estiver indisponível quando a Meta entregar os eventos?** A Meta tenta novamente durante algum tempo e depois para. As mensagens continuam a chegar à aplicação WhatsApp Business no telemóvel, pelo que a empresa não perde nada, mesmo quando a integração falha.

**Um webhook chega para vários números?** Sim. Aponte todos os números para o mesmo endpoint e ramifique pelo phone number id que recebe no payload.

---

## Enviar e receber WhatsApp a partir de Python

https://easycoexistence.com/pt-pt/integrations/python

Receber consiste numa rota da sua framework web que responde ao GET de verificação da Meta e aceita POSTs. Enviar consiste num pedido HTTPS à Cloud API com o phone number id e o token do número. Não há SDK nosso nem nada para instalar.

### Como se recebem mensagens em Python?

Com dois handlers numa só rota, na framework que já utiliza.

O handler GET responde à verificação da Meta. Lê hub.mode, hub.verify_token e hub.challenge da query string, compara o token com o seu e devolve o challenge no corpo bruto. Devolver JSON aqui é o erro mais comum e falha silenciosamente.

O handler POST recebe eventos. Devolva 200 rapidamente e faça o trabalho depois, porque a Meta trata uma resposta lenta como uma falha e volta a tentar, o que significa tratar a mesma mensagem duas vezes. Coloque-a numa fila ou entregue-a a uma tarefa em segundo plano, em vez de processar tudo diretamente.

As mensagens chegam com um ID de mensagem wamid. Vale a pena eliminar duplicados com base nele desde o início, pois as novas tentativas são normais, não excecionais.

### Como se enviam mensagens?

Um POST para o endpoint messages da Cloud API, usando o phone number id e um bearer token.

Ambos os valores vêm da ligação: o painel apresenta-os e get_api_credentials devolve-os se preferir que um assistente os obtenha. Nada neste pedido é específico da nossa plataforma, por isso qualquer biblioteca HTTP funciona e o pedido é exatamente igual ao da documentação da Meta.

O que muda com o tempo é o corpo. Nas 24 horas seguintes à última mensagem do cliente, envia-se um objeto text. Depois disso, envia-se um objeto template com o nome de um template aprovado e o respetivo idioma. Um cliente que conheça apenas o primeiro formato funciona perfeitamente nos testes e falha na primeira mensagem enviada durante a noite, devolvendo o erro 131047.

### O que precisa um handler de produção além disso?

Três coisas fáceis de ignorar e dispendiosas de acrescentar mais tarde.

Elimine duplicados com base no ID da mensagem, porque a Meta volta a tentar. Coloque um segredo aleatório e longo no URL do webhook e rejeite os pedidos que não o contenham, pois, caso contrário, qualquer pessoa que descubra um URL fácil de adivinhar poderá publicar nele. O cabeçalho da assinatura não é uma opção aqui: a Meta assina com o segredo da aplicação a que pertence a subscrição, que é a nossa e nunca é partilhada. E determine há quanto tempo o contacto escreveu pela última vez, para que o envio escolha text ou template sem decisão humana.

Nada disto exige uma framework ou biblioteca. É um conjunto, uma verificação e uma comparação. Implementá-los antes do primeiro cliente distingue uma integração que funciona discretamente de outra que envia alertas constantemente.

- Devolver JSON no GET de verificação em vez do valor bruto de challenge.
- Processar diretamente antes de devolver 200. A Meta repete respostas lentas e a mensagem é tratada duas vezes.
- Enviar texto livre sem verificar a janela. Devolve 131047 e parece que nada aconteceu.

**Existe um SDK de Python?** Não da nossa parte, e não precisa de um. A API é da Meta, está documentada pela Meta e pode ser acedida com qualquer biblioteca HTTP.

**Que framework devo utilizar?** Qualquer uma. O requisito é uma rota que responda a um GET e aceite um POST, algo que todas as frameworks web de Python fazem.

**Como evito tratar uma mensagem duas vezes?** Elimine duplicados com base no ID de mensagem wamid no payload. A Meta repete os pedidos por conceção, por isso este comportamento é esperado, não um caso extremo.

**A equipa pode continuar a utilizar o telemóvel?** Sim. A Coexistência mantém a aplicação WhatsApp Business a funcionar no mesmo número, e o seu handler recebe o que a equipa envia como um evento echo.

---

## Enviar e receber WhatsApp a partir de Node.js

https://easycoexistence.com/pt-pt/integrations/node

Receber consiste numa rota que responde ao GET de verificação da Meta e aceita POSTs. Enviar consiste numa chamada fetch à Cloud API com o phone number id e o token do número. Não existe um SDK nosso nem nada para instalar.

### Como recebe mensagens no Node?

Uma rota com dois métodos, em Express, Fastify, num route handler do Next ou num servidor simples.

O GET responde à verificação da Meta: leia hub.mode, hub.verify_token e hub.challenge da query, compare o token com o seu e devolva o challenge como texto simples. Devolvê-lo como JSON é o erro habitual e cria um endpoint que nunca recebe nada, embora pareça correcto.

O POST recebe eventos. Responda imediatamente com 200 e processe depois. A Meta repete tudo o que demora, e um handler que processa antes de responder verá a mesma mensagem mais de uma vez. Sobretudo em serverless, responder primeiro e colocar o trabalho numa fila impede que um arranque a frio gere um duplicado.

### Como envia?

Um fetch para o endpoint messages da Cloud API, usando o phone number id, com o token num cabeçalho bearer.

Nada é específico da nossa solução, por isso o pedido corresponde exactamente à documentação da Meta e não existe nenhum wrapper para aprender ou ao qual ficar preso. Ambos os valores estão no painel, e get_api_credentials devolve-os através do conector MCP quando um assistente está a configurar a integração.

O corpo depende do momento. Nas 24 horas seguintes à última mensagem recebida do cliente, envie um objecto de texto. Depois disso, envie um objecto template com um nome de template aprovado e o idioma. O código que só envia texto passa todos os testes e falha na primeira mensagem que chega durante a noite.

### O que muda em serverless?

Há duas coisas, ambas relacionadas com a função terminar antes de o trabalho estar concluído.

Responder com 200 e continuar a processar não funciona numa função que congela no momento em que responde. Use o mecanismo da sua plataforma que mantém o trabalho activo depois da resposta, ou coloque o payload numa fila e deixe outra função tratá-lo. A Meta só precisa da confirmação rapidamente, não precisa que o trabalho esteja concluído.

Os arranques a frio também tornam as respostas lentas mais prováveis, o que significa mais repetições e mais duplicados. Deduplicar pelo ID de mensagem wamid não é opcional neste modelo, é o que o torna fiável.

- Devolver o challenge como JSON em vez de no corpo bruto.
- Fazer o trabalho antes de responder com 200. Em serverless, a função pode congelar no momento em que responde.
- Ignorar a deduplicação. A Meta repete por definição e os duplicados são normais, não uma situação excepcional.

**Preciso de uma biblioteca?** Não. Uma rota e um fetch são suficientes, e a chamada corresponde exactamente à documentação da Meta.

**Funciona na Vercel ou no Lambda?** Sim, com a habitual ressalva de serverless: confirme primeiro e processe depois através de uma fila ou mecanismo em segundo plano, em vez de o fazer inline.

**Como verifico que o pedido veio da Meta?** Coloque um segredo aleatório e longo no URL do webhook e rejeite qualquer pedido que não o contenha. A Meta assina com o segredo da aplicação a que pertence a subscrição, que neste caso é a nossa e nunca é partilhada, pelo que o cabeçalho da assinatura não pode ser verificado do seu lado.

**Posso usar TypeScript?** Sim. Não há nada para tipar da nossa parte, porque o payload é da Meta e está documentado por ela.

---

## EasyCoexistence vs uma caixa de entrada BSP

https://easycoexistence.com/pt-pt/compare/coexistence-vs-bsp

Um BSP vende uma plataforma: uma caixa de entrada partilhada onde a sua equipa trabalha, com as mensagens armazenadas nos respetivos servidores. A Coexistence mantém a app WhatsApp Business no telemóvel e encaminha as mensagens para onde indicar. A escolha é entre um produto onde trabalhar e uma ligação sobre a qual construir.

### O que oferece realmente um BSP?

Um produto, e isso não é uma crítica.

Um Business Solution Provider vende normalmente uma caixa de entrada partilhada: os agentes iniciam sessão, as conversas são atribuídas, existem respostas predefinidas, etiquetas, relatórios e uma aplicação móvel. Para uma equipa de apoio com oito pessoas que precisa de dividir o trabalho e saber quem respondeu a quê, essa é genuinamente a compra certa, e seria pouco sensato construí-la de raiz.

A consequência arquitetural é que as mensagens passam pela plataforma do BSP e ficam armazenadas nela, porque uma caixa de entrada partilhada não pode existir de outra forma. Precisa do histórico para o apresentar. Isso é inerente ao produto, não uma escolha feita por determinado fornecedor.

### Quando é a Coexistence a opção mais adequada?

Quando o número pertence a uma empresa que já tem uma forma de trabalhar e ninguém quer mudá-la.

Uma pequena equipa que responde a partir de um telemóvel não precisa de atribuir conversas. Precisa de recuperar as noites, o que implica ter algo automático a tratar confirmações e primeiras respostas enquanto o telemóvel continua a funcionar exatamente como antes. Mudá-la para uma caixa de entrada resolve um problema que não tem e cria outro que não pediu.

Uma agência tem a mesma situação por uma razão diferente. Os clientes não vão migrar o número nem voltar a formar a equipa, e muitas vezes não aceitam de todo que as suas conversas fiquem numa plataforma de terceiros. A Coexistence é a única via oficial que não lhes pede nada.

### Qual é a opção certa se estiver a criar o software?

A Coexistence, quase sempre, e a razão é estrutural, não tem que ver com funcionalidades.

Se está a criar o sistema que trata das conversas, uma caixa de entrada BSP é concorrente daquilo que está a construir e uma camada entre a sua equipa e a Meta. Acaba por integrar com a abstração do BSP, em vez da Cloud API, ficando sujeito aos limites de taxa, ao formato do webhook, ao calendário de lançamentos e aos preços do BSP, além dos da Meta.

Com a Coexistence, o webhook vai para o seu endpoint e as chamadas à API são as da Meta, documentadas pela Meta. A integração não depende de um fornecedor específico, o que também torna possível sair.

- Escolher pelo preço. São produtos diferentes, e o mais barato não é uma versão mais pequena do outro.
- Colocar uma equipa de apoio com oito pessoas numa ligação simples, sem nada construído. Precisa de uma caixa de entrada e ficará insatisfeita sem ela.
- Partir do princípio de que um BSP consegue manter a app WhatsApp Business ativa. Alguns conseguem através da Coexistence, muitos não, e vale a pena perguntar diretamente.

**Posso usar ambos?** Na prática, sim, se um BSP oferecer suporte para Coexistence. A pergunta a fazer é onde fica armazenado o conteúdo das conversas, porque é isso que realmente difere.

**Um BSP é mais fiável?** Ambos funcionam na Cloud API da Meta, por isso a entrega é igual. O que muda é quantas entidades ficam entre a Meta e o seu sistema.

**Qual é mais barato?** Normalmente, uma tarifa fixa de ligação custa menos do que o preço de uma caixa de entrada por utilizador, mas são compras diferentes e comparar apenas os valores é enganador.

**O que acontece ao meu histórico se sair?** Com a Coexistence, o histórico nunca ficou connosco. Numa plataforma, fica lá, e retirá-lo implica uma exportação.

---

## EasyCoexistence versus construir por conta própria

https://easycoexistence.com/pt-pt/compare/build-it-yourself-vs-easycoexistence

Cada chamada à API feita por este produto está documentada pela Meta e disponível a qualquer pessoa com uma aplicação Meta. Construir a ligação demora um fim de semana. O que demora mais é tornar-se Tech Provider, e o que nunca termina é detetar quando uma ligação morre silenciosamente.

### O que teria realmente de construir?

Menos do que espera para a primeira versão e mais do que espera para uma versão robusta.

A primeira versão é uma aplicação Meta, Embedded Signup, um endpoint que responde ao handshake de verificação e uma chamada de envio. Isso é genuinamente um fim de semana para quem se sente à vontade com OAuth e webhooks, e as nossas páginas de documentação descrevem a maior parte.

A versão robusta é diferente. Trata pelo nome oito tipos de eventos webhook, distingue um token revogado de um número removido, consulta periodicamente a classificação de qualidade e o nível de mensagens porque nenhum dos dois chega como um evento fiável, volta a aplicar o override do webhook depois de uma reconexão o desinstalar e separa uma desligação por inatividade de catorze dias de um cliente que saiu de facto. Cada um destes casos foi aprendido quando algo deixou de funcionar.

### Qual é a parte que não pode ser encurtada?

Tornar-se o seu próprio Meta Tech Provider, que é a diferença entre ligar um número e ligar números de outras pessoas.

É gratuito, mas não é rápido. Precisa de um Business Manager verificado, de uma aplicação que passe a App Review e de vídeos gravados que demonstrem os fluxos. Até isso estar concluído, trabalha através da conta de fornecedor de outra pessoa, o que origina os limites de uma única ligação encontrados nas ferramentas prontas a usar.

Se está a ligar um número que é seu, nada disto se aplica e deve simplesmente construí-lo. Se está a ligar números de clientes, este é o verdadeiro projeto, medido em semanas de espera e não em dias de trabalho.

### Quanto custa realmente manter a monitorização?

É a parte sem data de conclusão, o que a torna diferente de todo o resto.

Uma ligação pode falhar silenciosamente. A aplicação WhatsApp Business continua a funcionar perante uma queda de qualidade, um token expirado, um override do webhook removido e uma desligação de catorze dias. Nada no telemóvel indica um problema e o primeiro sinal costuma ser um cliente a perguntar porque ninguém respondeu.

Detetar isso exige um processo de consulta agendado, um recetor de webhook, um local para guardar o estado, alertas e alguém que repare no alerta. Nada disto é difícil. Tudo tem de continuar a funcionar e a permanecer correto à medida que a Meta altera as coisas, como acontece. Essa é a compra honesta aqui, e não as chamadas à API.

- Fazer estimativas com base na primeira versão. Ligar um número demora um fim de semana; manter cinquenta ligados é outra coisa.
- Planear tornar-se Tech Provider com um prazo fixo. O tempo da App Review não está sob o seu controlo.
- Tratar a monitorização como uma fase posterior. As falhas que deteta são silenciosas, por isso a sua ausência não prova que não estejam a acontecer.

**Há alguma coisa proprietária aqui?** Não. Cada chamada é feita à Cloud API documentada da Meta. É deliberado: nada o prende e pode sair mantendo intacta a sua própria integração.

**Devo construí-lo se tiver um número?** Provavelmente, sim. Um número seu, ligado uma vez, é um projeto pequeno e permite aprender corretamente a plataforma.

**Quanto demora a obter o estatuto de Tech Provider?** É gratuito, mas envolve um Business Manager verificado e a App Review, incluindo vídeos gravados. A espera é a parte mais longa.

**O que perco ao construí-lo?** Nada de técnico. Fica responsável pela monitorização, que é a parte que nunca termina e que falha silenciosamente.

---

## Erro 368 do WhatsApp: conta restringida por política

https://easycoexistence.com/pt-pt/docs/whatsapp-error-368

O erro 368 significa que a Meta restringiu a WhatsApp Business Account após uma medida de aplicação de políticas. É uma decisão ao nível da conta, não um problema com o pedido, e o recurso é feito através da Meta, não de um fornecedor.

### O que significa realmente uma restrição?

Significa que a Meta tomou uma medida de aplicação de políticas contra a conta empresarial, normalmente após problemas repetidos com políticas e não devido a um único acontecimento.

As causas comuns incluem conteúdo de mensagens que viola a política comercial ou empresarial do WhatsApp, um padrão de destinatários que denuncia mensagens ou um dado de verificação da empresa que não é confirmado. O que têm em comum é dizerem respeito à conta, não a uma mensagem específica. Por isso, todos os envios falham, e não apenas alguns.

É importante distingui-la da limitação de qualidade, que restringe quanto uma conta saudável pode enviar. Uma restrição é uma decisão sobre se a conta deve continuar a operar, e não se resolve enviando menos.

### Como é resolvida?

Através da Meta, no Business Manager, e apenas pelos responsáveis pela conta.

O aviso de aplicação de políticas no Business Manager explica qual foi a política invocada e se está aberto um recurso. Existem recursos e, por vezes, são aceites, mas não há um prazo que alguém possa garantir nem uma via de escalamento através de um fornecedor. Ninguém que venda acesso à API tem visibilidade sobre uma decisão de aplicação de políticas ou capacidade para a influenciar.

Esta é uma das poucas situações em que a resposta honesta de qualquer fornecedor é que não pode ajudar com aquilo em que mais gostaria de receber ajuda. Pode indicar qual é a conta restringida e quando isso aconteceu, que é a função da linha cronológica da ligação.

- Pedir a um fornecedor que a remova. Uma decisão de aplicação de políticas pertence à Meta e mais ninguém consegue vê-la.
- Ligar o número noutro local. A restrição aplica-se à conta empresarial e acompanha-a.
- Confundi-la com a limitação de qualidade, que restringe o volume de uma conta saudável e não a própria conta.

**Posso transferir o número para outro fornecedor?** Não. A restrição aplica-se à WhatsApp Business Account, pelo que permanece onde quer que o número seja utilizado.

**Quanto tempo demoram os recursos?** A Meta não publica um valor e nenhum fornecedor tem visibilidade sobre o processo.

**Afeta a receção de mensagens?** A aplicação de políticas varia consoante o caso. O que é consistente é que o envio deixa de funcionar.

**O 131031 é o mesmo?** Está relacionado. Esse código acompanha uma restrição com uma discrepância nos dados de verificação, apontando para os dados empresariais e não para o comportamento de envio de mensagens.

---

## Erro 131031 do WhatsApp: conta restringida ou dados incompatíveis

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131031

O erro 131031 indica que a conta do WhatsApp Business está restringida, geralmente porque os dados de verificação da empresa não coincidem com os que a Meta tem registados, ou devido a um PIN de verificação em duas etapas. Resolve-se no Business Manager, não no código.

### Que tipo de incompatibilidade causa este erro?

Uma diferença entre os dados que a Meta tem sobre a empresa e os que foram fornecidos, algo que parece pequeno, mas não é.

A verificação da empresa associa uma entidade jurídica à conta: nome, morada, dados de registo e documentos comprovativos. Quando algo muda na empresa e não é atualizado junto da Meta, ou quando os dados enviados não coincidem com um registo consultado pela Meta, a conta pode ficar restringida até os dados serem reconciliados.

O PIN de verificação em duas etapas é a outra causa comum e é mais fácil de resolver. Está definido no número de telefone e é necessário para determinadas operações. Se tiver sido esquecido ou definido por alguém que já saiu da empresa, tem de ser reposto antes de qualquer outra operação funcionar.

### Onde se verifica realmente?

No Business Manager, na conta empresarial, e não no número de telefone.

O estado da verificação e qualquer aviso de aplicação de políticas encontram-se ambos aí e, em conjunto, normalmente indicam qual das duas causas se aplica. O painel de um fornecedor pode indicar que um número deixou de funcionar e quando isso aconteceu, mas não consegue consultar um registo de verificação, pelo que não pode dizer qual é o dado incorreto.

Se a causa for a verificação, deve atualizar os dados da empresa e voltar a submetê-los. Se a causa for o PIN, este é reposto nas definições do WhatsApp Manager desse número. Convém registá-lo num local que a empresa consiga consultar posteriormente.

- Tratá-lo como uma falha no código. O pedido estava bem formado e a conta foi recusada.
- Voltar a submeter a verificação com os mesmos dados que foram rejeitados.
- Assumir que o PIN é guardado por um fornecedor. Está definido no número, nas próprias definições da Meta.

**É o mesmo que 368?** Está relacionado, mas não é idêntico. 368 corresponde a uma ação de aplicação de políticas; este erro costuma apontar para dados de verificação da empresa ou para um PIN de verificação em duas etapas.

**Um fornecedor consegue ver o estado da minha verificação?** Não. Essa informação está na conta empresarial, no Business Manager, e não é disponibilizada aos fornecedores.

**Voltar a ligar resolve?** Não. A restrição aplica-se à conta, pelo que uma nova ligação fica sujeita à mesma condição.

**Como repor o PIN de verificação em duas etapas?** Nas definições do número de telefone, no WhatsApp Manager. Registe-o num local onde a empresa o possa consultar mais tarde.

---

## Erro 132015 do WhatsApp: template pausado por qualidade

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132015

O erro 132015 significa que este template foi pausado pela Meta porque a sua qualidade diminuiu, normalmente depois de os destinatários bloquearem ou denunciarem mensagens que o utilizaram. O número está em boas condições. Este template não pode enviar mensagens temporariamente.

### Porque é pausado um único template?

Porque a qualidade é medida tanto por template como por número, e um template problemático pode ser isolado sem penalizar todo o resto.

A Meta observa como os destinatários reagem às mensagens enviadas com cada template: bloqueios, denúncias e o nível de interação. Um template que provoca reações negativas de forma consistente é pausado, enquanto os outros do mesmo número continuam a funcionar. É uma resposta deliberadamente limitada e mais útil do que parece, porque indica exatamente qual é a mensagem problemática.

Os culpados mais comuns são conteúdo promocional num template de utilidade, uma mensagem que não deixa claro qual é a empresa que escreve ou um template enviado a pessoas que não o esperavam.

### O que deve fazer com um template pausado?

Edite-o em vez de o reenviar e interprete a pausa como informação sobre o conteúdo.

Um template pausado volta a poder ser enviado após algum tempo, mas enviar o mesmo conteúdo ao mesmo tipo de público provoca a mesma reação e uma segunda pausa. A Meta desativa permanentemente um template depois de pausas repetidas. Nessa altura, a única solução é criar um novo com conteúdo diferente, por isso vale a pena evitar a segunda pausa.

Editar normalmente significa tornar o objetivo evidente na primeira linha, indicar o nome da empresa e explicar com transparência porque é que a pessoa está a receber a mensagem. Também significa verificar a quem é enviada, porque um bom template enviado para uma lista desinteressada continua a produzir os mesmos sinais.

- Reenviar o mesmo template depois de terminar a pausa. Foi o conteúdo que a causou.
- Interpretar a situação como um problema do número. Os outros templates do mesmo número continuam a funcionar.
- Esperar por uma terceira pausa. Pausas repetidas desativam permanentemente o template.

**Os outros templates continuam a poder ser enviados?** Sim. A pausa aplica-se a este template, e os outros templates aprovados do número não são afetados.

**Quanto tempo dura uma pausa?** A Meta não publica uma duração fixa, e o período aumenta quando há pausas repetidas.

**Posso editar um template pausado?** Sim, e esse é precisamente o objetivo. Voltar a submetê-lo com conteúdo melhorado permite recuperar.

**O que é o 132016?** É a versão permanente. Após pausas repetidas, o template é desativado e tem de ser substituído por um novo.

---

## Erro 100 do WhatsApp: parâmetro inválido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-100

O erro 100 indica que o pedido continha um parâmetro que a Meta não aceita: não suportado, mal escrito ou com a estrutura errada para esse endpoint. É determinístico, pelo que o mesmo pedido falha sempre da mesma forma e repetir nunca ajuda.

### O que o produz

Algo no corpo do pedido ou na consulta que o endpoint não reconhece, e as causas são consistentemente previsíveis.

- Um nome de campo mal escrito ou com maiúsculas e minúsculas erradas.
- Um parâmetro que pertence a outro endpoint.
- Um valor do tipo errado, como um número enviado como texto quando é esperado um inteiro.
- Um objeto aninhado transformado numa estrutura plana ou um valor simples enviado onde deveria estar um objeto.

### Porque é inútil repetir

Porque nada mudou na plataforma entre as tentativas. Um pedido malformado continua malformado na segunda tentativa pela mesma razão que na primeira, e um ciclo de repetição em torno deste erro provoca limitação de taxa além do problema original, em vez de resultar num sucesso.

A resposta útil é registar o corpo do pedido juntamente com o erro e compará-lo campo a campo com a referência do endpoint. Em quase todos os casos, a diferença torna-se visível no espaço de um minuto.

- Repetir. O pedido é determinístico e falhará sempre da mesma forma.
- Assumir que é o número. Este erro nunca significa algo sobre a ligação.
- Interpretá-lo como uma falha genérica. Identifica especificamente um problema de parâmetro, e existem códigos mais específicos, 131008 e 131009, para valores em falta e fora do intervalo.

**Isto significa que o meu número está avariado?** Não. Este erro diz respeito apenas ao pedido, e o número não é afetado.

**Porque é tão vago?** É o código abrangente para problemas com parâmetros. A Meta tem códigos mais específicos para um parâmetro em falta e para um valor inválido.

**Um fornecedor pode causar isto?** Só ao construir o pedido. Numa integração direta, o pedido é da sua responsabilidade.

**Devo repetir com um intervalo progressivo?** Não. É determinístico, e repetir acrescenta limitação de taxa a um problema que não é transitório.

---

## Erro 131008 do WhatsApp: parâmetro obrigatório em falta

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131008

O erro 131008 indica que faltava um parâmetro obrigatório no pedido. É mais específico e útil que o erro 100, que abrange parâmetros geralmente malformados, porque este indica que o campo está ausente, e não incorreto.

### O que costuma faltar

Os campos que parecem opcionais, mas não são, razão pela qual os mesmos aparecem repetidamente.

- messaging_product, que tem de ser definido como whatsapp em cada envio.
- recipient_type nas estruturas de mensagem que o exigem.
- O objeto de idioma num envio de template, obrigatório mesmo quando existe apenas um.
- components num template que define variáveis, em que uma lista vazia não equivale à sua omissão.

### Porque são boas notícias

Porque é a falha mais específica desta família. O erro 100 indica que há algum parâmetro incorreto; este indica que falta um parâmetro obrigatório, reduzindo a pesquisa à lista de campos obrigatórios do endpoint. A correção consiste em consultar a referência do endpoint chamado e comparar o pedido com o conjunto obrigatório. É um minuto de trabalho e é por isso que vale a pena distinguir este erro do 100 num registo, em vez de agrupar ambos como pedido inválido.

- Tratá-lo como o erro 100. Este identifica uma ausência, sendo mais específico.
- Enviar uma matriz components vazia como se fosse uma omissão. Para a API, são situações diferentes.
- Omitir messaging_product. É obrigatório em cada envio e a causa isolada mais comum.

**Qual é o parâmetro em falta?** A resposta indica-o. Quando não indica, a referência do endpoint apresenta o conjunto obrigatório.

**messaging_product é mesmo obrigatório?** Sim, em cada envio, definido como whatsapp. É a omissão mais comum.

**É o mesmo que 100?** Não. O 100 abrange um parâmetro presente mas incorreto; este abrange um parâmetro ausente.

**Voltar a tentar pode ajudar?** Não. O pedido é determinístico e falhará da mesma forma até o campo ser acrescentado.

---

## Erro 131009 do WhatsApp: valor de parâmetro inválido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131009

O erro 131009 indica que um ou mais valores de parâmetros são inválidos: o campo estava presente e foi compreendido, mas o seu conteúdo não é aceite pelo endpoint. Códigos de idioma, formatação de números de telefone e valores enum explicam a maioria dos casos.

### Os valores que falham com mais frequência

Três formatos causam a maioria dos casos, e os três parecem correctos a quem os lê.

- Códigos de idioma: en quando o template foi criado como en_US, ou pt quando é pt_BR.
- Números de telefone com pontuação, zeros à esquerda ou sinal de mais, quando são esperados apenas dígitos em formato internacional.
- Valores enum com maiúsculas ou minúsculas incorrectas, como uma categoria de template em minúsculas.
- Datas ou marcas temporais num formato diferente do documentado pelo endpoint.

### Porque vale a pena destacar o caso do idioma

Porque produz dois erros diferentes, consoante o endpoint, e leva muitas pessoas a procurar a causa errada.

O envio de um template com um idioma que não existe para esse nome devolve 132001, que indica que o template está em falta. O envio de um idioma malformado para um endpoint que o valida primeiro devolve este erro. Ambos resultam do mesmo erro subjacente, e a solução é ler a lista de templates e copiar a string exacta do idioma, em vez de presumir o seu formato.

- Assumir que en e en_US são intercambiáveis. Identificam templates diferentes.
- Enviar um número de telefone com sinal de mais ou pontuação. Use apenas dígitos, em formato internacional.
- Repetir o pedido. O valor está determinadamente errado.

**Que valor está errado?** A resposta costuma indicar o parâmetro. Quando não o faz, comece por verificar o idioma e o formato do telefone.

**Como deve ser formatado um número de telefone?** Em formato internacional, apenas com dígitos, sem sinal de mais nem pontuação.

**Porque é que o mesmo erro por vezes devolve 132001?** Porque o envio de um template resolve o nome e o idioma em conjunto, pelo que um par desconhecido é interpretado como um template em falta.

**Isto é um problema com o meu número?** Não. Este erro diz respeito apenas ao pedido.

---

## Erro 131051 do WhatsApp: tipo de mensagem não suportado

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131051

O erro 131051 indica que o tipo de mensagem que está a ser enviado não é suportado. Por vezes, trata-se de um valor de tipo malformado, mas num número com Coexistência significa geralmente que o tipo não é permitido pela plataforma nesse tipo de ligação.

### Duas causas diferentes

A primeira é normal: um valor de tipo escrito incorretamente ou que não está definido pela API. Consultar a referência do endpoint resolve a questão num minuto.

A segunda é estrutural e apanha muitas pessoas de surpresa, porque o código é idêntico. Um número com Coexistência não pode fazer tudo o que um número normal da Cloud API pode fazer, e tentar executar uma dessas ações devolve este erro, em vez de uma mensagem mais clara. As mensagens temporárias, os conteúdos de visualização única, a localização em direto e as listas de transmissão estão desativados num número ligado, e as conversas de grupo estão totalmente fora da API.

### Como saber qual das causas se aplica

Depende do que estava a tentar enviar.

- Um tipo definido pela API que já enviou antes: trata-se de um erro de formatação, por isso compare o payload.
- Qualquer conteúdo dirigido a um grupo: é uma limitação estrutural e nenhum fornecedor pode ativá-lo.
- Localização em direto, visualização única ou uma mensagem temporária: é uma limitação estrutural num número com Coexistência.
- Um tipo novo que nunca enviou: verifique se está disponível na sua conta e na sua região.

- Criar um fluxo baseado em conversas de grupo. Estão excluídas da API em todos os fornecedores.
- Partir do princípio de que um fornecedor pode ativar um tipo desativado. Estas limitações são da plataforma.
- Voltar a tentar. Nenhuma das causas é temporária.

**Posso enviar mensagens para um grupo?** Não. As conversas de grupo estão fora da API num número com Coexistência, independentemente do fornecedor.

**Porque é que a localização em direto não é suportada?** É uma das funcionalidades desativadas num número quando a Coexistência está ativa.

**É possível corrigir isto?** Se a causa for um tipo malformado, sim. Se for uma limitação da plataforma, não.

**Afeta a receção?** Não. Este erro diz respeito ao envio de um tipo que não é permitido.

---

## Erro 131052 do WhatsApp: falha ao transferir multimédia

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131052

O erro 131052 significa que a Meta não conseguiu transferir o conteúdo multimédia anexado a uma mensagem. Diz respeito ao próprio conteúdo, não ao seu pedido, por isso a resposta prática é pedir que seja enviado de outra forma, em vez de alterar o código.

### Porque acontece

Porque o conteúdo multimédia recebido é obtido separadamente, em vez de ser entregue com a mensagem. A mensagem transporta um ID multimédia, e os bytes são obtidos à parte através desse ID.

Essa obtenção pode falhar por motivos do lado do remetente: um carregamento que não foi concluído, um ficheiro que expirou antes de ser obtido ou um formato que não foi preservado pelo processo que o produziu. Nada disso é visível do seu lado, e nada é resolvido alterando o seu pedido.

### O que fazer

Trate-o como uma mensagem recebida sem o respetivo anexo e processe-a como qualquer outro dado incompleto.

- Registe a mensagem e marque o conteúdo multimédia como indisponível, em vez de eliminar todo o evento.
- Obtenha o conteúdo multimédia rapidamente: os IDs não permanecem válidos para sempre.
- Quando houver uma pessoa envolvida, peça ao cliente que o envie novamente, o que resolve a maioria dos casos.
- Não volte a tentar indefinidamente. Se a primeira obtenção e uma nova tentativa falharem, o conteúdo multimédia não virá.

- Eliminar toda a mensagem. O texto e o contexto continuam a ser úteis sem o anexo.
- Obter o conteúdo multimédia muito depois da receção. Os IDs expiram.
- Voltar a tentar num ciclo. Uma obtenção falhada raramente resulta mais tarde.

**A mensagem perdeu-se?** Não. A mensagem chega; o que falhou foi obter o respetivo anexo.

**Devo pedir ao cliente que o envie novamente?** Quando houver uma pessoa envolvida, sim. Isso resolve rapidamente a maioria dos casos.

**Durante quanto tempo é válido um ID multimédia?** Não é válido indefinidamente, por isso é importante obtê-lo rapidamente.

**O 131053 é igual?** Não. Esse código indica uma falha ao carregar multimédia que está a enviar.

---

## Códigos de erro da WhatsApp Cloud API

https://easycoexistence.com/pt-pt/docs/whatsapp-error-codes

Esta é a lista de todos os códigos de erro da WhatsApp Cloud API que documentamos, numa tabela, com o significado de cada um e indicação sobre se vale a pena repetir o pedido. A maioria não vale: são determinísticos, pelo que o mesmo pedido falha da mesma forma e um ciclo de repetição transforma um pedido inválido num rate limit.

### Como ler a coluna de repetição

Tem três valores, e escolher mal entre eles é o erro mais dispendioso de toda esta referência.

Não significa que a falha seja determinística. O que falhou foi o pedido, o template ou o estado do destinatário, e enviar novamente o pedido idêntico produz o mesmo erro, consumindo entretanto throughput de que poderá precisar mais tarde. Sim significa que a falha ocorreu do lado da Meta e que um backoff resolve realmente o problema. Esperar significa que a condição é real, mas temporária: um limite ou bloqueio que desaparece por si; repetir antes disso não faz nada e pode prolongá-lo.

### Porque é que a maioria destes códigos não permite repetir

Porque a plataforma devolve códigos específicos, em vez de códigos genéricos. Um parâmetro malformado, um template inexistente, uma janela de mensagens fechada e um destinatário que deixou de aceitar mensagens são situações conhecidas no momento da resposta. Por isso, a Meta identifica-as em vez de falhar de forma vaga.

- Um problema no pedido não fica correto à segunda tentativa.
- Um problema no template está no próprio template, que o pedido não pode alterar.
- Um problema de janela ou de recusa diz respeito ao estado do destinatário, não ao seu.
- Uma restrição da conta é uma decisão, e repetir não é um recurso.

### O que registar quando um destes códigos surge

O suficiente para o diagnosticar sem o reproduzir, que é a diferença entre uma correção de cinco minutos e um dia de tentativas ao acaso.

- A resposta de erro completa, incluindo o trace id, que é o que o apoio da Meta pede.
- O corpo do pedido tal como foi enviado, não como pretendia enviá-lo. A diferença entre os dois é geralmente o erro.
- O phone number id, para distinguir um problema num número de um problema em toda a conta.
- O carimbo temporal, para verificar a falha face ao estado da ligação nesse momento.

### Os códigos que só existem no Coexistence

São dois e confundem porque parecem falhas de envio normais. 2593107 e 2593108 dizem respeito à sincronização do histórico de conversas, o passo que copia conversas recentes da aplicação WhatsApp Business quando um número é ligado pela primeira vez.

Não são erros de mensagens e não significam que a ligação tenha falhado. Uma sincronização que exceda o limite ou decorra fora da respetiva janela deixa o número ligado e a enviar normalmente, mas com menos histórico copiado do que o esperado. Interpretá-los como uma ligação avariada leva a desligar e recomeçar, o que perde ainda mais histórico em vez de o recuperar.

- Repetir por predefinição. A maioria destes códigos é determinística e um ciclo acrescenta um rate limit.
- Registar o erro sem o corpo do pedido. A diferença entre o que foi enviado e o que se pretendia enviar é geralmente o erro.
- Interpretar um erro de sincronização como uma ligação avariada. O número continua ligado e a enviar.
- Descartar o trace id, o único elemento que torna acionável um pedido de apoio.

**Que erros devo repetir?** 131016 e 131000, com backoff exponencial. 130429, 132015 e 133008 desaparecem por si se esperar. Todos os restantes são determinísticos.

**Um código de erro significa que o meu número está desligado?** Normalmente, não. A maioria diz respeito ao pedido, ao template ou ao destinatário. Os problemas de ligação surgem como webhooks de conta e de qualidade, não como erros de envio.

**O que é um trace id?** É um identificador na resposta de erro que permite ao apoio da Meta encontrar o pedido específico. Registe-o em todas as falhas; sem ele, um pedido de apoio não pode ser tratado.

**Estes códigos são iguais em todos os fornecedores?** Sim. Vêm da Cloud API da Meta, por isso são idênticos, independentemente do fornecedor que ligou o número. Um fornecedor só pode alterar a clareza com que chegam até si.

---

## Erro 131053 do WhatsApp: falha ao carregar multimédia

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131053

O erro 131053 indica que a Meta não conseguiu carregar o conteúdo multimédia do seu pedido. Ao contrário do código relacionado de entrada 131052, este diz respeito a um ficheiro sob o seu controlo, por isso é possível corrigi-lo: verifique o tamanho, o formato e, se estiver a enviar uma ligação, confirme se a Meta consegue realmente aceder-lhe.

### As três causas

Pela ordem em que ocorrem na prática.

- Tamanho: o ficheiro excede o limite do seu tipo. Imagens 5 MB, vídeo e áudio 16 MB, documentos 100 MB.
- Formato: um codec ou contentor que a API não aceita, algo comum em vídeo exportado de software de edição.
- Acessibilidade: enviar uma ligação em vez de um id carregado, quando o URL exige início de sessão, está protegido por uma firewall ou redireciona.
- Expiração: um media id carregado utilizado muito depois de ter sido criado.

### Carregar é mais fiável do que enviar ligações

Enviar uma ligação faz com que a Meta transfira o ficheiro no momento do envio, acrescentando uma possibilidade de falha que não consegue ver a partir da sua própria rede. Um URL que abre perfeitamente no seu navegador pode não estar acessível a partir da infraestrutura da Meta devido à geografia, a uma regra de firewall ou a um cookie de autenticação que o navegador já possui.

Carregar primeiro o ficheiro e enviar o media id devolvido elimina por completo esse tipo de falha. É um pedido adicional e torna o envio determinístico, o que compensa para tudo o que seja enviado em volume.

- Assumir que um URL que funciona no seu navegador também funciona para a Meta. A sua sessão e a sua rede não são as da Meta.
- Exportar vídeo sem verificar o codec. As predefinições do software de edição são frequentemente incompatíveis.
- Reutilizar um media id muito depois do carregamento. Os ids expiram.

**Quais são os limites de tamanho?** Imagens 5 MB, vídeo e áudio 16 MB, documentos 100 MB.

**Devo carregar o ficheiro ou enviar um URL?** Carregue-o. Isso elimina a acessibilidade como causa de falha.

**O URL funciona comigo, por que não funciona para a Meta?** A rede da Meta não é a sua. A geografia, as firewalls e a autenticação diferem.

**É o mesmo que 131052?** Não. Esse código indica uma falha ao transferir multimédia enviado por um cliente.

---

## Erro 131016 do WhatsApp: serviço indisponível

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131016

O erro 131016 indica que um serviço do lado da Meta está temporariamente indisponível. É um dos poucos erros da plataforma que são realmente transitórios, pelo que a resposta correta é repetir o pedido com espera exponencial, em vez de investigar.

### Porque é que este erro é diferente

A maioria dos erros nesta plataforma é determinística: o pedido está malformado, o template não existe ou a janela fechou. Repeti-los desperdiça um pedido e pode provocar limitação de taxa.

Este erro é a exceção. Não diz nada sobre o pedido nem sobre o seu número, apenas que um serviço gerido pela Meta não conseguiu responder naquele momento. O mesmo pedido, enviado um minuto depois, normalmente é aceite, que é precisamente a finalidade da espera progressiva.

### Como repetir corretamente

Com contenção, porque repetir em massa pode agravar uma interrupção.

- Espera exponencial: aguarde um segundo, depois dois, quatro e oito.
- Defina um limite de tentativas, normalmente cinco; depois disso, envie a mensagem para uma fila para processamento posterior.
- Use um intervalo aleatório, para que um conjunto de trabalhadores não repita os pedidos em simultâneo.
- Garanta a idempotência, para que uma mensagem enviada antes de o erro lhe chegar não seja enviada duas vezes.

- Repetir imediatamente num ciclo apertado. Isso acrescenta carga a um serviço que já está com dificuldades.
- Tratar o erro como um problema de ligação. O seu número está a funcionar.
- Repetir sem definir um limite. Algumas interrupções duram mais do que qualquer política de repetição deveria permitir.

**Devo repetir o pedido?** Sim, com espera exponencial. Este é um dos erros em que repetir o pedido funciona.

**O meu número foi afetado?** Não. Trata-se de uma falha do lado da plataforma.

**Quanto tempo duram estes erros?** Normalmente, de alguns segundos a alguns minutos. Uma espera com cinco tentativas abrange a maioria dos casos.

**Como distingo este erro de uma interrupção real?** Verificando se persiste. A monitorização contínua responde a isso sem adivinhações.

---

## Erro 131000 do WhatsApp: algo correu mal

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131000

O erro 131000 significa que uma mensagem falhou por uma razão que a Meta não classificou. É a categoria não classificada, por isso deve repetir uma vez, com um intervalo progressivo, e, se persistir, abrir um pedido de apoio com o trace id da resposta.

### O que abrange realmente

Qualquer falha no processo de envio da Meta que não tenha sido associada a um código específico. Inclui falhas transitórias reais, problemas internos e, por vezes, uma condição que já tem um código específico numa versão mais recente da API, mas não tinha na altura.

Como esta categoria é abrangente, não existe uma resposta única correcta. Uma ocorrência isolada pode ser ruído. O mesmo destinatário a falhar repetidamente com este erro é um padrão que justifica abrir um pedido de apoio.

### O que fazer

Pela ordem indicada, parando assim que uma tentativa funcionar.

- Repita uma vez, após um pequeno intervalo. Uma parte destas falhas é transitória.
- Registe a resposta completa, incluindo o trace id, que o apoio irá pedir.
- Verifique se é apenas um destinatário ou todos. Um destinatário aponta para esse número; todos apontam para a plataforma.
- Se persistir após novas tentativas, abra um pedido de apoio com o trace id e as marcas temporais.

- Repetir indefinidamente. Se duas tentativas falharem, a falha não é transitória.
- Eliminar o trace id. É o único elemento que torna um pedido de apoio accionável.
- Assumir que o seu número está avariado. Normalmente, não está.

**Devo repetir?** Uma vez, com um intervalo progressivo. Depois disso, a falha não é transitória.

**O que é um trace id?** Um identificador na resposta de erro que permite ao apoio da Meta localizar o pedido específico.

**Significa que o meu número está indisponível?** Normalmente, não. Verifique se os outros envios estão a ser concluídos.

**Quando devo abrir um pedido de apoio?** Quando se repetir após novas tentativas, indicando o trace id e as marcas temporais.

---

## Erro 131021 do WhatsApp: remetente e destinatário são iguais

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131021

O erro 131021 significa que o remetente e o destinatário são o mesmo número. O WhatsApp não permite que um número empresarial envie mensagens para si próprio, e a causa é quase sempre uma mensagem de teste dirigida ao número ligado, em vez de a um segundo telemóvel.

### Porque acontece

Porque a primeira coisa que qualquer pessoa faz depois de ligar um número é enviar uma mensagem de teste, e o único número que tem à sua frente é aquele que acabou de ligar. É um impulso compreensível, mas a plataforma recusa-o.

Não existe nenhuma definição que possa alterar. O envio de mensagens para si próprio funciona na aplicação WhatsApp para consumidores como funcionalidade de notas para si próprio, mas não existe através da API.

### Como testar corretamente

Com um segundo número e algum cuidado com a direção que está a testar.

- Use um telemóvel pessoal como destinatário de teste. Qualquer número do WhatsApp que não seja o número ligado funciona.
- Para testar o envio livremente, faça com que o número de teste envie primeiro uma mensagem para a empresa. Isso abre a janela de serviço de 24 horas.
- Para testar fora dessa janela, envie um template aprovado, que é a única opção permitida nesse período.
- Não registe um segundo número empresarial apenas para testar, a menos que precise dele: um número pessoal comum é suficiente.

- Enviar para o número ligado para testar. A plataforma recusa-o por definição.
- Assumir que as notas para si próprio funcionam através da API. Não funcionam.
- Testar uma mensagem de texto livre sem o cliente ter enviado primeiro uma mensagem, o que falha com 131047.

**Posso enviar mensagens para o meu próprio número?** Não. O WhatsApp não o permite através da API.

**Existe alguma definição para isto?** Não. É uma regra da plataforma.

**Com o que devo testar?** Com qualquer outro número do WhatsApp, incluindo um telemóvel pessoal.

**Porque é que o meu teste falhou depois com 131047?** Porque uma mensagem de texto livre exige que o cliente lhe tenha enviado uma mensagem nas últimas 24 horas.

---

## Erro 131045 do WhatsApp: número de telefone não registado

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131045

O erro 131045 indica que o número de telefone não foi registado para mensagens da Cloud API. Adicionar um número a uma WhatsApp Business Account e registá-lo para enviar são passos separados. Este erro significa que o segundo passo não aconteceu.

### Por que existem dois passos

Uma WhatsApp Business Account pode conter números que não estão a enviar nada. Adicionar um número comprova a posse; registá-lo ativa-o para mensagens da Cloud API e define o seu PIN de dois passos.

Numa configuração manual, estes são pedidos API separados, e é fácil concluir o primeiro e esquecer o segundo. O número aparece então na conta, parece correto no painel e recusa todos os envios com este erro.

### O que resolve o problema

Depende da forma como o número foi adicionado.

- Numa configuração manual, chame o endpoint register para o ID do número de telefone, usando o seu PIN de dois passos.
- Numa integração da Coexistence através de um fornecedor, o registo acontece dentro do fluxo. Este erro significa normalmente que o fluxo não terminou.
- Se o número foi migrado recentemente de outra conta, é necessário voltar a registá-lo na nova conta.
- Se o próprio registo falhar, a causa costuma ser o PIN, o que corresponde ao erro 133005.

- Assumir que um número visível no painel está pronto para enviar. Estar visível e estar registado são coisas diferentes.
- Abandonar o fluxo de integração a meio. São os últimos passos que fazem o registo.
- Confundir este erro com o 133006, que diz respeito à verificação, não ao registo.

**O que é o registo?** Ativar um número para mensagens da Cloud API, separadamente de o adicionar à conta.

**Tenho de o fazer sozinho?** Numa configuração manual, sim. Num fluxo de Coexistence, o processo é tratado automaticamente.

**É necessário repetir o registo?** Apenas depois de migrar o número para uma conta diferente.

**E se o registo falhar?** Normalmente, o problema está no PIN de dois passos, que devolve o erro 133005.

---

## Erro 133005 do WhatsApp: PIN de verificação em dois passos incorreto

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133005

O erro 133005 significa que o PIN de verificação em dois passos indicado durante o registo estava incorreto. É um PIN de seis dígitos definido quando o número foi registado pela primeira vez, e várias tentativas erradas bloqueiam novas tentativas, pelo que o caminho de recuperação importa mais do que voltar a tentar.

### De onde vem o PIN

É definido na primeira vez que o número é registado para mensagens com a Cloud API e volta a ser necessário em qualquer registo posterior, incluindo depois de migrar o número para outra conta.

É aqui que o problema começa. Um PIN definido uma só vez na configuração e que não é necessário durante um ano raramente fica anotado, e quem o definiu muitas vezes já saiu. O erro surge então no preciso momento em que o número está a ser movido ou registado de novo, que já é de si um momento de pressão.

### Se ninguém o sabe

Existe um caminho, que é mais lento do que adivinhar, mas que funciona de facto.

- Pare de adivinhar. Falhas repetidas devolvem 133008 e bloqueiam as tentativas durante um período.
- Altere o PIN no WhatsApp Manager, nas definições de verificação em dois passos do número; não existe nenhum endpoint da API para a desativar.
- Um administrador também pode definir um novo PIN através da API, com um POST para o ID do número de telefone, e voltar a registar o número com esse PIN.
- Depois de recuperado, guarde o novo PIN num local onde a pessoa seguinte o encontre.

### Como evitar o problema da próxima vez

Trate o PIN como infraestrutura e não como um detalhe pessoal. Deve ficar no mesmo local das credenciais da conta, à guarda da empresa e não de quem calhou executar a configuração, e deve sobreviver à saída dessa pessoa.

O custo de não o fazer não é o erro em si, que é trivial. É não conseguir migrar ou registar de novo um número em funcionamento no momento em que é necessário.

- Adivinhar repetidamente. Isso desencadeia o 133008 e um bloqueio.
- Guardar o PIN com uma só pessoa em vez de o guardar na empresa.
- Presumir que nunca mais é necessário depois da configuração. A migração exige-o.

**Onde foi definido este PIN?** Quando o número foi registado pela primeira vez para mensagens com a Cloud API.

**E se não o souber?** Altere-o no WhatsApp Manager, nas definições de verificação em dois passos do número, ou defina um novo através da API.

**O que acontece se continuar a adivinhar?** As tentativas ficam bloqueadas e passa a receber o erro 133008.

**Quando é necessário o PIN?** No registo e, de novo, em qualquer novo registo ou migração.

---

## Erro 133008 do WhatsApp: demasiadas tentativas de PIN

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133008

O erro 133008 indica que foram feitas demasiadas tentativas incorretas do PIN de verificação em duas etapas, bloqueando novas tentativas por algum tempo. Surge depois de erros 133005 repetidos, pelo que a resposta certa a um PIN incorreto é parar, em vez de tentar novamente.

### O que o desencadeia

Uma sequência curta de tentativas de PIN incorretas, fácil de atingir porque um PIN errado parece algo que vale a pena tentar duas vezes. Não vale. O primeiro 133005 é o sinal para encontrar o PIN corretamente, em vez de voltar a adivinhar.

Depois de bloqueado, o número não pode ser registado até o período terminar, mesmo que o PIN correto seja encontrado entretanto.

### O que fazer durante o bloqueio

Aguarde, em vez de tentar contornar o bloqueio.

- Pare de tentar. Novas tentativas podem prolongar o bloqueio, em vez de o encurtar.
- Encontre ou altere o PIN durante a espera: desative a verificação em duas etapas com um token ao nível da conta ou peça apoio à Meta.
- Confirme que está a registar o phone number id correto. Uma falha de PIN no número errado tem o mesmo aspeto.
- Planeie a nova tentativa para depois do período, em vez de o consultar repetidamente.

- Continuar a tentar durante o bloqueio. Isso não ajuda e pode prolongá-lo.
- Esperar sem aproveitar o tempo para alterar corretamente o PIN.
- Presumir que o número foi banido. Um bloqueio de PIN é temporário e não está relacionado com políticas.

**Quanto tempo dura o bloqueio?** Um período definido pela Meta. Novas tentativas durante esse período podem prolongá-lo, em vez de o encurtar.

**O meu número foi banido?** Não. Trata-se de um bloqueio de verificação, sem relação com a aplicação de políticas.

**Posso alterar o PIN durante o bloqueio?** Sim, e é a melhor forma de aproveitar o tempo de espera.

**Porque aconteceu isto?** Tentativas repetidas de PIN incorreto, tendo cada uma devolvido o código 133005.

---

## Erro 133006 do WhatsApp: número não verificado

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133006

O erro 133006 significa que o número de telefone tem de ser verificado antes de poder ser registado para mensagens. A verificação comprova o controlo do número através de um código enviado por SMS ou chamada de voz, sendo uma etapa separada tanto da adição do número como do seu registo.

### Verificação versus registo

A verificação comprova que a empresa controla o número. O registo ativa-o para mensagens através da Cloud API. Ocorrem por esta ordem, e este erro significa que a primeira etapa ainda não foi concluída.

Na prática, alguém tem de conseguir receber um código nesse número, por SMS ou através de uma chamada de voz automática. Um número que ninguém consegue atender não pode ser verificado. Na maioria dos casos, esse é o verdadeiro bloqueio, e não o pedido à API.

### O que bloqueia a verificação

Quase sempre, algo físico e não técnico.

- Ninguém tem o telemóvel ou o cartão SIM, algo comum com um número herdado do proprietário anterior.
- O número é de uma linha fixa sem SMS. Nesse caso, a verificação por voz é a solução.
- Um número virtual cujo fornecedor filtra ou atrasa o código.
- O número já está registado noutra conta do WhatsApp, o que tem de ser resolvido primeiro.

- Tentar fazer o registo antes da verificação. A ordem é importante.
- Escolher SMS numa linha fixa. A verificação por voz existe precisamente para este caso.
- Partir do princípio de que um número virtual receberá o código de forma fiável. Muitos não recebem.

**Como verifico o número?** Com um código enviado por SMS ou por chamada de voz automática para o próprio número.

**E se for uma linha fixa?** Use a verificação por voz, disponível para números sem SMS.

**É o mesmo que o registo?** Não. A verificação comprova o controlo; o registo ativa as mensagens.

**Posso ignorar esta etapa?** Não. O registo continuará a devolver este erro até a verificação ser concluída.

---

## Erro 131050 do WhatsApp: o utilizador optou por não receber mensagens

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131050

O erro 131050 indica que o destinatário optou por não receber mensagens da sua empresa. Não é uma falha e não existe qualquer solução técnica: a pessoa tomou uma decisão, e a resposta correta é registá-la e deixar de enviar mensagens.

### Por que não existe uma solução alternativa

Porque este mecanismo existe para proteger as pessoas de empresas que não aceitam uma recusa, e uma plataforma que permitisse contorná-lo não seria útil para nenhuma das partes.

A Meta também observa o que acontece depois. Continuar a tentar enviar mensagens a pessoas que optaram por não as receber contribui para os sinais que influenciam a classificação de qualidade, e uma classificação em queda reduz a capacidade de envio de mensagens em todo o número, não apenas para esses destinatários.

### O que fazer em alternativa

Registe a decisão corretamente, uma única vez, e deixe que o resto do sistema a respeite.

- Guarde a recusa associada ao contacto para que nada volte a tentar enviar mensagens automaticamente.
- Impeça o envio para o número em todas as campanhas e automatizações, não apenas naquela que gerou o erro.
- Não tente contactar a pessoa através de um segundo número empresarial. É a mesma pessoa e a mesma decisão.
- Se a pessoa lhe enviar uma mensagem mais tarde, a janela reabre e poderá responder. Essa decisão cabe-lhe a ela, não a si.

- Voltar a tentar. O bloqueio é deliberado e permanente até a pessoa o alterar.
- Impedir o envio apenas na campanha que falhou, permitindo que outra tente novamente amanhã.
- Usar um número diferente para contactar a mesma pessoa. É a mesma decisão a ser ignorada.

**Posso enviar-lhes outra mensagem?** Apenas se iniciarem primeiro uma conversa consigo, reabrindo assim a janela de serviço.

**Existe alguma forma de contornar a situação?** Não, e tentar fazê-lo prejudica a sua classificação de qualidade.

**Isto afeta todo o meu número?** A recusa aplica-se a esse destinatário, mas as tentativas repetidas afetam a sua classificação de qualidade geral.

**Devo removê-lo da minha lista?** Impeça o envio em todo o lado, não apenas na campanha que falhou.

---

## Erro WhatsApp 130497: país do destinatário não permitido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-130497

O erro 130497 significa que as mensagens para o país do destinatário não são permitidas para a sua conta. Trata-se de uma restrição geográfica, não de um problema relacionado com o destinatário, e geralmente reflecte um limite da conta, não um erro no pedido.

### O que causa uma restrição de país

Há várias causas, e nem todas são permanentes.

- Uma conta nova ou não verificada, com limites que desaparecem após a verificação empresarial.
- Um país sujeito a uma restrição que a Meta aplica a toda a plataforma.
- Um controlo ao nível da conta definido durante uma análise ou medida de aplicação.
- Um número formatado com o indicativo de país errado, o que gera o erro para um país para o qual nunca pretendeu enviar mensagens.

### Exclua primeiro a formatação

É a única causa que pode corrigir por si e é mais comum do que as outras.

Um número de telefone enviado com um zero inicial mantido, ou sem o indicativo de país, fazendo com que seja aplicado um valor predefinido, pode corresponder a um país diferente do pretendido. O envio falha então devido a uma restrição relativa a um país que não lhe interessa. Verificar se o número está no formato internacional, contém apenas algarismos e tem o indicativo de país correcto demora um segundo e elimina a causa mais provável.

- Assumir que o destinatário é responsável. A restrição aplica-se à sua conta e a esse país.
- Repetir o pedido. Nada muda entre tentativas.
- Ignorar a verificação da formatação, que é a única causa sob o seu controlo.

**O destinatário está a bloquear-me?** Não. Trata-se de uma restrição ao nível do país aplicada à sua conta.

**Pode ser levantada?** Algumas são temporárias e desaparecem com a verificação empresarial. Outras aplicam-se a toda a plataforma.

**Pode ser um erro de formatação?** Sim, e vale a pena excluí-lo primeiro. Um indicativo de país errado corresponde ao país errado.

**Repetir o pedido ajuda?** Não. A restrição não muda entre tentativas.

---

## Erro 132007 do WhatsApp: violação da política de templates

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132007

O erro 132007 indica que o template viola a política de mensagens empresariais do WhatsApp. A mensagem não será enviada na forma atual. É necessário reescrever e voltar a submeter o template, não alterar o pedido.

### O que a política proíbe de facto

É mais restrita do que a maioria das pessoas imagina ao escrever o primeiro template.

- Conteúdo que parece uma promoção não solicitada para alguém que não a pediu.
- Categorias proibidas, incluindo determinados produtos financeiros, de saúde e regulamentados.
- Linguagem que deturpa a identidade do remetente ou sugere uma afiliação inexistente.
- Urgência enganadora ou qualquer estrutura destinada a pressionar uma resposta.

### Porque é que a categoria importa tanto como o texto

Um template submetido como utilitário, mas que parece marketing, é um problema de política mesmo quando nada nele é censurável. A Meta classifica os templates porque os dois tipos têm expectativas de consentimento diferentes, e enviar uma mensagem promocional na categoria utilitária contraria essa distinção.

A regra prática é escrever o template de forma honesta para a categoria. Um template de marketing que assume ser marketing é aprovado. Um template de marketing apresentado como notificação de entrega não é, e reformular o texto sem mudar a categoria raramente o recupera.

- Repetir o envio. O problema está no template, não no pedido.
- Voltar a submeter com alterações cosméticas. Se a categoria estiver errada, o texto não o salvará.
- Assumir que a aprovação é permanente. Um template pode ser desativado mais tarde com o código 132016.

**Posso repetir o envio?** Não. O template tem de ser reescrito e novamente submetido.

**Porque foi rejeitado se o texto parece correto?** Muitas vezes, por causa da categoria. Uma mensagem de marketing submetida como utilitária é um problema de política, independentemente do texto.

**Quanto tempo demora a nova submissão?** A análise costuma ser rápida, mas não existe um prazo garantido.

**É o mesmo que 132016?** Não. Esse código corresponde a um template permanentemente desativado depois da aprovação.

---

## Erro 132012 do WhatsApp: incompatibilidade no formato dos parâmetros do template

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132012

O erro 132012 indica que os valores dos parâmetros enviados não correspondem ao formato definido pelo template. Um template com três variáveis precisa exatamente de três parâmetros, pela ordem certa e com o tipo correto. Qualquer desvio produz este erro, em vez de um envio parcial.

### O que tem de coincidir

Tudo, sem exceção. Não existe correspondência parcial.

- Quantidade: três marcadores no corpo significam três parâmetros do corpo, nem mais nem menos.
- Ordem: os parâmetros são posicionais. Trocar dois envia os valores para os locais errados ou produz este erro se os tipos forem diferentes.
- Tipo: um parâmetro de moeda ou data tem uma estrutura de objeto definida e não pode ser enviado como texto simples.
- Componentes: os parâmetros do cabeçalho, corpo e botão são listas separadas e não podem ser combinados numa só.

### A edição que interrompe a produção

Os templates são editados por pessoas diferentes das que chamam a API. Alguém acrescenta uma variável para tornar a mensagem mais clara, o template é aprovado novamente e todos os envios da integração inalterada começam a falhar.

Vale a pena prevenir este problema, em vez de o descobrir depois. Subscrever webhooks de estado do template faz com que uma edição chegue como evento. Tratar a quantidade de variáveis do template como parte do contrato de integração, revisto quando muda, evita que uma melhoria de redação provoque uma interrupção.

- Enviar um parâmetro adicional por precaução. Ter parâmetros a mais é tão errado como ter a menos.
- Tratar os parâmetros posicionais como se tivessem nomes. São associados apenas pela posição.
- Editar um template sem verificar o código que o envia.

**Quantos parâmetros devo enviar?** Exatamente tantos quantos o template define, pela ordem indicada.

**Posso enviar parâmetros adicionais?** Não. Enviar parâmetros a mais falha da mesma forma que enviar parâmetros a menos.

**Porque é que isto começou a acontecer de repente?** Normalmente, porque o template foi editado e a quantidade de variáveis mudou.

**Os parâmetros têm nomes?** Não. São posicionais, por isso a ordem é importante.

---

## Erro 132016 do WhatsApp: template desativado permanentemente

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132016

O erro 132016 indica que o template foi desativado permanentemente e não pode voltar a ser utilizado. Geralmente, é o fim de uma deterioração da qualidade: os destinatários bloquearam ou denunciaram mensagens enviadas com esse template, a classificação de qualidade baixou e a Meta retirou-o.

### Como se chega a este estado

Raramente num único passo. Um template aprovado de que os destinatários não gostam acumula bloqueios e denúncias, a sua classificação de qualidade desce de verde para amarelo e depois para vermelho, e é colocado em pausa. Pausas repetidas terminam na desativação permanente.

Essa sequência é totalmente observável se estiver a receber os eventos. O webhook da qualidade do template comunica cada alteração, e um template que passa a amarelo é um aviso, quando ainda há tempo para agir. Ignorá-lo é a forma de transformar um template funcional num template inutilizável.

### O que fazer

Duas coisas, por esta ordem.

- Pare de enviar com esse template e mude para outro, porque este nunca voltará a funcionar.
- Perceba por que motivo os destinatários não gostaram dele antes de escrever a substituição, caso contrário, a substituição seguirá o mesmo caminho.
- Verifique o público, além do texto. Um bom template enviado a pessoas que não o esperavam continua a acumular bloqueios.
- Subscreva webhooks de qualidade do template para que a próxima deterioração seja visível a amarelo, e não apenas quando estiver desativado.

- Recriar o mesmo template com um nome novo. O conteúdo é que falhou.
- Ignorar classificações de qualidade amarelas. O amarelo é o aviso; o vermelho é a consequência.
- Culpar o texto quando o problema estava no público.

**Pode ser reativado?** Não. Desativado permanentemente significa permanente.

**Posso recriá-lo com um nome novo?** Pode, mas foi o conteúdo que causou a deterioração, por isso, é provável que siga o mesmo caminho.

**Em que difere do 132015?** 132015 é uma pausa, que termina. Este não.

**Era possível prever isto?** Sim. Os webhooks de qualidade do template comunicam a deterioração antes de se chegar a este ponto.

---

## Erro 131056 do WhatsApp: demasiadas mensagens para um destinatário

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131056

O erro 131056 indica que foram enviadas demasiadas mensagens entre o seu número empresarial e um único destinatário num curto período. É um limite de taxa por par, separado do throughput global da sua conta, e normalmente indica repetição numa automatização.

### Porque é por par

Porque o problema que protege não é o volume em geral, mas uma pessoa receber demasiadas mensagens. Uma conta pode estar bem dentro do seu throughput global e, ainda assim, enviar trinta mensagens para um destinatário num minuto. Para essa pessoa, isso parece spam, independentemente do total da conta.

Por isso, o limite aplica-se ao par e não à conta. É também por isso que pode surgir num número com pouco volume, que nunca se aproximou do seu limite de taxa global.

### O que normalmente o causa

Quase sempre algo automático, não uma pessoa a escrever.

- Um ciclo de repetição que interpreta uma falha de entrega como falha de envio e envia novamente.
- Um handler de webhook que envia uma resposta e é chamado mais de uma vez para o mesmo evento.
- Um chatbot que divide uma resposta em muitas mensagens curtas numa sucessão rápida.
- Um script de teste que envia repetidamente para o mesmo número durante o desenvolvimento.

### Como evitá-lo

Aplicando limitação ao nível da conversa, e não apenas ao nível da conta. Um limite de mensagens por destinatário e por minuto, aplicado antes do envio, custa quase nada e evita tanto este erro como a má experiência do cliente que lhe está subjacente.

A deduplicação de mensagens é igualmente importante. Os eventos de webhook podem ser entregues mais de uma vez, e um handler que envia uma resposta sem verificar se já processou esse message id produzirá exactamente este padrão sob carga.

- Repetir o envio, o que envia mais uma mensagem para o destinatário que já está a receber demasiadas mensagens.
- Limitar apenas ao nível da conta. Este limite é por destinatário.
- Processar eventos de webhook sem deduplicar por message id.

**Este é o limite de taxa da minha conta?** Não. Esse é o 130429. Este é por destinatário.

**Porque surge num número com pouco volume?** Porque o limite se aplica ao par, não ao total da conta.

**Como o faço parar?** Limite por conversa e deduplicate os eventos de webhook por message id.

**Devo repetir o envio?** Não. Repetir envia outra mensagem para o mesmo destinatário.

---

## Erro 80007 do WhatsApp: limite de frequência na conta WhatsApp Business

https://easycoexistence.com/pt-pt/docs/whatsapp-error-80007

O erro 80007 indica que a WhatsApp Business Account atingiu um limite de frequência. Abrange chamadas de gestão e leitura, não o throughput de mensagens. A causa habitual é o polling: algo verifica o estado muito mais vezes do que os dados mudam.

### O que contabiliza

Chamadas dirigidas à conta, não mensagens enviadas aos clientes.

- Leitura de números de telefone, das respetivas classificações de qualidade e dos níveis de throughput.
- Listagem e leitura de templates de mensagens.
- Chamadas de subscrição e configuração de webhook.
- Qualquer verificação de estado executada segundo um agendamento, que é normalmente a origem do volume.

### O polling é a causa que vale a pena corrigir

Uma verificação de estado a cada trinta segundos, aplicada a alguns números, representa milhares de chamadas por dia para dados que mudam algumas vezes por mês. O limite acaba por ser atingido e, quando isso acontece, o polling deixa de funcionar precisamente quando ocorreu algo relevante.

Os webhooks invertem esse processo. A Meta envia uma alteração da classificação de qualidade, uma atualização da conta ou uma alteração do estado de um template quando ocorre, sem consumir chamadas e mais depressa do que qualquer polling. A arquitetura adequada usa webhooks para alterações e reserva o polling para uma reconciliação pouco frequente, em vez de o usar como mecanismo principal.

- Verificar o estado em intervalos curtos. Isso esgota o limite com dados que raramente mudam.
- Responder adicionando novas tentativas, o que consome o limite mais depressa.
- Confundi-lo com 130429, que diz respeito ao envio de mensagens.

**Isto diz respeito ao envio de mensagens?** Não. Esse limite é 130429. Este abrange chamadas de gestão e leitura.

**O que o causa?** Normalmente, verificar o estado em intervalos curtos através de polling.

**O que devo fazer em alternativa?** Subscrever webhooks e reservar o polling para reconciliações pouco frequentes.

**É eliminado automaticamente?** Sim, quando o período termina, mas regressa se o polling não for alterado.

---

## Coexistência do WhatsApp para agências e consultoras

https://easycoexistence.com/pt-pt/whatsapp-coexistence-for-agencies

As agências enfrentam o mesmo obstáculo com todos os clientes: o número é aquele que a equipa já atende, e migrá-lo retira-lhes a aplicação WhatsApp Business. A Coexistência elimina esse problema, permitindo ligar um número de cliente sem alterar a forma como trabalham.

### Porque é que os números dos clientes bloqueiam a maioria das integrações?

Porque não cabe ao cliente alterar o número, e tudo o que lhe diz respeito já está em utilização.

O número de um cliente está impresso em viaturas, faturas, num site e em anos de conversas anteriores. Alguém atende-o a partir de um telemóvel durante todo o dia e conhece os clientes habituais pelo nome. Assim que uma proposta envolve migrar esse número, a aplicação WhatsApp Business deixa de funcionar nele e essa pessoa tem de passar para o sistema que criou. A maioria dos clientes recusa, e tem razão.

É por isso que tantas agências acabaram por usar gateways não oficiais. Esses mantinham o telemóvel a funcionar, que era a única coisa importante para o cliente, e o risco de banimento permanecia invisível até deixar de o ser. A Coexistência é a versão oficial da mesma promessa.

### Como decorre, na prática, a integração de um cliente?

O cliente faz uma única coisa, no seu próprio telemóvel, e demora cerca de dois minutos.

Envia-lhe um link de ligação. Abre-o, aparece a janela da Meta, escolhe o Portefólio empresarial e o número, e lê um código na aplicação WhatsApp Business. É tudo. Não instala nada, não partilha credenciais e a aplicação continua a funcionar assim que a leitura termina.

O número permanece no Portefólio empresarial do cliente, em vez de ficar sob o seu, por duas razões. É a resposta quando um cliente pergunta quem é o proprietário da ligação e significa que a relação sobrevive se mudar de agência, algo mais fácil de prometer do que de explicar depois.

### Como funciona isto com vinte clientes?

Uma conta, vinte números, uma tarifa fixa por número e uma lista fácil de consultar.

Não há nenhum escalão que possa esgotar nem nenhum plano que mude ao atingir um limite. Adicionar o cliente número 21 é a mesma operação que adicionar o primeiro. Cada número apresenta a sua própria classificação de qualidade, nível de mensagens e estado da ligação, para que veja um número degradado antes de o cliente lhe ligar.

A maior parte do valor a esta escala está nessa visibilidade. Uma ligação falha silenciosamente, a aplicação WhatsApp Business continua a funcionar durante quase todas as falhas e o cliente não tem forma de o saber. Sem monitorização, o primeiro sinal é um cliente a perguntar porque deixou a automação de funcionar, uma conversa que começa mal.

### Pode um agente fazer a integração em vez de uma pessoa?

A maior parte, e aquilo que não pode fazer é precisamente o que um cliente tem de fazer na mesma.

Através do conector MCP, um assistente pode chamar get_connect_link para gerar o link que o cliente abre, depois set_webhook_destination para encaminhar esse número para o sistema que o trata e, em seguida, verificar a saúde do número para confirmar que está tudo ativo. É a sequência completa sem ninguém abrir um painel.

O que não pode fazer é ler o código. A integração da Meta decorre num navegador e precisa do telemóvel que contém o número, uma proteção deliberada e não uma lacuna. O cliente é a única pessoa que pode autorizar o seu próprio número, e esse é o procedimento correto.

- Prometer ao cliente que a equipa não vai notar e depois migrar o número. A migração retira a aplicação e a equipa nota imediatamente.
- Ligar números de clientes ao seu próprio Portefólio empresarial. Mantenha cada um no Portefólio do cliente, para que a ligação lhe pertença.
- Tratar a monitorização como opcional à escala. Vinte falhas silenciosas em vinte clientes representam carga de apoio ao cliente, não um caso excecional.

**Cada cliente precisa da sua própria conta consigo?** Não. Uma conta contém todos os números que gere, cada um cobrado separadamente, e o conector apresenta-os a todos. Não há nenhuma restrição à utilização com as empresas que atende.

**Quem é o proprietário da ligação, eu ou o cliente?** O número permanece no Portefólio empresarial do cliente. Gere a ligação, mas a relação subjacente com a Meta pertence-lhe, que é a resposta honesta quando pergunta.

**O que acontece se um cliente sair?** O número é desligado e a aplicação WhatsApp Business continua exatamente como antes. O número não sofre nenhuma alteração permanente por ter estado ligado.

**Quem paga à Meta pelas mensagens?** É o cliente, através do método de pagamento da sua própria conta WhatsApp Business. Esses custos nunca passam por nós, por isso não há nada a acrescentar.

---

## O que significa ser Meta Tech Provider e porque importa

https://easycoexistence.com/pt-pt/meta-tech-provider

Um Meta Tech Provider gere a sua própria aplicação Meta num Business Manager verificado e pode ligar através dela os números de WhatsApp de outras empresas. A EasyCoexistence é um deles, por isso um número liga-se diretamente ao seu próprio portefólio empresarial, em vez de ficar na conta de um revendedor.

### O que faz realmente um Tech Provider?

Gere a aplicação através da qual outras empresas ligam os seus números de WhatsApp.

Quando uma empresa inicia o processo, abre-se o Embedded Signup da Meta e é-lhe pedido que autorize uma aplicação. Essa aplicação pertence ao Tech Provider e, depois de autorizada, pode agir em nome da empresa sobre o número: ler o respetivo estado, enviar mensagens, gerir templates e definir onde os webhooks são entregues. Tudo o que um provider oferece assenta nessa relação.

É o estatuto que torna isto legítimo. A Meta concede-o a uma empresa com a sua própria aplicação num Business Manager verificado, depois do App Review, e é isso que distingue um provider de um script que guarda as credenciais de outra pessoa.

### Porque importa saber quem é o proprietário da aplicação?

Porque isso determina a conta à qual o número do seu cliente fica associado.

As ferramentas construídas sobre a conta de um provider externo herdam as limitações dessa conta. É daí que vêm os limites de uma única ligação que muitas pessoas encontram em plataformas de automação generalista: a plataforma mantém uma relação de provider e todos os seus utilizadores partilham-na.

Com a nossa própria aplicação, a ligação é feita diretamente entre o Portefólio empresarial do cliente e a Meta. O número continua a ser dele, não há um revendedor a detê-lo e adicionar o seguinte é a mesma operação que adicionar o primeiro. Para uma agência, isto não é um pormenor técnico: é a resposta quando um cliente pergunta quem controla o seu número.

### O que exige o estatuto?

Um Business Manager verificado, uma aplicação aprovada no App Review e demonstrações gravadas dos fluxos.

A verificação da empresa liga a aplicação a uma entidade legal real, através de documentos que a Meta compara com registos oficiais. O App Review analisa o que a aplicação pede e porquê e, no caso do WhatsApp, inclui vídeos gravados que mostram o processo de integração a funcionar de ponta a ponta. Nada disto custa dinheiro e tudo leva tempo, que é a parte que não pode ser comprimida.

É importante saber isto se estiver a considerar criar o seu próprio provider. Ligar um único número que lhe pertence não exige nada disto. Ligar números de clientes exige tudo, e a espera mede-se em semanas, não em dias de trabalho.

### O que muda para a empresa que liga um número?

Três coisas, e nenhuma é visível no ecrã.

O número é ligado no próprio Portefólio empresarial da empresa, por isso a relação com a Meta é dela. A Meta cobra diretamente as conversas à respetiva WhatsApp Business Account, razão pela qual ninguém pelo meio pode acrescentar uma margem. E não há um limite máximo para o número de números que uma conta pode deter, porque não existe uma relação partilhada de provider a dividir.

O que não muda é o próprio processo de integração. O Embedded Signup é o fluxo da Meta, a janela pop-up é da Meta e a leitura do código acontece na aplicação WhatsApp Business. Um Tech Provider não substitui nada disso: é o que torna tudo disponível.

- Assumir que todos os providers têm o seu próprio estatuto de Tech Provider. Muitos assentam no estatuto de outra entidade, que é de onde vêm os limites de ligações.
- Planear obtê-lo dentro de um prazo. A duração do App Review não é algo que uma empresa possa controlar.
- Tratá-lo como um distintivo. É uma relação entre contas e determina em que portefólio fica o número do cliente.

**Isto significa que a Meta recomenda a EasyCoexistence?** Não, e nenhum provider deve dar essa ideia. Tech Provider é um estatuto técnico que permite ligar números de outras empresas através de uma aplicação aprovada. Não é uma recomendação do produto criado sobre essa base.

**Posso tornar-me Tech Provider?** Sim. É gratuito e está aberto a qualquer empresa com um Business Manager verificado que aceite passar pelo App Review. O custo é a espera, não uma taxa.

**Em que Portefólio empresarial fica o meu número?** No seu. A ligação é feita entre o seu portefólio e a Meta, com a nossa aplicação autorizada a agir sobre o número. Este não passa para a nossa conta.

**Existe um limite para o número de números que posso ligar?** Não. Os limites encontrados noutros serviços resultam da partilha de uma relação de provider entre muitos utilizadores, o que não acontece aqui.

---

## Quanto custa a Coexistence do WhatsApp, fornecedor a fornecedor

https://easycoexistence.com/pt-pt/whatsapp-coexistence-pricing-compared

Os fornecedores cobram por três unidades diferentes: por número, por utilizador ou por mensagem. Por isso os preços de destaque não são comparáveis e o custo real só se vê para um dado número de ligações. Esta página faz as contas com um, dez e cinquenta números.

### Porque é que os preços de destaque não são comparáveis?

Porque cobram coisas diferentes, e a unidade decide a que tipo de negócio cada um se adequa.

O preço por número acompanha quantas linhas de WhatsApp se mantêm. É a unidade que uma agência realmente controla, e é a que a EasyCoexistence, a 360dialog e a Dualhook usam.

O preço por utilizador e por contacto acompanha quantas pessoas respondem e com quantos clientes se fala. É o que a WATI e a respond.io usam, e é a unidade certa quando o que se compra é uma equipa de agentes.

O preço por mensagem acompanha apenas o volume, que é o modelo da Twilio: sem taxa de plataforma e sem taxa por número, mas com um custo por cada mensagem, além do que a Meta fatura.

Assim, a única comparação honesta é feita para um número de ligações definido, que é o que a tabela abaixo faz.

### Quanto custam os fornecedores com preço de plataforma, para as mesmas quantidades?

Não se podem pôr na mesma coluna com honestidade, porque a sua tarifa não varia de todo com o número de números. O que varia são os utilizadores e os contactos.

Os planos publicados da WATI vão de três a dez utilizadores, com 500 a 2 500 contactos ativos por mês. A respond.io publica US$ 79 para cinco utilizadores e 1 000 contactos, subindo até US$ 279. A YCloud publica um escalão gratuito e depois US$ 39, US$ 89 e US$ 399, com utilizadores e canais como extras a US$ 10 e US$ 5 cada, por mês.

Para uma equipa de apoio ao cliente com um número, são preços competitivos e incluem uma caixa de entrada, que uma simples ligação não inclui. Para uma agência com cinquenta números de clientes, o custo aparece nas linhas extra, e aparece por canal e não por conversa.

A pergunta que decide é se alguém vai realmente entrar na caixa de entrada que se está a pagar.

### E a Twilio, que não cobra nenhuma das duas?

A Twilio publica uma taxa por mensagem de US$ 0,005 em cada sentido, além dos custos de templates da própria Meta, que repassa sem margem. Não há taxa mensal de plataforma nem taxa por número no preçário publicado.

Isso faz dela a forma mais barata de manter um número que quase não envia nada, e a mais cara de operar um número com muito movimento. Cinquenta números parados não custam nada; cinquenta números com conversas reais custam por mensagem, para sempre.

Convém também saber que a página de preços da Twilio não aborda a Coexistence. Se manter a app do WhatsApp Business a funcionar no número for importante, essa é a pergunta a fazer-lhes antes de comparar o resto.

### Qual deve uma agência escolher?

Aquele cuja unidade corresponde ao que cresce no seu negócio.

Se o que cresce são os números de clientes, o preço por número com desconto de volume é a única forma que não penaliza o sucesso. A EasyCoexistence custa US$ 9 por número até cinco números e desce para US$ 1 por número à medida que adiciona números, pelo que com cinquenta clientes cada número custa menos do que o primeiro e não mais.

Se o que cresce são os agentes a responder numa só caixa de entrada, uma plataforma com preço por utilizador é a compra certa e esta página não vai argumentar o contrário. A WATI e a respond.io construíram isso e funciona.

Se o que cresce é o volume de mensagens em poucos números, vale a pena simular o modelo por mensagem da Twilio contra os outros, com o seu ritmo real de envio.

Para o caso para que este produto foi criado, uma agência ou um programador que mantém números que não lhe pertencem, o preço por número com desconto de volume é o único que escala no mesmo sentido do negócio: o preço por número desce à medida que a quantidade sobe.

- Comparar diretamente os preços de destaque. Estão definidos em três unidades diferentes e o número mais pequeno é muitas vezes a escolha errada.
- Presumir que algum destes fornecedores aplica margem aos custos de mensagens da Meta. Nenhum dos que constam desta página o faz; a Meta fatura diretamente ao cliente.
- Ler uma funcionalidade não documentada como uma funcionalidade inexistente. Quando uma página de preços não menciona a Coexistence, pergunte ao fornecedor em vez de confiar nesta tabela.

**Estes preços estão atualizados?** Correspondem ao publicado na página de preços de cada fornecedor em setembro de 2026, com ligação a partir dos valores acima. Os preços mudam, por isso confirme a fonte antes de decidir.

**Porque é que a EasyCoexistence fica mais barata por número?** Porque o custo de vigiar uma ligação não sobe na mesma proporção do número de ligações. Uma agência com cinquenta números não dá cinquenta vezes mais trabalho, logo não paga cinquenta vezes mais.

**Algum destes fornecedores aplica margem aos custos da Meta?** Nenhum dos fornecedores desta página o faz. A Meta fatura os custos de mensagens ao método de pagamento da sua própria conta WhatsApp Business, e é também por isso que nenhum intermediário os pode reduzir.

**Que fornecedores suportam a Coexistence?** A YCloud e a 8x8 documentam-na, e a Dualhook e a EasyCoexistence foram criadas em torno dela. Várias outras páginas de preços não a abordam, o que não prova nada em nenhum sentido e justifica uma pergunta direta.

---

## Glossário de WhatsApp Coexistence

https://easycoexistence.com/pt-pt/whatsapp-coexistence-glossary

Os termos de WhatsApp Coexistence confundem-se facilmente, e grande parte da confusão surge quando duas pessoas usam a mesma palavra para coisas diferentes. Estas são as definições usadas neste site, cada uma ligada à página que a explica em detalhe.

### Porque é que o vocabulário causa tantos problemas?

Porque vários destes termos designam coisas situadas em níveis diferentes, mas que parecem estar todas no mesmo nível.

Um Business Portfolio contém uma WhatsApp Business Account, que contém números de telefone, cada um com um phone number id. Numa conversa, os quatro acabam por ser chamados de conta, e uma frase como verificar se a conta está a funcionar pode significar quatro verificações diferentes. O mesmo acontece com as duas janelas de 24 horas desta plataforma, que medem coisas sem relação entre si e são constantemente trocadas.

A outra metade do problema é que a Meta e os fornecedores usam palavras diferentes para a mesma coisa, e os próprios fornecedores também não estão de acordo. Esta página usa o vocabulário da Meta quando ele existe e indica claramente quando um termo é nosso.

### Que distinções são realmente importantes na prática?

Três, e cada uma já custou um dia de trabalho a alguém.

A janela de atendimento ao cliente e a janela de sincronização duram ambas 24 horas, mas não têm qualquer relação. Uma determina se o texto livre é entregue, contando desde a última mensagem do cliente. A outra determina se o histórico de conversas ainda pode ser obtido, contando desde a integração.

Um dispositivo ligado não é uma API. É o cliente WhatsApp de consumidor com sessão iniciada noutro local, que é aquilo que as ferramentas não oficiais automatizam e que leva ao bloqueio de números.

E um destino de webhook não é uma definição de um número. É uma substituição na subscrição de uma aplicação a uma conta, razão pela qual desaparece quando uma ligação é removida e tem de ser reposta ao ligar novamente.

**Coexistence é uma API diferente da Cloud API?** Não. Coexistence é uma forma de integrar um número na Cloud API, mantendo a aplicação WhatsApp Business a funcionar nesse número. Os endpoints, o formato das mensagens e as regras são idênticos.

**Qual é a diferença entre um Business Portfolio e uma WABA?** O Business Portfolio é o contentor da empresa no Meta Business Manager. Uma WhatsApp Business Account fica dentro dele e contém os números de telefone. Um portefólio pode conter várias WABAs.

**Um BSP é o mesmo que um Tech Provider?** Sobrepõem-se, mas descrevem coisas diferentes. Tech Provider é um estado atribuído pela Meta que permite a uma empresa ligar números de outras empresas através da sua própria aplicação. BSP costuma designar uma empresa que vende uma plataforma de mensagens, podendo ou não ter esse estado.

**O que é que o MCP tem a ver com o WhatsApp?** Nada por si só. MCP é um protocolo que dá a um assistente de IA acesso a uma ferramenta, e um servidor MCP do WhatsApp expõe um número como uma dessas ferramentas. Não pode receber mensagens, apenas agir quando lhe é pedido.

---

## Campos do webhook do WhatsApp e respetivo destino

https://easycoexistence.com/pt-pt/docs/webhook-fields

Uma conta do WhatsApp Business entrega eventos como campos nomeados. Dois transportam conteúdo de conversas e são encaminhados para o seu endpoint. Seis transportam o estado operacional e servem de base à monitorização. Saber distingui-los define a sua arquitetura.

### O que transporta cada campo?

messages transporta tudo o que um cliente envia para o número: texto, referências de multimédia, respostas e reações. smb_message_echoes transporta o que a sua equipa envia a partir da aplicação WhatsApp Business. Só existe num número de Coexistência e permite ao software ver as respostas de uma pessoa.

account_update transporta o estado da ligação: PARTNER_REMOVED quando a aplicação é desinstalada da conta, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED e eventos de restrição ou violação. phone_number_quality_update transporta alterações à classificação de qualidade e ao throughput. account_alerts transporta os alertas que a Meta emite para a conta, e account_review_update transporta o resultado de uma análise.

business_capability_update transporta alterações aos limites e capacidades de mensagens, e phone_number_name_update transporta aprovações e rejeições do nome apresentado.

### Porque é que a separação importa para a arquitetura?

Porque determina se o conteúdo das conversas chega alguma vez a um fornecedor.

A substituição envia os dois campos de mensagens diretamente da Meta para o seu endpoint. Os seis campos operacionais continuam a ser enviados para o fornecedor, permitindo ter um painel e alertas sem que alguém retenha uma mensagem.

É também por isso que a afirmação de que não guardamos mensagens pode ser estrutural, e não apenas uma política. Se os campos de mensagens forem entregues noutro local, não existe um caminho de código onde possam ser guardados. No nosso caso, uma conta sem substituição recorre ao callback predefinido, onde o processador elimina esses eventos sem os guardar.

### Que campos deve o seu processador esperar?

Apenas os dois campos de mensagens, se a substituição estiver definida. Ainda assim, é recomendável escrever o processador para ignorar tudo o resto, em vez de falhar.

A Meta acrescenta campos ao longo do tempo, e a estrutura de um payload pode ganhar chaves sem aviso. Um processador que usa o nome do campo e ignora o que não reconhece continua a funcionar. Um processador que pressupõe uma estrutura falha no primeiro evento desconhecido.

Também vale a pena tratar smb_message_echoes explicitamente, em vez de o considerar ruído. Sem este campo, o software não sabe que uma pessoa já respondeu, o que pode fazer com que um cliente receba duas respostas à mesma pergunta.

- Pressupor um payload genérico. Cada evento identifica o seu campo, e o processador deve analisá-lo.
- Ignorar smb_message_echoes. Sem este campo, o software responde depois de uma pessoa já ter respondido.
- Falhar perante campos desconhecidos em vez de os ignorar. A Meta acrescenta campos sem pedir autorização.

**Posso receber apenas alguns campos?** A substituição encaminha o caminho das mensagens para si. A separação operacional é fixa, porque a monitorização é construída a partir dela.

**smb_message_echoes existe num número normal da Cloud API?** Não. Existe porque um número de Coexistência permite que uma pessoa envie mensagens a partir da aplicação, além do envio feito pelo software através da API.

**O que acontece aos eventos de mensagens se não definir um destino?** Chegam ao nosso callback predefinido e são eliminados sem serem guardados.

**Os nomes dos campos são da Meta ou vossos?** São da Meta. Nenhum dos nomes foi inventado por nós, por isso vale a pena aprendê-los uma vez.

---

## Verificar um endpoint webhook do WhatsApp

https://easycoexistence.com/pt-pt/docs/webhook-verification

Antes de entregar qualquer evento, a Meta chama o seu endpoint com um GET que inclui hub.mode, hub.verify_token e hub.challenge. O seu endpoint tem de comparar o token e devolver o desafio como corpo bruto. Qualquer outra resposta impede o início da entrega.

### O que envia exatamente a Meta?

Um pedido GET para o seu URL com três parâmetros de consulta. hub.mode fica definido como subscribe. hub.verify_token é o token que configurou ao definir o destino. hub.challenge é um valor que a Meta gera para esta tentativa.

O seu endpoint deve comparar hub.verify_token com o token que escolheu e, se coincidirem, responder 200 com hub.challenge como corpo integral da resposta. Não o envolva em JSON, não coloque aspas à volta e não acrescente uma nova linha no fim, como algumas frameworks fazem por predefinição.

Se os tokens não coincidirem, responda 403. Esse é todo o protocolo, deliberadamente simples.

### Por que falha silenciosamente uma resposta errada?

Porque uma falha na verificação não é um erro no seu sistema, mas uma ausência no sistema da Meta.

Quando o desafio não é devolvido corretamente, a Meta simplesmente não começa a entregar eventos nesse destino. O seu servidor responde 200 à verificação, os registos mostram que chegou um pedido e nenhum painel assinala um problema. O único sintoma é a ausência de mensagens, que a maioria das pessoas diagnostica como um problema de Coexistence, e não como um problema de handshake.

É por isso que vale a pena validar antes da chamada. Verificamos se o URL usa HTTPS e se foi fornecido um token de verificação antes de fazer o pedido Graph, para que um destino malformado falhe de imediato, em vez de parecer ligado.

### O que mais pode impedir a verificação?

Três coisas que não têm nada que ver com o código.

Autenticação à frente do endpoint. Um gateway, uma camada de autenticação básica ou uma lista de permissões de IP rejeitará o pedido da Meta, que não tem credenciais para apresentar. A rota de verificação tem de estar acessível sem elas.

Um redirecionamento. A Meta chama o URL que lhe forneceu, e um 301 para um anfitrião canónico não é seguido de forma a concluir o handshake. Forneça-lhe o URL final.

E uma framework que serializa a resposta. Devolver uma cadeia de texto a partir de um handler que envolve tudo em JSON produz um corpo com aspas à volta do desafio, que não corresponde.

- Devolver JSON. O corpo tem de ser apenas o valor bruto do desafio.
- Colocar o endpoint atrás de autenticação. A Meta não tem credenciais e o pedido será rejeitado.
- Fornecer à Meta um URL que redireciona. Use o URL final.

**Que token devo usar?** Qualquer cadeia de texto que escolha. Serve para o seu endpoint distinguir o pedido da Meta de qualquer outro pedido de alguém que descubra o URL.

**Com que frequência ocorre a verificação?** Durante a configuração e novamente sempre que o destino é definido. Um endpoint funcional não é verificado de novo em cada evento.

**Posso testá-lo sozinho?** Sim. Chame o seu próprio endpoint com os três parâmetros e confirme que o corpo regressa exatamente com o valor do desafio.

**E se o meu servidor estivesse indisponível durante a verificação?** O handshake falha e o destino não é ativado. Guardá-lo novamente executa a verificação outra vez.

---

## Referência das ferramentas MCP

https://easycoexistence.com/pt-pt/docs/mcp-tools-reference

O conector expõe dezasseis ferramentas para todos os números de uma conta. list_numbers aparece primeiro porque todas as outras ferramentas recebem um connection_id obtido a partir dela. Seis ficam bloqueadas quando a faturação fica em atraso: as quatro que atuam no mundo exterior, get_api_credentials, que devolve o token de acesso, e create_connect_link. As outras dez, as leituras de estado e de templates e a configuração da Partner API, continuam disponíveis.

### O que faz cada ferramenta?

Leitura: list_numbers devolve os números ligados, com o estado, a classificação de qualidade e o nível de mensagens, sendo o ponto de partida para todas as outras chamadas. get_number_health devolve em conjunto um instantâneo em tempo real da Meta, a cronologia recente da monitorização, os eventos do webhook e as verificações do poller. get_api_credentials devolve o URL base da Graph API, o WABA id, o phone number id e, quando disponível, o token de acesso da própria conta.

Envio: send_message envia texto livre dentro da janela de 24 horas, na qual as respostas são gratuitas. send_template envia um template aprovado, que permite iniciar uma conversa com alguém que ainda não escreveu. list_templates, create_template e get_template_status abrangem o ciclo de vida do template.

Ligação: set_webhook_destination encaminha mensagens recebidas e ecos da aplicação para o seu sistema; passar null repõe a definição anterior. get_connect_link devolve a ligação para o painel e os passos para ligar um novo número. get_docs devolve a documentação do produto em markdown.

Partner API, para software ou agências cujos próprios clientes ligam números: get_partner_setup mostra a faturação, a chave de API, o URL de eventos e o próximo passo. create_api_key emite a chave da Partner API e mostra-a uma única vez, e não substitui uma chave existente sem confirmação explícita. revoke_api_key revoga-a, também após confirmação. set_partner_events_url define para onde vão os eventos de estado e devolve o segredo de assinatura uma única vez. create_connect_link cria uma ligação de conexão alojada para um cliente, válida durante 1 hora, igual a POST /api/v1/connect-sessions.

### Porque é importante o connection_id?

Porque é ele que liga uma instrução a um número específico, e um assistente não pode adivinhá-lo.

Todas as ferramentas que atuam sobre um número recebem um connection_id, e list_numbers é o único local onde este é obtido. Na prática, isto significa que, ao receber um pedido para enviar uma mensagem, o assistente chama primeiro list_numbers, razão pela qual o primeiro pedido de uma sessão é muitas vezes mais lento do que os restantes.

Isto também significa que uma conta com vários números não deixa margem para ambiguidades. Não existe um número predefinido nem uma seleção implícita, por isso uma instrução que não identifique o número fica por esclarecer, em vez de ser adivinhada.

### O que acontece quando a faturação fica em atraso?

Ficam bloqueadas seis ferramentas: send_message, send_template, create_template e set_webhook_destination, que atuam no mundo exterior; get_api_credentials, porque devolve o token de acesso da conta, que permitiria a uma conta bloqueada enviar diretamente pela Graph API; e create_connect_link, que liga um número novo. Todas as outras leituras continuam disponíveis, tal como a configuração da Partner API: get_partner_setup, create_api_key, revoke_api_key e set_partner_events_url.

Isto é deliberado, não uma falha. Uma conta que não consiga ver porque está bloqueada, ou verificar se os seus números estão em boas condições, fica sem alternativa além de contactar o apoio ao cliente. Essas mesmas leituras são também aquilo de que depende a monitorização da saúde, pelo que bloqueá-las desligaria a monitorização precisamente quando alguém mais precisa dela.

Na prática, uma conta com a faturação em atraso continua a responder a perguntas sobre o seu próprio estado e continua a ser monitorizada. O que fica impedido é tudo o que chega a um cliente.

- Esperar que o conector receba mensagens. O MCP funciona por pedido e resposta; o tráfego recebido precisa de um webhook.
- Fixar um connection_id no código. O valor vem de list_numbers e não deve ser anotado.
- Assumir que uma conta com a faturação em atraso fica totalmente offline. As leituras e a monitorização continuam de propósito, exceto as credenciais, que contêm o token que envia.

**Tenho de escolher qual ferramenta chamar?** Não. Faz o pedido em linguagem natural e o assistente escolhe a ferramenta. É para isso que servem as descrições das ferramentas.

**Pode ler as minhas conversas?** Não. As mensagens recebidas são encaminhadas para o destino do webhook que indicar. O conector lê o estado da conta e dos números.

**get_docs é útil?** Mais do que parece. Fornece ao assistente a nossa documentação em markdown, para que as respostas sobre as regras de Coexistence venham da nossa documentação, e não da memória.

**Um conector abrange vários clientes?** Sim. Uma conta pode ter tantos números quantos forem necessários e list_numbers devolve-os todos.

---

## Ligar um número, passo a passo

https://easycoexistence.com/pt-pt/docs/connecting-a-number

O processo de ligação usa o Embedded Signup da Meta: selecione o Portefólio empresarial, a conta WhatsApp Business e o número; depois leia um código na aplicação WhatsApp Business. Demora cerca de dois minutos e a aplicação continua a funcionar durante todo o processo.

### O que acontece durante o fluxo?

Abre-se uma janela da Meta que pede três elementos, por esta ordem.

Primeiro, o Portefólio empresarial, que é o contentor da empresa no Business Manager. Depois, a conta WhatsApp Business dentro dele. Por fim, o número de telemóvel, que tem de estar previamente registado na aplicação WhatsApp Business, porque a Coexistence liga um número que a aplicação já utiliza, em vez de criar um novo.

Depois, o fluxo passa para o telemóvel. A Meta mostra um código, alguém abre a aplicação WhatsApp Business no dispositivo que tem esse número e lê-o. Esse é o único passo que sai do navegador e é o passo que mais ninguém pode fazer em nome da empresa.

### O que fica decidido durante a configuração inicial e não pode ser alterado?

A partilha do histórico de conversas existente, que é pedida uma vez e fica definitiva para essa ligação.

Ao aceitar, o histórico recente é sincronizado com a API, para que o software comece com contexto. Ao recusar, a API vê apenas as mensagens recebidas a partir do momento da ligação. Ambas as opções são válidas e a maioria das integrações preocupa-se com novas conversas, mas a decisão não pode ser revista sem desligar e ligar novamente.

Existe também um prazo. A sincronização tem de ser iniciada nas 24 horas seguintes à configuração inicial e só pode ser executada uma vez. Falhar qualquer uma destas condições produz um erro pouco claro, e não um aviso. Por isso, convém decidir sobre o histórico no próprio dia, e não durante o trabalho de integração.

### O que deve estar preparado antes de começar?

São necessárias três coisas, e tê-las preparadas evita abandonar o fluxo a meio.

Acesso ao Portefólio empresarial que detém o número, normalmente nas mãos do responsável pela empresa e não de quem faz a integração. O telemóvel com esse número, desbloqueado e com a aplicação WhatsApp Business instalada. E, idealmente, o destino do webhook, porque defini-lo no fim da configuração inicial é mais simples do que voltar a fazê-lo mais tarde.

Se o fluxo for fechado antes de terminar, o número pode ficar associado à conta sem estar registado, o que produz um erro no primeiro envio. Voltar a executar o fluxo desde o início resolve o problema.

- Começar sem ter o telemóvel por perto. A leitura não pode ser feita mais tarde a partir de outro dispositivo.
- Fechar a janela quando o número aparece. O fluxo continua e interrompê-lo deixa o número sem registo.
- Adiar a decisão sobre o histórico até a integração estar concluída. Expira 24 horas depois da configuração inicial.

**Posso ligar um número que não me pertence?** Só a empresa proprietária pode autorizar a ligação. Envie-lhe um link e o responsável conclui o fluxo no próprio telemóvel.

**A aplicação deixa de funcionar durante a configuração inicial?** Não. Continua a funcionar durante todo o processo, incluindo enquanto o código está a ser lido.

**E se o número estiver na aplicação WhatsApp para consumidores?** Tem de ser transferido primeiro para a aplicação WhatsApp Business. A Coexistence liga um número da aplicação Business.

**Posso repetir o fluxo?** Sim. Desligar e ligar novamente executa-o outra vez, incluindo uma nova oportunidade para aceitar a partilha do histórico.

---

## A janela de atendimento ao cliente de 24 horas

https://easycoexistence.com/pt-pt/docs/customer-service-window

A janela de atendimento ao cliente abre-se quando um cliente envia uma mensagem para o seu número e dura 24 horas. Dentro dela, pode enviar texto livre e essas respostas não têm custo. Fora dela, só será entregue um template aprovado pela Meta.

### Quando começa exatamente a contagem?

Quando o cliente envia uma mensagem, reiniciando-se sempre que envia outra.

Este é o detalhe que muitas pessoas invertem. A janela não é contada a partir da sua última mensagem, do início da conversa ou da abertura de um pedido. É contada a partir da mensagem recebida mais recente do cliente, o que significa que uma conversa ativa praticamente nunca fecha e uma conversa unilateral fecha ao fim de um dia.

Isto também significa que a janela é por contacto, não por número. Um cliente pode estar dentro dela enquanto outro está fora, no mesmo número e no mesmo momento.

### O que pode ser enviado dentro e fora da janela?

Dentro, tudo: texto livre, multimédia e templates, se quiser. Fora, apenas um template que a Meta já tenha aprovado.

É por isso que existem templates. São a forma autorizada de iniciar ou retomar uma conversa com alguém que ainda não escreveu e são revistos antecipadamente precisamente porque o destinatário não pediu a mensagem.

Num número Coexistence, há uma consequência adicional. A aplicação WhatsApp Business não pode enviar templates, por isso tudo o que estiver fora da janela tem de passar pela API. Uma equipa que responda a partir do telemóvel pode responder livremente a uma conversa ativa, mas não pode retomar uma conversa inativa. Esta é uma das razões práticas para ligar um número.

### Porque é que as integrações descobrem isto em produção?

Porque os testes acontecem sempre dentro da janela.

Quem cria a integração envia uma mensagem para si próprio e responde-lhe segundos depois. Isso acontece dentro das 24 horas, por isso o texto livre funciona e todos os testes passam. O primeiro caso real que falha é um cliente que escreveu ontem, normalmente já depois do lançamento.

A estrutura certa inclui uma decisão antes do envio: verificar há quanto tempo esse contacto escreveu pela última vez e seguir o caminho do texto livre ou o caminho do template. Fazê-lo desde o início custa quase nada. Implementá-lo mais tarde implica encontrar cada envio no código.

- Contar a partir da sua própria última mensagem. É a mensagem do cliente que abre a janela.
- Tratá-la como sendo por número. É por contacto, por isso duas conversas no mesmo número podem estar em estados diferentes.
- Testar apenas imediatamente depois de uma mensagem, o que acontece sempre dentro da janela.

**É possível prolongar a janela?** Não. É fixa pela Meta e nenhum fornecedor pode prolongá-la.

**Uma resposta com template reabre a janela?** É a resposta do cliente que o faz. O envio de um template, por si só, não abre uma janela de texto livre.

**As respostas são mesmo gratuitas?** A Meta não cobra pelas mensagens enviadas dentro da janela de atendimento ao cliente. Cobra pelas conversas iniciadas fora dela.

**E a outra janela de 24 horas de que li?** Essa é a janela de sincronização, contada a partir da integração inicial, e gere o histórico de conversas, não o envio. Não estão relacionadas.

---

## Templates de mensagens do WhatsApp

https://easycoexistence.com/pt-pt/docs/message-templates

Um template é uma mensagem enviada à Meta para revisão prévia. Depois de aprovado, pode ser enviado a qualquer momento, incluindo para alguém que nunca tenha escrito. É a única forma de entregar mensagens fora da janela de 24 horas de atendimento ao cliente.

### Para que servem as três categorias?

Indicam à Meta o tipo de mensagem em causa, e a categoria altera tanto a revisão como a faturação.

A categoria de utilidade abrange mensagens transacionais associadas a uma ação do cliente: uma atualização de encomenda, uma confirmação de reserva ou um aviso de entrega. O marketing abrange conteúdo promocional, e o seu envio exige um método de pagamento na Conta WhatsApp Business. A autenticação abrange códigos de utilização única e tem um formato mais rigoroso.

Escolher a categoria errada é uma causa comum de rejeição. A linguagem promocional num template de utilidade é detetada de forma suficientemente consistente para não valer a pena tentar.

### Como funcionam as variáveis?

Marcadores numerados, preenchidos por ordem e contabilizados por componente.

Um corpo com o texto Olá {{1}}, a sua encomenda {{2}} foi expedida define duas variáveis, e o envio tem de fornecer exatamente dois valores para o corpo. Os parâmetros do cabeçalho e do botão são contabilizados separadamente, em vez de serem reunidos numa única lista. Por isso, um envio com o total correto pode ainda ser rejeitado.

A Meta também exige valores de exemplo quando um template é criado, para que o revisor veja o aspeto de uma mensagem real. Existem ainda regras de posicionamento: uma variável no início ou no fim da mensagem, ou variáveis a mais para a quantidade de texto envolvente, são rejeitadas.

### Por que motivo a aplicação do telemóvel não pode enviá-los num número de Coexistence?

Porque os templates são uma funcionalidade da plataforma, não da aplicação, e a aplicação não tem qualquer conceito de templates.

É uma das coisas mais úteis a saber desde cedo. Uma empresa ligada através da Coexistência mantém a sua equipa a responder a partir do telemóvel, e essa equipa pode responder em direto a qualquer mensagem. O que não pode fazer a partir da aplicação é reiniciar uma conversa que ficou inativa, porque isso requer um template, e os templates só existem através da API.

Assim, tudo o que seja agendado, transacional ou dirigido a alguém que não tenha escrito hoje é, por definição, trabalho da API. Para muitas empresas, é precisamente essa a lacuna que a ligação veio preencher.

- Criar um template e enviá-lo na mesma execução. A Meta revê-o primeiro, normalmente em minutos, mas por vezes num dia.
- Reunir as variáveis do cabeçalho e do corpo. São contabilizadas por componente.
- Usar linguagem de marketing num template de utilidade. É uma causa consistente de rejeição.

**Quanto tempo demora a revisão?** Normalmente, alguns minutos; por vezes, até um dia. Nenhum fornecedor a pode acelerar.

**Existe um template por idioma?** Sim. O nome e o idioma identificam um template em conjunto, pelo que o mesmo nome noutra localidade corresponde a um template diferente.

**Posso editar um template aprovado?** Sim, e a edição altera o contrato das variáveis, interrompendo os remetentes que tenham fixado o número antigo.

**Preciso de um método de pagamento?** Para envios de marketing, sim, na sua própria Conta WhatsApp Business. A Meta exige-o e nenhum fornecedor pode adicioná-lo por si.

---

## O webhook account_update e todos os motivos de desconexão

https://easycoexistence.com/pt-pt/docs/webhook-account-update

account_update é a forma como a Meta indica que uma ligação mudou de estado. O campo event indica o que aconteceu e, numa remoção, disconnection_info.reason indica o motivo. Esse motivo distingue um número que voltará de outro que foi perdido.

### Que eventos transporta account_update?

PARTNER_REMOVED, quando a aplicação é desinstalada da WhatsApp Business Account. Este é o sinal oficial de desconexão e aquele em que vale a pena basear a implementação, em vez de inferir uma desconexão a partir de um campo que passa a falso.

ACCOUNT_OFFBOARDED, quando o número é totalmente retirado. ACCOUNT_RECONNECTED, quando uma ligação anteriormente removida regressa. E os eventos de aplicação de medidas: ACCOUNT_RESTRICTION e ACCOUNT_VIOLATION, juntamente com eventos cujo nome inclui DISABLED ou BAN.

Os resultados de verificação e aprovação também chegam aqui, com nomes de eventos que contêm VERIFIED ou APPROVED. Um handler deve usar o nome do evento e tratar tudo o que não reconheça como informação, em vez de falhar, porque a Meta adiciona eventos sem aviso.

### Quais são os motivos de desconexão?

São seis, e significam coisas muito diferentes.

PRIMARY_INACTIVITY é a regra de aproximadamente catorze dias: a aplicação WhatsApp Business não foi aberta no dispositivo principal. É recuperável e, de longe, o caso mais comum.

COMPANION_INACTIVITY aplica a mesma ideia a um dispositivo complementar, num período mais longo de cerca de trinta dias.

BUSINESS_DOWNGRADE significa que o número voltou para a aplicação WhatsApp de consumidor, o que termina a Coexistência porque esta requer a aplicação Business.

CHANGE_NUMBER significa que o próprio número de telefone mudou. USER_RE_REGISTERED significa que foi registado novamente num dispositivo novo. E ACCOUNT_DISCONNECTED significa que o cliente o desligou deliberadamente ou que uma medida de aplicação o fez.

O motivo também chega com disconnection_info.initiated_by, que indica se foi uma pessoa ou o sistema a fazê-lo.

### Porque é que o motivo importa mais do que o evento?

Porque PARTNER_REMOVED, por si só, não indica qual deve ser a ação.

Um número removido por PRIMARY_INACTIVITY vai voltar: a empresa abre a aplicação, liga-o novamente e tudo retoma. Tratar isso como a saída de um cliente gera um email de cancelamento para alguém que continua a ser cliente.

Um número removido por BUSINESS_DOWNGRADE ou ACCOUNT_DISCONNECTED é uma situação diferente. Tratá-la como temporária deixa uma ligação num estado indefinido para sempre.

Quando uma remoção chega sem motivo, initiated_by é a alternativa: uma remoção feita por uma pessoa parece deliberada, enquanto uma remoção inexplicada do sistema não. Vale a pena distinguir estes casos no código, em vez de o fazer mais tarde numa conversa com o apoio ao cliente.

- Tratar todos os PARTNER_REMOVED da mesma forma. O motivo distingue duas semanas de silêncio da saída de um cliente.
- Inferir a desconexão a partir de um campo que passa a falso, em vez de usar este evento. É assim que surgem falsos alarmes.
- Falhar perante um nome de evento não reconhecido. A Meta adiciona eventos e um handler deve ignorar o que não conhece.

**PARTNER_REMOVED é permanente?** Normalmente, não. A maioria chega com PRIMARY_INACTIVITY, o que significa que a aplicação não foi aberta e que voltar a ligar restaura tudo.

**Voltar a ligar restaura o destino do meu webhook?** Não, e esta é a armadilha. O destino é uma substituição na subscrição da aplicação e é desinstalado com ela. É necessário voltar a aplicá-lo.

**O que é COMPANION_INACTIVITY?** A mesma ideia de inatividade num dispositivo complementar, e não no principal, durante um período mais longo de cerca de trinta dias.

**Posso receber este evento sem motivo?** Sim. Nesse caso, disconnection_info.initiated_by é o único sinal que indica se a remoção foi deliberada.

---

## O webhook phone_number_quality_update

https://easycoexistence.com/pt-pt/docs/webhook-phone-number-quality-update

phone_number_quality_update comunica alterações no throughput e no limite de mensagens de um número. Em 2026, não transporta a classificação de qualidade verde, amarela ou vermelha, apesar do nome; essa classificação tem de ser consultada diretamente no número.

### O que contém realmente este webhook?

Informação sobre o throughput e o limite de mensagens, entregue como um valor de evento e campos com o limite atual.

Na prática, o conteúdo indica que a capacidade de um número mudou: passou para outro escalão de mensagens ou o seu nível de throughput foi ajustado. É útil registar estas alterações porque mudam o que uma integração pode fazer e porque uma descida de escalão é um sinal precoce.

O que não está incluído, apesar do nome do campo, é a classificação de qualidade. Um processador baseado em documentação antiga procurará GREEN, YELLOW ou RED aqui e não encontrará nada, concluindo depois que a qualidade nunca muda.

### De onde vem então a classificação por cor?

Da leitura direta do número, segundo um calendário definido.

O campo quality_rating está no objeto do número de telefone na Graph API e tem de ser consultado periodicamente, em vez de se aguardar um evento. Por isso, a monitorização correta de uma ligação precisa tanto de um processo de consulta como de um recetor de webhook: os dois transportam informações diferentes e nenhum é suficiente por si só.

É também por isso que uma descida de qualidade passa despercebida na maioria das integrações. Nada a envia automaticamente, a aplicação WhatsApp Business não mostra qualquer indicação e, quando surge o erro 131048, os envios afetados já falharam.

- Procurar GREEN, YELLOW ou RED neste payload. Em 2026, não estão lá.
- Criar a monitorização apenas com webhooks. A classificação de qualidade tem de ser consultada.
- Ignorar uma descida de escalão. É normalmente o primeiro sinal visível de um problema.

**Porque se chama o campo assim, se é sobre qualidade?** O nome é anterior à alteração. Manteve-se enquanto o conteúdo mudou, e é por isso que este campo induz tantas pessoas em erro.

**Com que frequência deve ser consultada a classificação?** Com frequência suficiente para detetar uma descida antes de se tornar numa limitação. Fazemos consultas segundo um calendário, não a pedido.

**A aplicação mostra a classificação?** Não. A aplicação WhatsApp Business no telemóvel não mostra qualquer informação sobre ela.

**O 131048 está relacionado?** Sim. É o erro que um número começa a devolver quando uma classificação baixa resulta numa limitação.

---

## O webhook smb_message_echoes

https://easycoexistence.com/pt-pt/docs/webhook-smb-message-echoes

smb_message_echoes disponibiliza o que a sua equipa envia a partir da aplicação WhatsApp Business. Só existe em números com Coexistence, porque só estes permitem que uma pessoa envie mensagens pelo telemóvel enquanto o software as envia pela API.

### Porque é que este campo existe?

Porque Coexistence cria uma situação para a qual a API não foi originalmente concebida: duas entidades a enviar mensagens a partir do mesmo número.

Num número normal da Cloud API, o software é o único remetente, por isso não há nada a comunicar. Num número com Coexistence, a equipa continua a responder pelo telemóvel e, sem uma forma de ver isso, o software ficaria sem visibilidade sobre metade de cada conversa.

O eco resolve essa lacuna. Quando alguém escreve uma resposta na aplicação WhatsApp Business, ela chega ao seu endpoint como um evento, com a mesma estrutura de uma mensagem recebida, mas marcada como enviada pela empresa.

### O que acontece se o ignorar?

O cliente recebe duas respostas e a empresa parece desorganizada.

A sequência habitual é esta: um cliente faz uma pergunta às oito da manhã, alguém responde pelo telemóvel dentro de um minuto e uma automação que nunca viu essa resposta envia a mesma resposta três minutos depois. Para o cliente, é uma única empresa que não sabe o que já disse.

Tratá-lo não é complicado. Registe o eco na conversa, exatamente como faria com uma mensagem recebida, e verifique a atividade recente antes de enviar. O problema passa despercebido nos testes, porque uma conversa de teste não tem uma pessoa a responder.

- Tratar os ecos como ruído e descartá-los. São o único sinal de que uma pessoa já respondeu.
- Assumir que o campo existe em todos os números. É específico de Coexistence.
- Testar sem uma pessoa envolvida, que é precisamente o cenário em que o problema nunca aparece.

**Os ecos incluem conteúdo multimédia?** Comunicam o que foi enviado, incluindo referências a conteúdo multimédia, com a mesma estrutura das mensagens recebidas.

**Isto existe num número normal da Cloud API?** Não. Sem Coexistence, não há uma pessoa a enviar mensagens a partir de uma aplicação, por isso não há nada para ecoar.

**Posso desativá-lo?** Faz parte do percurso das mensagens. Encaminhar esse percurso para o seu endpoint inclui-o; ignorá-lo no código é uma escolha com consequências.

**Tem algum custo?** Não. É um evento de webhook, não um envio de mensagem.

---

## O webhook messages

https://easycoexistence.com/pt-pt/docs/webhook-messages

messages é o campo que transporta tudo o que um cliente envia para o seu número: texto, multimédia, respostas, reações e respostas interativas. Num número Coexistence encaminhado, segue da Meta diretamente para o seu endpoint e nunca passa por um fornecedor.

### O que o payload transporta

Uma ou mais mensagens numa única entrega, cada uma com o remetente, um id e um tipo. O tipo determina que outras chaves estão presentes.

- O número de telemóvel do remetente e o phone number id do número para o qual escreveu.
- Um id de mensagem wamid, que serve de base à eliminação de duplicados.
- Um carimbo de data e hora Unix.
- Um tipo: text, image, audio, video, document, sticker, location, contacts, reaction, button ou interactive.
- Nos tipos multimédia, um id de multimédia para obter o conteúdo, em vez dos próprios bytes.

### Porque nunca chega até nós num número encaminhado

Porque o override move este campo, juntamente com smb_message_echoes, para o destino que indicar.

A Meta permite que uma aplicação altere o local onde uma WhatsApp Business Account entrega os seus webhooks. Definimos esse override para o seu URL, retirando totalmente o percurso das mensagens da nossa infraestrutura. Não existe cópia, fila nem retenção do nosso lado, porque a entrega nunca chega lá.

Quando não é definido um destino, estes eventos recorrem ao nosso callback predefinido, onde o handler os descarta sem os persistir. Essa é a diferença entre uma afirmação sobre armazenamento e um caminho de código: não há qualquer local para onde o conteúdo das conversas possa ir.

### Como confirmar corretamente

Devolva 200 antes de fazer o trabalho, não depois.

A Meta considera uma resposta lenta uma falha e tenta novamente, o que significa que um handler que processe inline verá a mesma mensagem mais do que uma vez. Responda de imediato, coloque o payload numa fila ou tarefa em segundo plano e deixe o trabalho acontecer fora do pedido.

Em serverless, isto não é opcional. Uma função que termina e continua a trabalhar pode ser congelada no momento em que responde, pelo que a confirmação e o processamento têm de estar realmente separados.

### Eliminar duplicados

Sempre com base no wamid, porque as novas tentativas são normais e não excecionais.

A mesma mensagem pode chegar duas vezes por razões que nada têm que ver com um erro do seu lado: uma resposta lenta, um timeout de rede ou uma implementação durante a entrega. Guardar os ids já vistos e ignorar repetições requer poucas linhas e faz a diferença entre responder uma vez ou duas a um cliente.

Num número Coexistence, isto é ainda mais importante, porque smb_message_echoes chega pelo mesmo caminho e um handler que trate cada evento como novo responderá por cima de uma pessoa que já respondeu.

- Processar antes de devolver 200. A Meta repete uma resposta lenta e a mensagem é tratada duas vezes.
- Ignorar a eliminação de duplicados. As novas tentativas fazem parte do funcionamento normal, não são um caso raro.
- Esperar bytes de multimédia no payload. Este transporta um id de multimédia para obter o conteúdo.

**A EasyCoexistence vê as mensagens dos meus clientes?** Não. O override entrega este campo ao seu endpoint. Tudo o que chega ao nosso callback de recurso é descartado sem ser persistido.

**Podem chegar várias mensagens num único pedido?** Sim. Uma única entrega pode conter mais do que uma, pelo que os handlers devem percorrê-las em vez de lerem apenas a primeira.

**Como obtenho os conteúdos multimédia?** O payload transporta um id de multimédia. Use-o para obter o URL com o access token do número e, em seguida, transfira o conteúdo.

**O que é smb_message_echoes?** O campo complementar que transporta o que a sua equipa envia a partir da aplicação WhatsApp Business. Só existe em números Coexistence.

---

## O webhook phone_number_name_update

https://easycoexistence.com/pt-pt/docs/webhook-phone-number-name-update

phone_number_name_update transporta o resultado de uma submissão de nome de apresentação. O campo decision indica se a Meta aprovou ou rejeitou o nome, e este evento é o único local onde esse resultado é comunicado: nada sobre ele aparece na aplicação WhatsApp Business.

### O que comunica

O resultado de uma submissão de nome de apresentação, sob a forma de uma decisão no evento. Um nome é o que os clientes veem acima de uma conversa, e alterá-lo implica uma análise pela Meta.

O que torna este evento importante é que nada mais indica o que aconteceu. A aplicação WhatsApp Business não mostra nada, e uma empresa que submeteu uma alteração há semanas não tem forma de saber se foi aceite, a menos que alguém esteja a receber este evento.

Registá-lo numa linha temporal transforma a pergunta «a alteração do nosso nome foi aceite?» de uma conversa com o apoio ao cliente num facto datado.

### Porque é que um nome é rejeitado

Principalmente porque não corresponde à empresa como a qual a conta foi verificada.

- Um nome que corresponda à entidade legal, a uma designação comercial registada ou à marca no site tende a ser aceite.
- Uma descrição genérica, ou um nome sem ligação à empresa verificada, tende a ser rejeitado.
- Tudo o que pareça uma palavra-chave em vez de um nome é detetado de forma consistente.

### O que bloqueia a ausência de um nome

Determinados envios, que é como a maioria das pessoas descobre que o nome nunca foi aprovado.

Um número sem nome de apresentação aprovado devolve o erro 131037 em operações que exigem um. Para quem o encontra, essa falha parece ser um erro de código, porque tudo o resto no número funciona, e geralmente remonta a uma ligação de teste em que a etapa do nome foi ignorada e nunca foi retomada.

Submeter um nome faz parte de configurar corretamente um número, em vez de ser uma etapa meramente estética, e vale a pena fazê-lo no dia em que o número é ligado.

- Assumir que a ausência de notícias significa aprovação. A decisão chega aqui e em nenhum outro local.
- Submeter uma palavra-chave em vez de um nome. A Meta verifica-a face à empresa verificada.
- Ignorar o nome de apresentação durante um teste e deparar depois com o erro 131037 num envio que exige um.

**Quanto tempo demora a análise?** A Meta não publica um prazo fixo e nenhum fornecedor pode acelerá-la.

**Posso alterar o nome mais tarde?** Sim. Cada alteração volta a ser analisada e produz outro evento aqui.

**O cliente também vê o meu número?** Vê o nome de apresentação aprovado, que é precisamente a finalidade de ter um.

**O que é o erro 131037?** É o que um número devolve quando não tem um nome de apresentação aprovado e tenta executar algo que exige um.

---

## O webhook message_template_status_update

https://easycoexistence.com/pt-pt/docs/webhook-message-template-status-update

message_template_status_update comunica uma alteração no estado de revisão de um template: aprovado, rejeitado, pausado ou desativado. Permite que uma integração envie um template e receba o resultado, em vez de consultar a Meta periodicamente e tentar adivinhar com que frequência deve perguntar.

### Os estados que comunica

Um template passa por um pequeno conjunto de estados, e cada alteração chega aqui.

- Aprovado: o template pode ser enviado a partir desse momento.
- Rejeitado: não pode ser enviado, e o motivo acompanha o evento.
- Pausado: a qualidade baixou o suficiente para a Meta o suspender temporariamente.
- Desativado: pausas repetidas terminaram numa paragem permanente, sendo necessário um novo template.

### Porque dispensa consultas repetidas

A alternativa consiste em perguntar repetidamente e tentar adivinhar com que frequência.

Sem este evento, uma integração que cria um template tem de consultar get_template_status em intervalos regulares até a resposta mudar. Consultar demasiadas vezes é desperdício; consultar raramente faz com que um template aprovado permaneça uma hora sem que ninguém dê por isso.

Com este evento, o fluxo consiste em enviar e aguardar. A Meta envia o resultado, normalmente em poucos minutos, e a integração reage uma vez. Para uma agência que cria templates em nome de clientes, esta é a diferença entre uma fila que se esvazia sozinha e outra que alguém tem de acompanhar.

### O que fazer com cada resultado

Aprovado é simples: marque-o como apto para envio. Os outros três estados são onde está o valor.

Rejeitado inclui um motivo, que vale a pena apresentar literalmente em vez de resumir, porque normalmente é suficientemente específico para permitir agir e uma paráfrase pode omitir essa informação.

Pausado significa que o conteúdo provocou reações negativas, e reenviá-lo quando a pausa terminar produzirá o mesmo resultado. É um sinal para editar, não para esperar.

Desativado é definitivo para esse template. A única forma de avançar é criar outro com conteúdo diferente; tratá-lo como temporário deixa o percurso de envio interrompido indefinidamente.

- Consultar a aprovação quando este evento a comunica.
- Resumir o motivo da rejeição em vez de o apresentar. Os detalhes são o que permite agir.
- Esperar que um template desativado volte a funcionar. Esse estado é permanente e exige um novo template.

**Quanto tempo demora normalmente a aprovação?** Normalmente, alguns minutos; por vezes, até um dia. Nenhum fornecedor consegue acelerá-la.

**Um template pausado é igual a um desativado?** Não. A pausa termina depois de algum tempo; a desativação é permanente e resulta de pausas repetidas.

**Uma rejeição indica o motivo?** Sim, e o motivo é suficientemente específico para permitir agir, pelo que vale a pena transmiti-lo sem alterações.

**Posso continuar a enviar outros templates enquanto um está pausado?** Sim. O estado aplica-se a esse template, não ao número.

---

## O webhook message_template_quality_update

https://easycoexistence.com/pt-pt/docs/webhook-message-template-quality-update

message_template_quality_update comunica uma alteração na forma como os destinatários reagem a um determinado template. Chega antes de a qualidade provocar uma suspensão, dando tempo para agir, em vez de explicar uma falha depois de acontecer.

### O que mede

A forma como as pessoas reagem às mensagens enviadas com um determinado template, e não ao número como um todo. Os bloqueios e as denúncias têm mais peso, mas a falta total de interação também conta.

Esta abrangência por template é o que o torna útil. Um número pode estar saudável no geral, enquanto um template prejudica discretamente o seu próprio público. Este é o evento que distingue as duas situações. Sem ele, o primeiro sinal é o template deixar de ser enviado, enquanto tudo o resto no número funciona normalmente.

### Por que é essencial agir cedo

Porque todos os estados seguintes são piores e mais difíceis de reverter.

Uma descida de qualidade suficientemente acentuada suspende o template, devolvendo o erro 132015 em cada tentativa. A suspensão só desaparece depois de um período que a Meta não publica. Suspensões repetidas desativam-no permanentemente; nessa altura, o conteúdo tem de ser reconstruído como um novo template, com outro nome.

Receber um sinal de qualidade enquanto o template ainda é enviado é o único momento em que editar não tem custos. Depois da suspensão, editar continua a ser a decisão certa, mas o caminho de envio já foi interrompido durante o tempo em que ninguém o detetou.

### O que costuma causá-lo

O conteúdo e o público, por esta ordem, sendo o segundo o fator que as pessoas mais esquecem.

- Linguagem promocional num template declarado como utilitário, que os destinatários não esperavam.
- Uma mensagem que não deixa claro qual é a empresa que escreve.
- Enviar para uma lista, em vez de enviar para pessoas que interagiram recentemente.
- O mesmo template ser enviado em volume para um público que nunca o pediu.

- Tratá-lo como meramente informativo. É o último sinal que chega enquanto o template ainda funciona.
- Interpretá-lo como um problema do número. Abrange um único template.
- Editar o texto e manter o mesmo público. O destinatário produz os mesmos sinais que o conteúdo da mensagem.

**Isto afeta os meus outros templates?** Não. O sinal abrange um único template, e os restantes no mesmo número não são afetados.

**Posso ver isto na aplicação?** Não. A qualidade dos templates não aparece na aplicação WhatsApp Business do telemóvel.

**O que acontece se o ignorar?** A qualidade continua a diminuir, o que suspende o template; suspensões repetidas desativam-no permanentemente.

**Editar o texto é suficiente?** Muitas vezes, mas não sempre. O destinatário do template produz os mesmos sinais que o conteúdo da mensagem.

---

## O webhook history

https://easycoexistence.com/pt-pt/docs/webhook-history

history transporta para a API a transferência única das conversas existentes de um número Coexistence. Chega após a integração inicial, quando a partilha do histórico foi aceite, e é o único sinal de que a transferência ocorreu.

### O que entrega

O histórico de mensagens um para um que um número já tinha na aplicação WhatsApp Business é transferido para que o software não comece às cegas numa linha que a empresa utiliza há anos.

As conversas de grupo não são transferidas: estão totalmente excluídas da API num número Coexistence. Também não são transferidas as ferramentas da aplicação: etiquetas, respostas rápidas e mensagens de saudação e ausência não têm equivalente na API e permanecem no dispositivo.

Este campo existe apenas em números Coexistence. Um número integrado da forma normal não tem histórico anterior da aplicação para transferir, pelo que nada há para entregar.

### Porque só é enviado uma vez

Porque a transferência faz parte da integração inicial, não é uma capacidade contínua.

Durante o Embedded Signup, pergunta-se ao proprietário da empresa se pretende partilhar as conversas existentes. Responder afirmativamente permite executar a sincronização. Depois, não existe nenhuma definição para a reativar nem nenhum endpoint que a repita. Uma segunda tentativa devolve 2593107, em vez de aguardar por um limite de pedidos que desapareça.

Existe também um prazo. A sincronização tem de começar nas 24 horas seguintes à integração inicial; uma tentativa posterior devolve 2593108. Falhar qualquer uma destas condições implica desligar o número e repetir todo o processo.

### O que um handler deve fazer com ele

Trate-o como um lote que chega uma vez e pode ser grande, não como mais tráfego no percurso das mensagens.

- Confirme rapidamente e processe de forma assíncrona, como qualquer outra entrega.
- Elimine duplicados com base em message id: as mensagens history e as mensagens em tempo real podem sobrepor-se no momento da integração inicial.
- Conte com a possibilidade de estar ausente. Um número cujo proprietário recusou o histórico não envia nada neste campo, e a integração tem de funcionar de qualquer forma.
- Não bloqueie a integração inicial à espera dele. A ligação pode ser utilizada antes de a transferência terminar.

- Criar uma integração que exige a existência de histórico. Muitos números ligam-se sem ele.
- Tentar novamente a sincronização após 2593107. É um evento único, pelo que a nova tentativa devolve o mesmo erro.
- Adiar a decisão sobre o histórico até ao início do trabalho de integração, o que normalmente acontece depois de terminar a janela de 24 horas.

**Quanto histórico chega?** Uma janela de conversas um para um recentes, definida pela Meta e não por um fornecedor.

**As conversas de grupo são transferidas?** Não. Os grupos estão totalmente excluídos da API num número Coexistence.

**Posso pedi-lo novamente mais tarde?** Não. É executado uma vez por integração inicial; executá-lo novamente implica desligar e voltar a ligar o número.

**E se o proprietário recusar o histórico?** Nada chega neste campo, e a API vê apenas as mensagens recebidas a partir do momento em que o número foi ligado.

---

## O webhook smb_app_state_sync

https://easycoexistence.com/pt-pt/docs/webhook-smb-app-state-sync

smb_app_state_sync transporta o estado da própria aplicação WhatsApp Business, sobretudo a sincronização de contactos feita quando se liga um número de Coexistência. É separado de history, que transporta conversas, e existe apenas em números de Coexistência.

### O que transporta

Estado do lado da aplicação, que na prática significa os contactos que uma empresa já tinha no telemóvel.

Todos os contactos com um número WhatsApp podem ser sincronizados com a plataforma. Isto permite ao software reconhecer um cliente que está há anos no telemóvel da empresa, em vez de o tratar como um número novo. É diferente das próprias conversas, que chegam no campo history. Os dois são separados porque um é um diretório e o outro é uma transcrição.

Tal como history, este campo só existe na Coexistência. Não há estado da aplicação para sincronizar num número que nunca esteve numa aplicação.

### O que não transporta

As ferramentas de trabalho da própria aplicação, que não têm representação do lado da plataforma.

- Etiquetas, que ficam no dispositivo e não podem ser lidas pelo software.
- Respostas rápidas e mensagens de saudação e de ausência.
- O catálogo, as encomendas e o estado.
- Canais e histórico de chamadas de voz ou vídeo.

### Porque é importante para uma integração

Porque determina se o seu sistema sabe quem está a escrever desde o primeiro dia.

Sem a sincronização de contactos, cada mensagem recebida chega como um número de telefone sem nome associado, e cabe-lhe relacioná-lo com um registo de cliente. Com a sincronização, a própria lista de contactos da empresa fica disponível e a correspondência está praticamente feita.

Vale a pena planear para os dois cenários, porque uma empresa pode recusar a sincronização ou perder a janela. Uma integração que presuma a existência de contactos mostrará uma parede de números sem nome a quem a abrir.

- Pressupor que os contactos estarão disponíveis. Uma empresa pode recusar a sincronização ou perder a janela.
- Esperar etiquetas ou respostas rápidas neste payload. Permanecem no dispositivo.
- Confundir este campo com history, que transporta conversas e não a lista de contactos.

**É o mesmo que a sincronização de history?** Não. Este campo transporta o estado da aplicação, sobretudo contactos. history transporta as conversas.

**É executado mais do que uma vez?** A sincronização inicial ocorre uma única vez durante a integração, com a mesma janela de 24 horas que history.

**Recebo as etiquetas?** Não. As etiquetas são uma funcionalidade da aplicação sem equivalente na API.

**Existe num número normal da Cloud API?** Não. Não há estado da aplicação WhatsApp Business para sincronizar num número desse tipo.

---

## O webhook template_category_update

https://easycoexistence.com/pt-pt/docs/webhook-template-category-update

O template_category_update indica que a Meta recategorizou um template, movendo-o entre utilidade, marketing e autenticação. Isto importa porque a categoria determina o que a Meta cobra por uma conversa, pelo que uma recategorização altera os custos sem que alguém edite alguma coisa.

### Porque muda uma categoria por si só

Porque a Meta analisa o que um template diz realmente, e não apenas aquilo que foi declarado.

Um template submetido como utilidade que inclui uma oferta é conteúdo promocional com um rótulo mais barato. Por vezes, isso é detetado durante a análise e rejeitado. Outras vezes, é aprovado e recategorizado mais tarde, depois de o conteúdo ter sido utilizado, e é esse segundo caso que este evento regista.

Nada do seu lado o desencadeia. O template não muda, o código não muda e o primeiro sinal sem este evento é uma fatura que não corresponde à previsão.

### O que muda

O preço de todas as conversas que esse template iniciar a partir desse momento.

- A Meta aplica preços diferentes às conversas de utilidade, marketing e autenticação.
- Os envios de marketing exigem também um método de pagamento na conta WhatsApp Business.
- Um template recategorizado como marketing numa conta sem método de pagamento começa a devolver 131042.
- O template continua a funcionar; o que muda é o custo e aquilo que passa a exigir.

### Como evitar a recategorização

Declare honestamente, pois isso fica mais barato do que otimizar.

Um template de utilidade descreve algo que o cliente fez: uma encomenda, uma reserva ou uma entrega. Se uma mensagem não existiria sem uma ação do cliente, é utilidade. Se existe porque pretende vender algo, é marketing, e declará-la como tal custa menos do que ser movida para essa categoria mais tarde, num momento que não escolheu.

Submeter repetidamente templates com categorias incorretas também chama a atenção para a própria conta, o que é pior do que pagar a tarifa de marketing numa mensagem de marketing.

- Declarar conteúdo promocional como utilidade para pagar menos. A recategorização chega mais tarde e num momento pior.
- Ignorar este evento. Altera a faturação sem mudar nada sob o seu controlo.
- Assumir que a aprovação é definitiva. Um template pode ser aprovado e movido posteriormente.

**O template deixa de funcionar?** Não. Continua a enviar; o que muda é o preço da conversa e, no caso do marketing, a exigência de um método de pagamento.

**Posso contestar uma recategorização?** A Meta trata as contestações de categorias através dos seus próprios canais; nenhum fornecedor pode alterar uma categoria.

**Qual é a categoria mais barata?** A Meta aplica preços diferentes por mercado. A categoria correta mais barata é a que descreve honestamente a mensagem.

**O que é 131063?** Templates de marketing desativados na conta, o que é diferente de não ter um método de pagamento.

---

## Meta Business Portfolio e o que contém

https://easycoexistence.com/pt-pt/docs/meta-business-portfolio

Um Business Portfolio é o contentor ao nível da empresa no Meta Business Manager. Contém Contas WhatsApp Business, que contêm números de telefone. Quando um cliente liga um número, este permanece no seu portefólio, em vez de passar para o de um prestador.

### Como se relacionam os níveis?

São três níveis, e chamar conta a todos é onde começa a maior parte da confusão.

O Business Portfolio está no topo, representando a empresa no Meta Business Manager. Contém recursos: contas de anúncios, páginas e Contas WhatsApp Business. Dentro de uma Conta WhatsApp Business estão os números de telefone, cada um com o seu próprio phone number id, classificação de qualidade e nível de mensagens.

Por isso, uma frase como verificar se a conta está a funcionar pode significar quatro verificações diferentes, dependendo de quem a diz. Quando algo está errado, ser preciso sobre o nível a que se refere poupa a maior parte do tempo de diagnóstico.

### Porque importa de quem é o portefólio que contém o número?

Porque determina quem controla realmente a ligação.

Quando o onboarding é feito através da própria aplicação de um Tech Provider, o número é ligado no portefólio do cliente, com a aplicação do prestador autorizada a agir sobre ele. A relação com a Meta pertence ao cliente, a faturação das conversas é feita através do método de pagamento do cliente e este pode revogar o acesso.

Quando as ferramentas são construídas sobre a conta de um prestador diferente, os números ficam associados de outra forma, e os limites atingidos nas plataformas de automação de uso geral resultam dessa relação partilhada. Para uma agência, esta é a resposta a uma pergunta que todos os clientes sérios acabam por fazer.

- Usar portefólio e WABA como se fossem a mesma coisa. Um contém o outro, e os problemas de cada um são diferentes.
- Ligar números de clientes no seu próprio portefólio. Isso faz com que a ligação seja sua, e não do cliente.
- Assumir que a verificação da empresa está associada ao número. Está ao nível do portefólio.

**Um portefólio é o mesmo que uma Conta WhatsApp Business?** Não. O portefólio é o contentor da empresa; a WABA está dentro dele e contém os números de telefone.

**Um portefólio pode conter várias WABAs?** Sim, e as agências deparam-se frequentemente com esta situação quando um cliente tem contas separadas para marcas diferentes.

**Quem pode conceder acesso a um portefólio?** Um administrador desse portefólio, que normalmente é o titular da empresa, e não quem está a fazer a integração.

**Ligar o número faz com que ele mude de portefólio?** Não. Permanece no seu portefólio, com a aplicação do prestador autorizada a agir sobre ele.

---

## A conta WhatsApp Business e por que as substituições vivem nela

https://easycoexistence.com/pt-pt/docs/whatsapp-business-account

Uma conta WhatsApp Business contém números de telefone e templates. É mais importante do que parece, porque o encaminhamento do webhook se aplica aqui, e não por número. Por isso, ao remover uma ligação, o encaminhamento é removido com ela.

### O que contém realmente uma WABA?

Números de telefone e templates, uma combinação mais importante do que parece à primeira vista.

Os templates pertencem à conta, e não a um número, por isso todos os números na mesma WABA partilham a mesma biblioteca de templates. Crie um para atualizações de encomendas e todos podem enviá-lo. A Meta limita o número de templates numa conta, um limite que as agências com muitas marcas numa só conta podem atingir.

Cada número tem o seu próprio phone number id, nome de apresentação, classificação de qualidade e nível de mensagens. Estes dados são específicos de cada número, por isso um pode degradar-se enquanto outro na mesma conta continua saudável.

### Por que razão as substituições de webhook vivem neste nível?

Porque a subscrição que modificam é a subscrição de uma aplicação a uma conta, e não a um número.

Quando se define um destino, o que acontece realmente é a aplicação de uma `override callback URI` à subscrição da nossa aplicação a essa WABA. Todos os números da conta passam então a entregar aí os eventos do percurso das suas mensagens. Não existe encaminhamento por número, o que surpreende quem gere vários números para o mesmo cliente.

A consequência é a que importa planear. Quando uma ligação é removida, pela regra dos catorze dias de inatividade ou por outro motivo, a aplicação é desinstalada da conta e a substituição é desinstalada com ela. O envio e a monitorização regressam quando a ligação é restabelecida. A entrega no seu próprio servidor não regressa, a menos que algo volte a aplicar a substituição.

- Esperar um encaminhamento de webhook por número. A substituição é por conta.
- Assumir que uma nova ligação restaura o destino. A substituição é desinstalada com a aplicação e tem de ser reaplicada.
- Esquecer que os templates são partilhados. Todos os números da conta veem a mesma biblioteca.

**Dois números na mesma WABA podem encaminhar para endpoints diferentes?** Não. A substituição aplica-se à conta, por isso todos os números entregam no mesmo destino.

**Os templates são transferidos entre contas?** Não. Pertencem à conta em que foram criados.

**O que acontece à substituição quando um número é removido?** Se a aplicação for desinstalada da conta, a substituição é removida com ela. Restabelecer a ligação recupera o envio, mas não o destino.

**Existe um limite de templates?** A Meta limita os templates por conta e, se esse limite for ultrapassado, é devolvido um erro específico.

---

## Verificação em dois passos num número WhatsApp

https://easycoexistence.com/pt-pt/docs/two-step-verification

A verificação em dois passos é um PIN definido num número de telefone do WhatsApp Business. Algumas operações exigem-no e, como normalmente é definido uma vez durante a integração e nunca mais utilizado, o problema comum é ninguém na empresa se lembrar dele.

### Quando é realmente necessário o PIN?

Durante o registo e o novo registo de um número, e em determinadas operações da conta protegidas pela Meta.

Isto significa que a maioria das empresas o define durante a integração e nunca mais o vê, precisamente por isso se torna um problema. A pessoa que o definiu muda de funções, o PIN nunca foi registado em lado nenhum e é necessário dezoito meses mais tarde, exatamente quando algo já está avariado.

Os erros associados são suficientemente específicos para permitir um diagnóstico. Um PIN incorreto devolve 133005. Demasiadas tentativas devolvem 133008 e bloqueiam novas tentativas durante o período indicado na resposta. Tentativas submetidas demasiado depressa devolvem 133009, que é um limite de frequência e não uma resposta errada.

### O que fazer quando o PIN se perde?

Reponha-o no WhatsApp Manager, nas definições do número, o que exige acesso à conta que o detém.

Esta é uma operação do proprietário da empresa, não do fornecedor. Nenhuma API pode ler ou repor um PIN e nenhum fornecedor o guarda, por definição: uma credencial que um fornecedor pudesse recuperar não seria um segundo fator.

O conselho prático é registá-lo num local que a própria empresa consiga consultar, e não apenas a agência. Um PIN guardado unicamente no gestor de palavras-passe de uma agência cria exatamente o mesmo problema quando a relação com o cliente muda.

- Voltar a tentar rapidamente depois de um PIN incorreto. Isso devolve 133009 e adia a próxima tentativa legítima.
- Guardar o PIN apenas do lado da agência. A empresa tem de conseguir recuperá-lo por si própria.
- Partir do princípio de que um fornecedor o pode recuperar. Ninguém o guarda, que é precisamente a razão da sua existência.

**Pode repor o meu PIN?** Não. É definido no número, nas próprias definições da Meta, e nenhum fornecedor pode lê-lo ou alterá-lo.

**Quanto tempo dura um bloqueio?** A Meta indica o tempo de espera na resposta de erro para 133008, em vez de utilizar um período fixo.

**O PIN é por número ou por conta?** Por número de telefone.

**É o mesmo que a verificação da empresa?** Não. A verificação diz respeito à entidade legal ao nível do portefólio; este é um PIN associado a um número.

---

## O webhook account_review_update

https://easycoexistence.com/pt-pt/docs/webhook-account-review-update

account_review_update transporta o resultado de uma revisão da conta empresarial pela Meta. O campo decision indica a decisão tomada, e uma rejeição deve ser tratada como uma ligação degradada, não apenas como informação, porque os envios costumam diminuir depois disso.

### Quando ocorre uma revisão?

Quando a Meta analisa a conta empresarial, o que pode acontecer após o envio de dados para verificação, um recurso ou uma sinalização automática suscitada pelo comportamento das mensagens.

A revisão em si não é algo que um fornecedor desencadeie ou consiga acompanhar internamente. O que chega é o resultado, como um evento com uma decisão. As aprovações passam despercebidas. As rejeições são as que justificam uma ação, porque muitas vezes precedem uma restrição em vez de encerrarem o assunto.

Nada relacionado com uma revisão é visível na aplicação WhatsApp Business. Assim, uma empresa pode estar sob revisão, ser rejeitada e continuar a responder aos clientes pelo telemóvel sem qualquer indicação de que algo aconteceu.

### Porque tratar uma rejeição como degradação e não como simples notícia?

Porque costuma ser o primeiro de vários eventos, e não o último.

Uma revisão rejeitada significa que a Meta analisou a conta e não ficou satisfeita. O que se segue é frequentemente uma restrição, que interrompe totalmente os envios e chega como um account_update com um evento de aplicação de medidas. Marcar a ligação como degradada no momento da rejeição permite a quem acompanha o caso antecipar a conversa com o cliente.

Registá-la como informação significa que a primeira ação só ocorre quando os envios começam a falhar. Nessa altura, a empresa já não consegue contactar os clientes e a conversa começa com uma crise, em vez de começar com um aviso.

- Registar uma rejeição sem alterar o estado. É um indicador antecipado, não uma nota secundária.
- Esperar encontrar o motivo neste evento. Transporta a decisão; os detalhes estão no Business Manager.
- Presumir que a empresa dará por isso. Nada relacionado com uma revisão aparece no telemóvel.

**Um fornecedor consegue ver porque falhou a revisão?** Não. O aviso de aplicação de medidas e a respetiva justificação estão no Business Manager da conta empresarial.

**Uma rejeição conduz sempre a uma restrição?** Nem sempre, mas acontece com frequência suficiente para que o tratamento como aviso seja a predefinição adequada.

**Quem pode recorrer?** As pessoas com acesso de administrador à conta empresarial. Nenhum fornecedor pode recorrer em nome delas.

**É o mesmo que uma revisão de template?** Não. Os resultados da revisão de template chegam separadamente e dizem respeito a um template, não à conta.

---

## O webhook business_capability_update

https://easycoexistence.com/pt-pt/docs/webhook-business-capability-update

business_capability_update comunica uma alteração ao que a conta pode fazer, sobretudo ao limite de mensagens. Inclui o limite atual, ou seja, quantos clientes únicos se podem contactar para iniciar conversas por dia. Pode subir ou descer.

### O que limita realmente o limite de mensagens?

Quantos clientes únicos se podem contactar para iniciar uma conversa num período móvel de 24 horas. Não limita o número de mensagens que se podem enviar, nem a rapidez.

Esta distinção causa problemas. O throughput é uma taxa, medida por segundo, e excedê-la devolve 130429. O nível de mensagens é uma contagem diária de novas conversas, e excedê-lo é uma condição diferente. Um número pode estar bem dentro do seu nível e, ainda assim, sofrer limitação de taxa, ou o contrário.

As respostas dentro de uma janela aberta de atendimento ao cliente não consomem o nível, porque não iniciam uma conversa. O que o consome é contactar alguém que ainda não escreveu.

### Porque desce?

Porque o nível acompanha a qualidade, e a qualidade depende da reação dos destinatários.

Um número cujos destinatários bloqueiam ou denunciam mensagens perde reputação, e o nível é uma das coisas que se ajustam. Por isso, uma descida é um sinal antecipado útil: normalmente chega antes de algo deixar de funcionar, quando ainda há tempo para mudar o que se envia e a quem.

A subida é mais lenta e conquista-se com uma receção positiva consistente. Nenhuma das direções é anunciada num local que uma empresa possa consultar, pelo que vale o pequeno esforço de registar este evento, em vez de reagir apenas às falhas.

- Confundir o nível com o throughput. Um corresponde a conversas por dia; o outro, a mensagens por segundo.
- Contar as respostas para o nível. As mensagens dentro de uma janela aberta não iniciam uma conversa.
- Ignorar uma descida. Ela chega antes de algo falhar, e esse é precisamente o seu valor.

**Como aumento o meu nível?** Ele acompanha a qualidade ao longo do tempo, não um pedido. Enviar mensagens relevantes a quem as quer receber é o mecanismo.

**Um envio de template consome sempre o nível?** Um template que inicia uma conversa consome-o. Um enviado dentro de uma janela aberta não.

**messaging_limit_update é diferente?** A Meta envia os dois nomes para alterações relacionadas. O nosso processador trata-os da mesma forma porque o conteúdo útil é igual.

**Isto aplica-se a um número Coexistence?** Sim. O que é fixo na Coexistence é o throughput, não o nível de mensagens.

---

## O webhook account_alerts

https://easycoexistence.com/pt-pt/docs/webhook-account-alerts

account_alerts é o canal geral da Meta para assinalar algo sobre uma conta empresarial. Ao contrário dos outros eventos, não transporta um estado a aplicar, pelo que é um aviso para verificar, não algo a que se deva reagir automaticamente.

### O que chega neste canal?

Tudo o que a Meta considere digno de ser assinalado sobre a conta. O conteúdo é deliberadamente aberto e tem aumentado ao longo do tempo.

Como o conteúdo não é um conjunto fixo, um processador escrito para reagir a tipos específicos de alerta não reconhecerá os novos. A abordagem duradoura é registar o alerta, associá-lo à conta e apresentá-lo a uma pessoa, em vez de mapear cada variedade para uma resposta automática.

Este é o único evento operacional em que o tratamento honesto consiste em reparar, não decidir. O nosso próprio processador regista a chegada de um alerta e não tenta inferir um estado a partir dele.

### Como deve integrar-se na monitorização?

Como um aviso numa linha temporal, junto dos eventos que transportam um estado.

O valor está na sequência. Um alerta que chega pouco antes de uma revisão rejeitada e, depois, de uma restrição conta uma história que nenhum dos três eventos conta sozinho. Registá-los numa única linha temporal torna isso visível e transforma uma conversa com um cliente, que seria baseada em suposições, numa conversa baseada numa data e num evento.

O que não deve fazer é desencadear nada. Um alerta não é uma desligação, uma queda de qualidade nem uma restrição. Tratá-lo como qualquer uma dessas situações gera falsos alarmes e ensina as pessoas a ignorar os verdadeiros.

- Reagir a tipos específicos de alerta. O conjunto aumenta e um processador baseado na lista de hoje fica desatualizado.
- Desencadear automatizações a partir de um alerta. Como não transporta um estado, qualquer inferência é uma suposição.
- Ignorá-lo por não ser acionável. O seu valor está na sequência que forma com os outros eventos.

**Porque não altera o estado da minha ligação?** Porque não indica o que mudou. Inferir um estado a partir dele geraria falsos alarmes.

**Onde vejo os detalhes?** No Business Manager, na conta empresarial. O evento é um aviso para os consultar aí.

**É raro?** Não é um evento rotineiro, o que reforça a importância de o apresentar quando chega.

**Significa que há algo errado?** Não necessariamente. Significa que a Meta assinalou algo que merece a atenção de uma pessoa, não uma resposta automática.

---

## Nomes de apresentação num número WhatsApp Business

https://easycoexistence.com/pt-pt/docs/display-names

O nome de apresentação é o que os clientes veem acima de uma conversa com o seu número. Alterá-lo requer a aprovação da Meta, a decisão chega através do phone_number_name_update webhook e as rejeições devem-se geralmente ao nome não corresponder à empresa.

### O que verifica a Meta?

Sobretudo, se o nome corresponde à empresa como a qual a conta foi verificada.

Um nome que corresponda à entidade legal, a uma designação comercial registada ou à marca que um cliente reconheceria no site tende a ser aprovado. Uma descrição genérica, um nome sem ligação à empresa verificada ou algo que pareça uma palavra-chave em vez de um nome tende a ser rejeitado.

Um número sem um nome de apresentação aprovado tem capacidades limitadas e devolve um erro específico em determinados envios. Isto apanha quem ligou rapidamente um número durante um teste e nunca concluiu o nome, perguntando depois por que razão uma categoria de envio falha enquanto as outras funcionam.

### Como chega a decisão?

Através do phone_number_name_update webhook, que transporta um campo de decisão.

Este é um dos seis campos operacionais a que uma ligação subscreve e é o único sinal de que um nome submetido foi resolvido. Nada disso aparece na aplicação WhatsApp Business, e uma empresa que submeteu uma alteração de nome há semanas não tem forma de saber o resultado, a menos que alguém esteja a receber esse evento.

Registá-lo na linha temporal da ligação significa que a resposta à pergunta «a alteração do nosso nome foi concluída?» é uma data, e não um palpite. Caso contrário, esta questão transforma-se facilmente numa conversa com o apoio ao cliente.

- Submeter uma palavra-chave em vez de um nome. A Meta verifica-a face à empresa verificada, não face ao volume de pesquisa.
- Assumir que a ausência de novidades significa aprovação. A decisão chega como webhook e não aparece noutro local.
- Ignorar o nome de apresentação durante um teste e depois receber o erro 131037 num envio que requer um.

**Quanto tempo demora a aprovação?** A Meta não publica um prazo fixo e nenhum fornecedor o pode acelerar.

**Posso alterá-lo mais tarde?** Sim, e cada alteração passa novamente por revisão.

**O que é o erro 131037?** É o erro devolvido quando um número não tem um nome de apresentação aprovado e tenta fazer algo que requer um.

**O cliente também vê o meu número de telefone?** Vê o nome de apresentação depois de aprovado, que é precisamente a razão para ter um.

---

## Categorias de templates: utilidade, marketing e autenticação

https://easycoexistence.com/pt-pt/docs/template-categories

Cada template declara uma categoria quando é criado. A categoria Utility abrange mensagens transacionais ligadas a uma ação do cliente, Marketing abrange promoções e exige um método de pagamento na conta, e Authentication abrange códigos de utilização única, com regras de formato próprias e mais rigorosas.

### O que inclui cada categoria?

Utility é transacional e está ligada a uma ação realizada pelo cliente: uma confirmação de encomenda, uma atualização de envio, um lembrete de reserva ou uma alteração de marcação. O teste decisivo é saber se o cliente esperaria receber a mensagem por causa de algo que fez.

Marketing é qualquer conteúdo promocional: uma oferta, um produto novo, uma mensagem de reativação ou um boletim informativo. Para enviar uma destas mensagens, é necessário um método de pagamento na WhatsApp Business Account. Por isso, a primeira tentativa de marketing numa conta que só respondeu a clientes costuma falhar.

Authentication abrange códigos de utilização única e verificação. Tem o formato mais rigoroso, com limitações apertadas sobre o que pode acompanhar o código, e existe como categoria própria porque as expectativas de entrega são diferentes.

### Porque não declarar tudo como utility?

Porque a Meta reclassifica, e ser reclassificado é pior do que declarar com rigor.

O conteúdo promocional num template utility é detetado de forma consistente. O template é rejeitado na análise ou aprovado e recategorizado mais tarde. Nesse momento, os envios que eram cobrados como utility passam a ser cobrados como marketing sem que ninguém altere nada. Isso surge como uma surpresa na fatura, não como uma poupança.

O envio repetido de templates com categorias incorretas também chama a atenção para a própria conta. A opção mais barata é declarar aquilo que a mensagem realmente é. Isso também torna a análise mais rápida, porque o revisor verifica o conteúdo que o template diz ser.

- Colocar uma oferta num template utility. É detetado de forma consistente e pode ser recategorizado depois da aprovação.
- Tentar enviar uma mensagem de marketing sem método de pagamento na conta. A Meta exige um e nenhum fornecedor pode adicioná-lo.
- Usar authentication para algo que não seja um código de acesso. As limitações de formato são rigorosas e o template não será aprovado.

**Quem paga um envio de marketing?** A Meta cobra-o ao método de pagamento da sua própria WhatsApp Business Account. O valor nunca passa por nós.

**Um template pode mudar de categoria?** A Meta pode recategorizá-lo depois da aprovação se o conteúdo não corresponder ao que foi declarado.

**Utility é gratuito?** As conversas utility têm preços definidos pela Meta e não são iguais às respostas dentro da janela de serviço ao cliente, que são gratuitas.

**O que é o erro 131063?** Templates de marketing desativados na conta, o que é diferente de não existir um método de pagamento.

---

## Um número deixou de funcionar: como descobrir porquê

https://easycoexistence.com/pt-pt/docs/troubleshooting-a-connection

Quando um número ligado deixa de funcionar, a causa quase nunca está no código. Verifique pela ordem de frequência: um token expirado, uma substituição do webhook perdida numa nova ligação, uma desligação após catorze dias de inatividade, uma queda de qualidade e, por fim, uma restrição da conta.

### Porque é que nada parece estar errado no telemóvel?

Porque a aplicação WhatsApp Business e a API são interfaces separadas no mesmo número, e quase todas as falhas afetam apenas uma delas.

Um token expira e a aplicação permanece intacta. Uma substituição do webhook é desinstalada e a aplicação permanece intacta. A qualidade baixa e a aplicação permanece intacta. Em todos os casos, a empresa continua a responder aos clientes, vê um comportamento normal e não tem motivo para comunicar qualquer problema.

Este é todo o argumento a favor da monitorização, em vez de um painel que alguém verifica. As falhas são reais, silenciosas, e as pessoas mais próximas do número são as menos propensas a detetá-las.

### Por que ordem deve verificar?

Comece pelo token, porque é a causa mais comum e a mais barata de corrigir. Uma credencial expirada ou invalidada faz com que todos os pedidos falhem da mesma forma, parecendo exatamente que o número foi removido. Manter uma segunda credencial na mesma conta é o que permite distinguir os dois casos.

Depois, verifique a substituição do webhook. Se tiver ocorrido uma nova ligação, o destino foi desinstalado com a aplicação; por isso, o envio e a monitorização funcionam, mas a entrega ao seu servidor deixa silenciosamente de funcionar.

Depois, verifique uma desligação: um evento account_update com PARTNER_REMOVED e um motivo, em que PRIMARY_INACTIVITY significa que a aplicação ficou cerca de catorze dias sem ser aberta e que uma nova ligação resolve o problema.

Depois, verifique a qualidade, que é consultada em vez de enviada, e, por fim, uma restrição, que é uma medida aplicada ao nível da conta e que nenhum fornecedor pode remover.

### O que quase nunca é a causa?

O seu código, se estava a funcionar ontem e nada foi implementado.

A Cloud API é estável e os formatos dos seus pedidos não mudam sem aviso. Quando uma integração que funcionou durante meses deixa de funcionar, a probabilidade esmagadora aponta para uma credencial, uma alteração de encaminhamento ou um evento ao nível da conta, tudo situações que podem ocorrer sem ninguém tocar num repositório.

A exceção que vale a pena mencionar é um template editado. Alterar o número de variáveis de um template muda o contrato para cada remetente, silenciosamente, e pode parecer uma falha de código, embora seja uma alteração de conteúdo feita por outra pessoa no WhatsApp Manager.

- Voltar a ligar o número primeiro. Se um token expirou, isso pede ao responsável pela empresa um trabalho que nunca foi necessário.
- Assumir que o código deixou de funcionar. Uma API estável e a ausência de uma implementação apontam para outro lado.
- Verificar o telemóvel à procura de sintomas. A aplicação continua a funcionar durante quase todos estes casos.

**O número funciona no telemóvel, mas nada é enviado. Por onde começo?** Pelo token de acesso. É a causa mais comum e a que mais se parece com um número removido.

**Voltei a ligar o número, mas as mensagens continuam sem chegar ao meu servidor.** A substituição do webhook foi desinstalada com a aplicação. Tem de ser reaplicada; fazemos isso automaticamente.

**Como sei se foi a regra dos catorze dias?** A desligação chega com o motivo PRIMARY_INACTIVITY no evento account_update.

**Uma alteração num template pode impedir os meus envios?** Sim, e é a única causa que se parece com uma falha de código. Alterar o número de variáveis muda o contrato para cada remetente.

---

## Que mensagens do WhatsApp a Meta cobra

https://easycoexistence.com/pt-pt/docs/free-and-paid-conversations

A Meta cobra por mensagem entregue, não por conversa. Desde 1 de outubro de 2026, cada número de telefone comercial tem 1.000 mensagens de serviço gratuitas por mês, as respostas enviadas dentro da janela de atendimento ao cliente de 24 horas, e a Meta cobra a partir da 1.001.ª. Os templates são cobrados na entrega, incluindo os de utilidade. Esses custos vão para o método de pagamento da sua própria WhatsApp Business Account.

### O que é exatamente gratuito?

Até 1.000 mensagens de serviço por mês e por número de telefone comercial. Uma mensagem de serviço é qualquer mensagem que não seja um template, e só pode ser enviada dentro de uma janela de atendimento ao cliente aberta, ou seja, as 24 horas seguintes à última mensagem do cliente para si. A partir da 1.001.ª num mês, a Meta cobra cada uma, e a franquia não utilizada não transita para o mês seguinte.

Isto pesa mais no desenho de uma integração do que parece à primeira vista. Um fluxo de apoio ao cliente que só responde a quem escreveu primeiro mantém-se gratuito até ultrapassar essa franquia e, depois disso, paga por mensagem. Um fluxo que toma a iniciativa paga cada template que entrega, e desde 1 de outubro de 2026 isso inclui os templates de utilidade enviados dentro de uma janela aberta.

Assim, o custo de uma integração depende do número de mensagens que entrega e da categoria em que se enquadram, não do número de conversas que tem. Dois sistemas com o mesmo volume de envios podem ter custos muito diferentes junto da Meta.

### A quem fatura a Meta?

Ao método de pagamento da sua própria WhatsApp Business Account, definido no WhatsApp Manager.

Trata-se de uma relação direta entre a empresa e a Meta. Os custos não passam por um Tech Provider, e é também por isso que um fornecedor não os pode aumentar, agrupar ou revender. Quem oferece tarifas de mensagens do WhatsApp com desconto é um revendedor com outro tipo de acordo ou está a descrever algo que não são os custos da Meta.

Na prática, uma conta sem método de pagamento consegue responder até se esgotar a franquia gratuita mensal e falha no momento em que envia um template ou uma resposta acima dela, uma falha confusa até se perceber esta separação.

- Partir do princípio de que as respostas são sempre gratuitas. Desde 1 de outubro de 2026, a Meta cobra as mensagens de serviço acima de 1.000 por número e por mês, e também os templates de utilidade dentro da janela.
- Esperar que a fatura do fornecedor inclua os custos da Meta. Estes são faturados diretamente e em separado.
- Criar fluxos sem método de pagamento na conta. Os templates não são enviados e as respostas deixam de sair assim que a franquia gratuita mensal se esgota.

**Todas as respostas são gratuitas?** Só as primeiras 1.000 mensagens de serviço por número de telefone comercial em cada mês. Depois disso, a Meta cobra cada uma e, fora da janela de 24 horas, é necessário um template, que é cobrado na entrega.

**A categoria altera o preço?** Sim. A Meta aplica preços diferentes às mensagens de marketing, de utilidade, de autenticação e de serviço, e a tarifa depende também do país do destinatário.

**Um fornecedor pode dar-me uma tarifa melhor?** Não nos custos da Meta, porque esses nunca chegam ao fornecedor.

**O que acontece se o meu método de pagamento falhar?** Os envios que exigem cobrança param e devolvem o erro 131042. A receção não é afetada.

---

## MCP ou um webhook: de qual precisa realmente

https://easycoexistence.com/pt-pt/docs/mcp-or-webhook

O MCP funciona através de pedidos e respostas: um assistente chama uma ferramenta quando alguém lho pede. Um webhook tem a forma oposta: a Meta entrega um evento e o seu sistema decide o que fazer. Não é possível criar algo que reaja automaticamente apenas com MCP.

### Porque é que o MCP não pode responder automaticamente a um cliente?

Porque o protocolo não tem nenhum mecanismo para ser despertado.

Um servidor MCP disponibiliza ferramentas que um cliente chama. A chamada tem origem no assistente, que está a responder a uma pessoa. Não existe uma direção de entrada: nada no facto de um cliente enviar uma mensagem pelo WhatsApp consegue chegar a um assistente e fazê-lo agir. Isto aplica-se a todos os servidores MCP em todos os produtos, não é uma limitação nossa.

Por isso, a pergunta que todos os compradores acabam por fazer, sobre se uma IA pode responder aos clientes durante a noite, tem uma resposta através de um webhook, não de MCP. A Meta entrega a mensagem a um sistema que gere, e esse sistema decide o que fazer, o que pode incluir chamar um modelo.

### Para que serve realmente cada percurso?

O MCP serve para o trabalho que uma pessoa está a fazer. Qual dos meus números está com problemas, envie a confirmação a este cliente, crie um template para atualizações de encomendas, direcione o número deste cliente para o meu servidor. Cada uma destas ações começa com alguém a pedir, e cada uma é mais rápida através de um assistente do que através de um painel.

O webhook serve para tudo o que tem de acontecer sem ninguém presente. Primeira resposta fora do horário, encaminhamento para a pessoa certa, registo num CRM, acionamento de um fluxo de trabalho.

A propriedade útil é o MCP poder configurar o webhook. get_connect_link produz a ligação que um cliente abre, e set_webhook_destination direciona o número para o seu sistema, permitindo que um agente faça a integração inicial do percurso que não consegue servir diretamente.

### Que ferramentas comunicam através de cada percurso?

Os assistentes comunicam através de MCP: Claude, ChatGPT, Cursor, Claude Code. As plataformas de automatização, na sua maioria, não o fazem, e a distinção não é a que as pessoas esperam.

Make e Zapier executam os seus próprios servidores MCP, disponibilizando as suas ações aos assistentes. Nenhum dos dois atua como cliente MCP, por isso nenhum consegue chamar o nosso. Para eles, a integração é um webhook e uma chamada HTTP.

n8n é a exceção. O seu MCP Client Tool liga-se a um servidor remoto e suporta OAuth2, permitindo que um nó de agente num fluxo de trabalho n8n chame diretamente as nossas ferramentas. Mesmo nesse caso, o fluxo de trabalho começa com um webhook, porque é a única coisa que reage.

- Comprar MCP à espera de respostas automáticas. Age quando lho pedem, e ninguém lho pede às 3 da manhã.
- Assumir que uma plataforma com um servidor MCP consegue consumir um. Make e Zapier disponibilizam, mas não consomem.
- Criar os dois percursos para fazerem o mesmo trabalho. Servem metades diferentes do mesmo sistema.

**Um assistente pode vigiar o meu WhatsApp?** Não. Nada consegue enviar um evento para um servidor MCP. Vigiar é função de um webhook, que pode depois chamar um modelo.

**Preciso dos dois?** A maioria dos sistemas reais usa ambos: MCP para o trabalho que as pessoas fazem, e o webhook para tudo o que acontece sem elas.

**O Zapier pode usar o vosso servidor MCP?** Não. O Zapier é um servidor MCP, não um cliente, por isso não consegue chamar o nosso.

**E o n8n?** Sim, através do seu MCP Client Tool com OAuth2. É a única das três plataformas de automatização que consegue fazê-lo.

---

## O que muda na aplicação WhatsApp Business depois de ligar o número

https://easycoexistence.com/pt-pt/docs/what-changes-in-the-app

Quase nada muda no telemóvel. As mesmas conversas, histórico, contactos e dispositivo permanecem, e a equipa responde exatamente como antes. A mudança é que a API fica associada à mesma linha, cada lado vê o que o outro envia e os grupos ficam excluídos da API.

### O que permanece exatamente igual?

A aplicação, o número, as conversas e a pessoa que responde.

A aplicação WhatsApp Business abre da mesma forma, a lista de contactos não muda e todas as conversas anteriores continuam lá. Ninguém inicia sessão num local novo, ninguém instala nada e não há formação. Uma empresa que liga um número na terça-feira à tarde terá uma manhã de quarta-feira igual a todas as manhãs de quarta-feira anteriores.

Este é o objetivo principal, e vale a pena ser concreto porque a promessa parece boa demais para empresas às quais já foram propostas migrações.

### O que muda realmente?

Três coisas, e apenas uma é visível.

As mensagens que a API envia aparecem no tópico da conversa da aplicação, para que quem está no telemóvel veja o quadro completo em vez de apenas metade. Essa é a mudança visível, e representa uma melhoria, não uma perturbação.

As mensagens escritas na aplicação tornam-se visíveis para o software e chegam como eventos smb_message_echoes. Ninguém no telemóvel dá por isso, mas é isto que impede a automação de responder por cima de uma pessoa que já respondeu.

E as conversas de grupo ficam excluídas da API. A equipa pode continuar a utilizar os grupos na aplicação exatamente como antes; o software simplesmente não pode vê-los nem enviar mensagens neles, em nenhum fornecedor.

### O que tem a empresa de continuar a fazer?

Abrir a aplicação, algo que já iria fazer.

A Meta desliga uma ligação Coexistence após cerca de catorze dias sem atividade no dispositivo principal. Para uma empresa que responde ativamente aos clientes, isto nunca acontece. Para um número que fica sazonalmente inativo, ou que uma agência mantém para um cliente num mês mais calmo, acontece.

A desligação pode ser recuperada, por isso é um incómodo e não uma perda. O ponto a planear é o que acontece depois: o destino do webhook é desinstalado juntamente com a ligação, por isso voltar a ligar restabelece o envio, mas a entrega ao seu próprio servidor deixa silenciosamente de funcionar até ser aplicada de novo.

- Prometer a uma equipa que não dará por nada e depois migrar em vez de ligar. A migração remove a aplicação.
- Criar qualquer funcionalidade à volta de conversas de grupo. Ficam excluídas da API em todos os fornecedores.
- Presumir que um número inativo permanece ligado. Catorze dias sem abrir a aplicação terminam a ligação.

**A minha equipa terá de aprender alguma coisa?** Não. Continua a utilizar a aplicação WhatsApp Business exatamente como utiliza agora.

**Perco as conversas antigas?** Não. Permanecem na aplicação e pode partilhar-se opcionalmente cerca de seis meses de histórico com a API durante a integração.

**Podemos continuar a utilizar grupos?** Na aplicação, sim, exatamente como antes. Através da API, não, em nenhum fornecedor.

**O que acontece se ninguém abrir a aplicação durante duas semanas?** A Meta desliga o lado da API. Voltar a ligá-lo restabelece-o, e a aplicação permanece inalterada durante todo o processo.

---

## Referência de Coexistência

https://easycoexistence.com/pt-pt/docs/coexistence

A Coexistência permite usar a aplicação WhatsApp Business e a Cloud API no mesmo número em simultâneo. Esta página é a referência: o que é, como circulam as mensagens, o que não permite fazer e como anulá-la. A justificação encontra-se no guia.

### 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.

- 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.

**É a mesma coisa que a Cloud API?** Sim. A Coexistência é uma forma de integrar a Cloud API que mantém a aplicação WhatsApp Business a funcionar no número.

**Posso anulá-la?** Sim. Desligar o número deixa a aplicação e as conversas exatamente como estavam.

**A minha equipa precisa de formação?** Não. Continua a utilizar a aplicação WhatsApp Business como até agora.

**Porque é que a aplicação não pode enviar templates?** Os templates são uma funcionalidade da plataforma, não da aplicação. Tudo o que esteja fora da janela de 24 horas passa pela API.

---

## O que sincroniza com a API e o que fica de fora

https://easycoexistence.com/pt-pt/docs/what-syncs-and-what-does-not

Os contactos e o histórico de mensagens individuais sincronizam-se com a API, e as mensagens passam a espelhar-se nos dois sentidos. Os grupos ficam de fora, tal como as ferramentas da aplicação WhatsApp Business: catálogo, encomendas, estado, etiquetas, respostas rápidas e mensagens de saudação e de ausência.

### O que passa para a API

São duas coisas, precisamente as que mais importam para o software que começa a funcionar num número usado por uma empresa há anos.

- Contactos: todos os contactos com um número WhatsApp podem ser sincronizados com a plataforma.
- Histórico de mensagens individuais, para que a API não fique sem contexto sobre conversas anteriores à sua existência.
- A partir daí, as mensagens espelham-se nos dois sentidos: o que a API envia aparece na aplicação, e o que a equipa escreve na aplicação chega aos seus sistemas.

### O que não passa para a API

É mais do que se espera, e vale a pena ler esta lista antes de prometer algo a um cliente. Nada disto é uma limitação do fornecedor; é assim que a plataforma funciona.

- Conversas de grupo, que não sincronizam e não ficam acessíveis através da API em nenhum fornecedor.
- Ferramentas empresariais: o catálogo, as encomendas e o estado.
- Ferramentas de mensagens: mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas.
- Canais, chamadas de voz e vídeo e detalhes do perfil empresarial.

### Porque ficam de fora as ferramentas da aplicação

Porque são funcionalidades da aplicação, e não da plataforma, e a API não tem um equivalente.

As respostas rápidas e as etiquetas ficam no dispositivo. Uma mensagem de ausência é enviada pela aplicação quando ninguém a está a consultar. Nada disto existe como conceito da API, por isso não há nada que possa ser sincronizado.

Na prática, uma empresa que dependa de etiquetas para organizar o trabalho continua a usá-las na aplicação, mas o software não tem visibilidade sobre elas. Se essa organização for importante para o que está a criar, terá de ser reconstruída do seu lado, em vez de ser lida através da API.

### A janela que pode perder

A sincronização tem de ser iniciada nas 24 horas seguintes à integração inicial. Se perder essa janela, o número tem de ser desligado e ligado novamente para ter outra oportunidade.

Isto é diferente da janela de atendimento ao cliente de 24 horas, que determina o envio, e as duas são confundidas constantemente. Uma conta a partir da última mensagem do cliente e decide se o texto livre é entregue. Esta conta a partir da integração inicial e decide se o histórico ainda pode ser transferido.

É também por isso que vale a pena decidir sobre o histórico no dia em que o número é ligado, e não quando começa o trabalho de integração, normalmente noutra semana.

- Prometer a um cliente que as etiquetas e as respostas rápidas aparecerão no seu sistema. Ficam na aplicação.
- Criar qualquer funcionalidade à volta de conversas de grupo. Não sincronizam em nenhum fornecedor.
- Deixar a sincronização do histórico para depois de concluir a integração. A janela é de 24 horas após a integração inicial.

**As minhas conversas antigas aparecem na API?** O histórico individual sincroniza-se se o aceitar durante a integração inicial. As conversas de grupo não.

**O software consegue ver as minhas etiquetas?** Não. As etiquetas são uma funcionalidade da aplicação sem equivalente na API, por isso ficam no dispositivo.

**A equipa perde as respostas rápidas?** Não. Continuam a funcionar na aplicação como antes; o software simplesmente não as consegue ver.

**O que acontece se perder a janela de sincronização de 24 horas?** O número tem de ser desligado e ligado novamente. Isso repete a integração inicial e abre uma nova janela.

---

## Que funcionalidades do WhatsApp deixam de funcionar após a Coexistência

https://easycoexistence.com/pt-pt/docs/features-disabled-by-coexistence

Quatro coisas deixam de funcionar quando um número é ligado através da Coexistência: as mensagens temporárias, as mensagens de visualização única e a localização em tempo real ficam desativadas nas conversas individuais, enquanto as listas de transmissão são totalmente desativadas e as existentes passam a ser só de leitura, sem serem apagadas.

### As quatro

Cada funcionalidade é desativada ao nível da plataforma, em vez de ficar apenas oculta, e cada uma tem uma razão relacionada com a capacidade da API para ver a conversa.

- Mensagens temporárias: desativadas em todas as conversas individuais.
- Mensagens de visualização única: desativadas em todas as conversas individuais.
- Mensagens de localização em tempo real: desativadas em todas as conversas individuais.
- Listas de transmissão: desativadas; as existentes passam a ser só de leitura, em vez de serem removidas.

### Por que razão estas quatro

Porque cada uma promete algo que a API contradiz.

Uma mensagem temporária promete não ficar guardada. Uma mensagem de visualização única promete poder ser vista uma vez. Ambas as promessas dependem de não existir outra cópia, e um número ligado está, por definição, a entregar essas mensagens a outro sistema.

A localização em tempo real é um fluxo contínuo, e não uma mensagem, pelo que não tem representação na API. As listas de transmissão são uma forma, na aplicação, de enviar algo a várias pessoas ao mesmo tempo. A resposta da plataforma para isso são os templates, que passam pela API após aprovação.

Nada disto é arbitrário. A plataforma está a deixar de prometer algo que já não consegue garantir.

### O que significa antes de ligar o número de um cliente

Confirme se a empresa utiliza alguma destas funcionalidades, porque descobrir isso depois cria uma conversa difícil.

As listas de transmissão são as que mais surpreendem empresas reais. Uma loja que envia semanalmente uma mensagem a duzentos clientes através de uma lista de transmissão perde esse fluxo de trabalho. A alternativa é um template de marketing aprovado, que exige um método de pagamento na conta e uma revisão da Meta.

As mensagens temporárias afetam outro tipo de utilizador, normalmente alguém que as ativou uma vez e se esqueceu delas. A localização em tempo real quase nunca é referida fora dos contextos de entregas e serviços no terreno.

- Ligar um número que depende de listas de transmissão sem informar a empresa. A alternativa é um template, sujeito a aprovação e faturação.
- Assumir que as listas de transmissão existentes são apagadas. Passam a ser só de leitura.
- Esperar que estas funcionalidades regressem enquanto o número continua ligado. Não regressam.

**Posso voltar a ativar as mensagens temporárias?** Não enquanto o número estiver ligado. Desligá-lo repõe o comportamento normal da aplicação.

**As minhas listas de transmissão existentes são apagadas?** Não. Passam a ser só de leitura, por isso o conteúdo mantém-se, mas não podem ser usadas para enviar mensagens.

**Isto afeta as conversas de grupo?** A desativação está documentada para conversas individuais. Nos números com Coexistência, os grupos ficam totalmente fora da API.

**O que substitui uma lista de transmissão?** Um template de marketing aprovado, enviado através da API, que exige um método de pagamento na sua própria WhatsApp Business Account.

---

## Que números são elegíveis para a Coexistência

https://easycoexistence.com/pt-pt/docs/number-eligibility

Um número tem de estar já a ser utilizado na aplicação WhatsApp Business, na versão 2.24.17 ou posterior, num Portefólio empresarial que possa administrar e não estar ligado a outro fornecedor. A geografia já não é uma condição. Qualquer outra situação é recusada durante a integração.

### O que o próprio número tem de cumprir

São necessárias quatro condições, todas verificadas durante a integração da própria Meta, e não por um fornecedor.

- Já estar registado e a ser utilizado na aplicação WhatsApp Business, e não na aplicação WhatsApp para consumidores.
- Ter a versão 2.24.17 ou posterior instalada no dispositivo principal.
- Estar num Portefólio empresarial da Meta ao qual tenha acesso de administrador.
- Não estar já ligado à aplicação de outro fornecedor.

### Onde a Coexistência está disponível

Em todos os locais onde funciona a aplicação WhatsApp Business. A documentação atual da Meta para utilizadores da aplicação Business não indica qualquer restrição geográfica, e a expansão iniciada por regiões terminou durante 2026, com a África do Sul e a Nigéria entre os últimos mercados adicionados.

É importante dizê-lo claramente, porque as listas regionais publicadas durante a expansão continuam a circular e várias ainda indicam como excluídos países que são suportados há meses. Uma empresa que leia uma dessas listas conclui que não pode utilizar a funcionalidade, quando pode.

A Meta não publica uma lista de países com data. Por isso, o teste fiável é o próprio fluxo. Se o número estiver ativo na aplicação WhatsApp Business e o Embedded Signup não o recusar por motivos geográficos, a Coexistência está disponível para esse número.

### O que pode correr mal durante a integração

Três falhas explicam a maioria dos casos, e cada uma manifesta-se de forma diferente.

A um número na aplicação WhatsApp para consumidores nem sequer é apresentada a Coexistência. Primeiro, tem de ser transferido para a aplicação WhatsApp Business, uma migração que a empresa faz no telemóvel.

Uma aplicação desatualizada inicia um fluxo que não consegue concluir a leitura. A solução é atualizar e voltar a tentar.

E um fluxo fechado a meio deixa o número ligado à conta, mas sem o registo concluído. O número parece ligado no painel, mas a primeira mensagem falha com o erro 133010. Voltar a executar o fluxo desde o início conclui o processo.

- Iniciar a integração com um número que ainda está na aplicação WhatsApp para consumidores. Primeiro, tem de ser transferido para a aplicação Business.
- Confiar numa lista regional de disponibilidade publicada durante a expansão. Várias estão desatualizadas e continuam a indicar como excluídos países suportados.
- Fechar a janela pop-up da Meta assim que o número aparece. Os passos seguintes são os que concluem o registo.

**Posso utilizar um número fixo ou virtual?** Tem de ser um número registado na aplicação WhatsApp Business, o que significa que tem de conseguir receber a mensagem de registo.

**De que versão da aplicação preciso?** Da versão 2.24.17 ou posterior no dispositivo que tem o número.

**A Coexistência está disponível no meu país?** Quase certamente. A documentação atual da Meta não indica qualquer restrição geográfica, e a expansão regional terminou durante 2026. O próprio fluxo é o teste fiável.

**O número aparece no painel, mas não envia mensagens.** É provável que a integração não tenha sido concluída. Isso devolve o erro 133010, e voltar a executar o fluxo resolve o problema.

---

## EasyCoexistence vs 360dialog

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-360dialog

360dialog e EasyCoexistence partilham um modelo de preços: uma taxa fixa por número ligado, com os custos de mensagens da Meta cobrados diretamente a si e sem margem de nenhuma das partes. O que muda é o valor, o número de escalões e aquilo que a taxa compra.

### Quanto paga por número

Ambos cobram por número e nenhum aplica margem aos custos de mensagens da Meta, por isso a questão resume-se ao valor e ao que ele compra.

- 360dialog:: Três escalões da API do WhatsApp, a €49, €99 e €500 por número e por mês, em setembro de 2026. Há um plano a escolher no registo e um limite a ultrapassar mais tarde.
- EasyCoexistence:: Uma única tabela de preços, publicada, a partir de US$ 9 por número ligado e por mês, descendo até US$ 1 à medida que adiciona números. Não há qualquer limitação de funcionalidades: o vigésimo número de uma agência faz tudo o que fazia o primeiro e custa menos, sem conversa de upgrade, porque não há nada para atualizar.

### O que acontece quando adiciona clientes

O caso em que o valor por número deixa de ser um erro de arredondamento.

- 360dialog:: No escalão inicial, vinte números custam €980 por mês antes de quaisquer custos da Meta. O modelo é sólido; o multiplicador é o que é.
- EasyCoexistence:: Vinte números custam US$ 140 por mês, cada um ligado no Portefólio empresarial do seu próprio cliente, cada um faturado numa linha separada, sem atingir qualquer escalão, seja qual for a quantidade.

### Para onde vai o conteúdo das conversas

É importante esclarecer isto antes de tudo, porque não pode ser alterado mais tarde.

- 360dialog:: A página de preços não descreve o percurso das mensagens. Isso não é prova de nada e é a primeira pergunta que deve colocar-lhes.
- EasyCoexistence:: A Meta entrega os eventos de mensagens num URL que indicar, através de uma substituição na subscrição da nossa aplicação à sua conta. Os eventos de uma conta sem destino definido regressam ao nosso callback, onde o handler os elimina sem os guardar.

### A Coexistência em si

Se a aplicação WhatsApp Business continua a funcionar no número depois da ligação.

- 360dialog:: A página de preços não aborda o tema. Pergunte-lhes diretamente, em vez de confiar numa página de comparação, incluindo esta: uma funcionalidade não documentada não é uma funcionalidade em falta.
- EasyCoexistence:: É todo o produto. O número liga-se através do fluxo de Coexistência da própria Meta, a aplicação continua exatamente como antes e cada superfície vê o que a outra envia.

### Quando pretende uma relação BSP completa

Há um caso, e é um caso real.

- 360dialog:: Quando está a comprar uma relação com um fornecedor, e não apenas uma ligação. São um BSP estabelecido, com longa experiência operacional, presença regional e estruturas de apoio que um produto pequeno não iguala. O escalão mais alto existe porque os grandes remetentes precisam de coisas de que os pequenos não precisam.
- EasyCoexistence:: Um produto focado: apoio por email e uma cronologia da ligação que mostra o que aconteceu e quando. É disso que precisa quem está a criar a sua própria interface, e não de uma relação de gestão de conta.

### Qual deve escolher

Se precisa de um gestor de conta identificado e de um caminho de escalamento assegurado por pessoas, isso é uma relação BSP, e a deles é uma.

Se gere números de clientes e está a criar o software à volta deles, a aritmética decide. O mesmo modelo de faturação por um quinto do preço, com a ligação acompanhada e as mensagens a chegar aos seus próprios sistemas, é a versão deste produto que cresce com uma agência, e não contra ela.

- Comparar apenas o valor mensal. Aquilo que a taxa compra varia mais do que o número.
- Pressupor que algum deles aplica margem às tarifas da Meta. Nenhum aplica; esses custos são cobrados diretamente pela Meta.
- Interpretar uma funcionalidade não documentada como uma funcionalidade em falta. Pergunte-lhes, em vez de confiar numa página de comparação, incluindo esta.

**Os preços estão atualizados?** São os preços publicados na página de preços da 360dialog em setembro de 2026 e ligada acima. Os preços mudam; consulte a fonte antes de decidir.

**Algum deles aplica margem às tarifas da Meta?** Não. Ambos repercutem esses custos, e a Meta cobra diretamente a sua própria WhatsApp Business Account.

**A 360dialog suporta a Coexistência?** A página de preços não aborda o tema. Isso não é prova de nada e vale a pena perguntar-lhes.

**Qual é melhor para uma agência?** Depende de querer uma plataforma por cliente ou uma ligação por cliente. O custo por número pesa mais à medida que a quantidade aumenta.

---

## EasyCoexistence vs WATI

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-wati

São produtos diferentes, e não versões concorrentes do mesmo produto. A WATI vende uma caixa de entrada partilhada para equipas, com preço por utilizador e por contactos ativos mensais. A EasyCoexistence vende a própria ligação, com preço por número e sem qualquer caixa de entrada.

### Para que serve realmente a fatura mensal

Os dois produtos têm preços baseados em unidades diferentes, e para quem tem mais de um número essa diferença acumula-se todos os meses.

- WATI:: Por utilizador e por contacto ativo mensal. Os planos publicados abrangem três a dez utilizadores e 500 a 2.500 contactos em setembro de 2026, por isso a fatura aumenta com cada agente contratado e cada cliente contactado.
- EasyCoexistence:: Uma tarifa fixa por número ligado, sem limite de utilizadores nem de contactos. O vigésimo cliente de uma agência não custa mais do que o primeiro, e um mês intenso custa o mesmo que um mês calmo.

### Onde ficam as conversas dos seus clientes

Esta é a diferença que não pode ser desfeita mais tarde, e resulta da natureza de cada produto.

- WATI:: Na plataforma deles. Uma caixa de entrada partilhada tem de armazenar o conteúdo das mensagens para o apresentar a quem a abrir, e a página de preços lista essa função como central em todos os planos.
- EasyCoexistence:: Em lado nenhum do nosso lado. A Meta entrega os eventos das mensagens diretamente num URL que indicar, e tudo o que chegar ao nosso callback de fallback é descartado sem ser guardado. Isto é imposto pelo código, não declarado numa política.

### Se a sua equipa tem de mudar a forma de trabalhar

É a pergunta que um empresário faz antes de aceitar qualquer proposta.

- WATI:: Os agentes iniciam sessão na caixa de entrada. É aí que as conversas são atribuídas, etiquetadas e respondidas, o que leva a equipa a sair do telemóvel e a usar uma nova ferramenta.
- EasyCoexistence:: Ninguém muda. A aplicação WhatsApp Business continua a funcionar no mesmo número através de Coexistence, com as mesmas conversas e o mesmo histórico, e o software trata do que foi construído para tratar.

### O que acontece quando deixa de ser suficiente

Ambos têm um limite. Estão em pontos diferentes.

- WATI:: Mais utilizadores e mais contactos ativos, cada um como passo pago. A plataforma é o produto, por isso crescer significa comprar mais plataforma.
- EasyCoexistence:: Não há escalão nem nada que se torne insuficiente. Está a construir a interface, por isso o que escala é o seu próprio sistema, na API documentada da Meta e sem nada nosso pelo meio.

### Quando precisa de uma caixa de entrada

Há um caso, e nomeá-lo torna útil o resto desta página.

- WATI:: Uma equipa de apoio com oito pessoas a dividir conversas dentro da plataforma, num plano que começa nos 4.999 rupias por mês para três utilizadores e 500 contactos ativos mensais, com cada utilizador adicional cobrado à parte.
- EasyCoexistence:: É uma tarefa diferente. Aqui não há caixa de entrada nem vista de agente, porque a interface é a parte que já tem, ou que o seu cliente já tem.

### Qual escolher

Se uma equipa de agentes vai iniciar sessão todos os dias e as conversas são o próprio trabalho, compre a caixa de entrada. A WATI construiu uma e ela faz o que promete.

Para todos os outros, e são a maioria das pessoas que leem isto, a caixa de entrada é a parte pela qual paga sem usar. Uma agência que gere números de clientes está a comprar lugares que ninguém abre. Um programador que constrói a interface está a colocar um concorrente entre o seu produto e a API da Meta. Uma pequena empresa está a ser convidada a abandonar um telemóvel que já funciona.

A EasyCoexistence é a ligação subjacente, com uma tarifa fixa por número, as conversas a chegarem aos seus sistemas e a equipa a manter a aplicação que já conhece.

- Comparar diretamente os preços mensais. Um inclui uma caixa de entrada e utilizadores; o outro não.
- Escolher uma ligação quando uma equipa precisa de uma caixa de entrada. A equipa ficará insatisfeita e terá razão.
- Escolher uma caixa de entrada quando está a construir a interface. Acaba com duas.

**O que acontece quando ultrapasso os 500 contactos?** No plano inicial deles, passa para outro escalão. Connosco não acontece nada: não há limite de contactos a qualquer preço, por isso um mês com dez mil clientes custa o mesmo que um mês com dez.

**Um é mais barato?** Até seis números, somos nós, face ao plano inicial deles. Esse plano custa 4.999 rupias por mês, cerca de US$ 53, para três utilizadores e 500 contactos ativos mensais. O nosso custa US$ 9 por número ligado, ou US$ 7 cada a partir de seis números, por isso seis números ficam em US$ 42 por mês. Acima disso, a resposta depende das cobranças deles por utilizador adicional e por escalão de contactos, que sobem com a equipa e com a base de clientes, enquanto o nosso preço sobe apenas com o número de números.

**A WATI suporta Coexistence?** A página de preços deles não aborda essa questão. Pergunte-lhes, em vez de depender desta página.

**Têm uma aplicação móvel?** Não. A equipa usa a aplicação WhatsApp Business, que é precisamente o objetivo de Coexistence.

---

## EasyCoexistence vs respond.io

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-respond-io

A respond.io é uma plataforma multicanal: caixas de entrada para equipas, fluxos de trabalho, agentes de IA e transmissões, desde US$ 79 por mês, com limites de utilizadores e contactos. A EasyCoexistence é a ligação subjacente, cobrada por número, sem nada disso.

### Quanto custa operar

Cobrado por unidades diferentes, conforme publicado em setembro de 2026.

- respond.io:: Desde US$ 79 por mês para cinco utilizadores e 1,000 contactos ativos mensais, até US$ 279. A fatura acompanha o número de pessoas que respondem e de clientes alcançados.
- EasyCoexistence:: Desde US$ 9 por número ligado por mês, descendo até US$ 1 à medida que se adicionam números, sem limites de utilizadores ou contactos. A fatura acompanha os números que controla uma agência.

### Onde fica o conteúdo das conversas

Uma consequência de vender uma caixa de entrada em vez de uma ligação.

- respond.io:: Na plataforma deles, necessária para que uma caixa de entrada de equipa mostre o histórico. A página de preços não detalha a retenção, algo a esclarecer se for importante.
- EasyCoexistence:: Do nosso lado, em lado nenhum. O override do webhook envia os eventos de mensagens da Meta diretamente para o seu endpoint, e tudo o que chega ao nosso fallback é eliminado sem ser persistido.

### O que fica entre si e a Meta

A questão decisiva para quem está a criar software.

- respond.io:: A plataforma deles. Integra com a abstração, os limites de pedidos, o formato do webhook e o calendário de lançamentos deles. O que criar só será portátil até onde eles permitirem.
- EasyCoexistence:: Nada. A API é da própria Meta, documentada pela Meta, e o webhook vai para o seu endpoint. Não há nada nosso contra o qual tenha de criar, o que também torna possível sair.

### O que acompanha a ligação

Raramente aparece numa página de preços, e é a razão de este produto existir.

- respond.io:: Não é algo abordado pela página de preços deles, e seria errado afirmar uma resposta. Se controla números de clientes, pergunte especificamente o que acontece quando uma ligação cai silenciosamente.
- EasyCoexistence:: Classificação de qualidade, nível de mensagens e throughput consultados segundo um calendário. Os eventos da conta da Meta são tratados pelo nome. Mantêm-se duas credenciais para que um token revogado não seja confundido com um número perdido. O override do webhook é reaplicado depois de uma reconexão que o remova.

### Quando pretende uma plataforma

Vale a pena dizê-lo, porque os dois produtos respondem a perguntas diferentes.

- respond.io:: Quando pretende a plataforma. Os planos publicados incluem caixas de entrada para equipas e personalizadas, fluxos de trabalho, transmissões, agentes de IA, relatórios e, nos níveis superiores, SSO e vários espaços de trabalho. É multicanal, não apenas WhatsApp.
- EasyCoexistence:: Um âmbito diferente por conceção: um número, uma ligação, dezasseis ferramentas MCP e um webhook, ficando a interface a seu cargo.

### Qual escolher

São camadas diferentes, não versões concorrentes da mesma coisa. Se ninguém da sua equipa está a criar a interface e pretende um espaço pronto para os agentes trabalharem, é uma plataforma que procura.

Se é quem a está a criar, uma plataforma fica dentro da sua própria stack como concorrente. Paga por utilizador por caixas de entrada que os seus utilizadores nunca veem, por contacto por conversas que o seu produto já gere, e integra com uma abstração em vez da API que a Meta documenta e mantém estável.

A EasyCoexistence é essa camada subjacente: uma tarifa fixa por número, o webhook apontado para o seu sistema e a ligação acompanhada para que uma falha silenciosa não se transforme num cliente perdido.

- Comparar US$ 9 com US$ 79 como se comprassem a mesma coisa. Não compram.
- Escolher uma ligação quando pretendia um produto. Passará meses a reconstruir uma caixa de entrada.
- Assumir que qualquer fornecedor acompanha a ligação. Pergunte especificamente, pois raramente aparece numa página de preços.

**Qual é a opção certa para mim?** São camadas diferentes. A respond.io é uma plataforma para trabalhar dentro dela; isto é a ligação subjacente, para equipas que criam a própria interface.

**Posso passar deles para si?** O número é seu e pode ser ligado através da Coexistência. O que deixaria para trás seriam a caixa de entrada e os fluxos de trabalho deles.

**Têm fluxos de trabalho ou agentes de IA?** Não. O conector MCP permite que um assistente use o número, e o webhook permite que o seu sistema reaja. Nenhum dos dois é um criador de fluxos de trabalho.

**Esses preços estão atualizados?** São os publicados em setembro de 2026 e indicados acima. Consulte a fonte antes de decidir.

---

## EasyCoexistence vs Dualhook

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-dualhook

Ambos são fornecedores de Coexistência com a mesma arquitetura base: a aplicação WhatsApp Business continua a funcionar e os webhooks de mensagens seguem da Meta diretamente para o seu servidor, em vez de passarem pelo fornecedor. As diferenças são mais restritas do que as semelhanças e vale a pena conhecê-las.

### O que são os dois produtos

Esta é a comparação mais próxima no site, porque o posicionamento é quase o mesmo.

- Dualhook:: Um fornecedor de Coexistência com a mesma promessa base: manter a aplicação WhatsApp Business a funcionar e encaminhar os webhooks de mensagens diretamente da Meta para o seu servidor, em vez de os guardar. A documentação deles descreve isto como Webhook Override.
- EasyCoexistence:: O mesmo mecanismo, com o mesmo nome usado pela Meta. Definimos override_callback_uri na subscrição da nossa aplicação à WhatsApp Business Account, o que move os campos do percurso das mensagens para o seu endpoint, enquanto mantemos os campos operacionais.

### Para onde vão as mensagens

Ambos encaminham diretamente. A diferença está no que acontece aos eventos que não são encaminhados.

- Dualhook:: Encaminhamento direto da Meta sem guardar mensagens, algo que o site deles afirma claramente e que corresponde à arquitetura que usamos.
- EasyCoexistence:: O mesmo encaminhamento. O que podemos acrescentar é o que acontece no percurso alternativo: uma conta sem override definido entrega os eventos ao nosso callback predefinido, onde o processador os descarta sem os guardar. A afirmação é aplicada no código, em vez de constar apenas de uma política.

### A regra dos catorze dias de inatividade

A Meta desliga uma ligação de Coexistência após cerca de catorze dias sem atividade no dispositivo principal. Os dois produtos lidam com isto de forma diferente.

- Dualhook:: A documentação deles descreve um aviso no dia treze, com contagens decrescentes e emails de lembrete. Isso lembra que o relógio está a contar, o que é diferente de saber por que motivo uma ligação foi realmente desligada.
- EasyCoexistence:: Monitorizamos a própria desligação e lemos o campo de motivo da Meta, que distingue PRIMARY_INACTIVITY de BUSINESS_DOWNGRADE, CHANGE_NUMBER e dos restantes. O motivo separa duas semanas de silêncio de um cliente que saiu efetivamente.

### O que uma reconexão interrompe

A consequência da regra de inatividade que custa mais e a pergunta que vale a pena fazer a qualquer fornecedor.

- Dualhook:: A documentação deles não aborda o que acontece a um override de webhook depois de uma reconexão. Isso não prova que não o tratem, e é a pergunta que vale a pena colocar-lhes diretamente.
- EasyCoexistence:: Uma remoção desinstala a aplicação da conta e leva consigo o override, pelo que a reconexão repõe o envio e a monitorização, mas a entrega ao seu servidor deixa silenciosamente de ocorrer. Voltamos a aplicá-lo em todas as reconexões, porque isto aconteceu a um número real que regressou limpo e deixou de entregar eventos.

### Quanto custa por número

Ambos cobram uma taxa mensal fixa por número ligado, em vez de por utilizador ou mensagem, e nenhum aumenta o valor que a Meta cobra pelas conversas.

- Dualhook:: As próprias páginas comparativas deles descrevem uma taxa mensal fixa a partir de US$ 12 por mês, conforme publicado em setembro de 2026.
- EasyCoexistence:: A partir de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que acrescenta números, sem limites de utilizadores ou contactos. Para uma agência, a diferença acumula-se com cada número de cliente acrescentado.

### O conector MCP

Onde estamos à frente, para um público específico.

- Dualhook:: A documentação deles não descreve um servidor MCP. O produto é acedido através da API e do painel.
- EasyCoexistence:: Dezasseis ferramentas num servidor MCP remoto com OAuth, para que Claude, ChatGPT, Cursor e Claude Code possam listar números, verificar o estado, enviar mensagens e templates e definir destinos de webhook. Para uma agência que integra clientes a partir de um assistente, essa é a diferença.

- Interpretar uma funcionalidade não documentada como uma funcionalidade inexistente. Pergunte-lhes; esta página indica onde a documentação é omissa, em vez de adivinhar.
- Escolher apenas pelo preço. Ambas são taxas pequenas face ao que a Meta cobra pelas conversas.
- Assumir que qualquer fornecedor volta a aplicar um override de webhook depois de uma reconexão. Pergunte especificamente, seja qual for a sua escolha.

**São realmente a mesma arquitetura?** No percurso das mensagens, sim. Ambos usam a capacidade da Meta para substituir o destino dos webhooks de uma WhatsApp Business Account, fazendo com que o conteúdo das conversas vá para o seu servidor em vez de passar por um fornecedor.

**Em que diferem as duas abordagens à regra dos 14 dias?** Avisam no dia treze que o relógio está a contar. Nós lemos o motivo da desligação indicado pela própria Meta, que separa duas semanas de silêncio de um cliente que saiu efetivamente, e voltamos a aplicar o override de webhook depois disso para que a entrega não pare silenciosamente.

**Em que difere a EasyCoexistence?** Um conector MCP com dezasseis ferramentas, que a documentação deles não descreve, e a reaplicação automática do override de webhook depois de uma reconexão o remover.

**Esta página é imparcial?** Todos os valores apresentados vêm das páginas publicadas por eles e têm data. Leia-as antes de decidir: uma comparação escrita por uma das partes é uma evidência, não um veredicto.

---

## É possível usar a app WhatsApp Business e a API no mesmo número?

https://easycoexistence.com/pt-pt/whatsapp-business-app-and-api-same-number

Sim. A Meta chama-lhe Coexistence, uma funcionalidade oficial e não uma solução alternativa. A equipa continua a responder na app WhatsApp Business do telemóvel, a Cloud API funciona no mesmo número em simultâneo e ambas mostram as mesmas conversas.

### Como pode um número estar nos dois ao mesmo tempo?

Porque a Meta criou um modo para isso. Historicamente, era a escolha que ninguém queria fazer: migrar um número para a API significava que a app WhatsApp Business deixava de funcionar nele. Assim, uma empresa com uma equipa a responder pelo telemóvel tinha de escolher entre as pessoas que já conheciam os clientes e a automatização que queria acrescentar.

Coexistence elimina essa escolha. O número é registado na Meta como número de API, enquanto a app WhatsApp Business continua ligada a ele. A mensagem de um cliente chega à app no telemóvel e ao seu webhook da API, e uma resposta enviada de qualquer dos lados aparece na conversa. Nada é simulado nem contornado: a app e a API são duas formas autorizadas de aceder ao mesmo número.

### O que muda realmente no telemóvel?

Menos do que se espera, mas convém conhecer as diferenças antes de fazer a ligação.

A equipa continua como antes: mesma app, mesmas conversas, mesmos contactos, mesmo número. O que desaparece são quatro funcionalidades que a Meta desativa em qualquer número com Coexistence: mensagens temporárias, multimédia de visualização única, localização em tempo real e listas de transmissão. As conversas de grupo continuam disponíveis na app, mas ficam fora da API, por isso a automatização não as consegue ver.

Também existe uma etapa de sincronização quando o número é ligado pela primeira vez. Esta copia o histórico recente das conversas para que o lado da API não comece às cegas. Abrange mensagens recentes, não todo o histórico do número, e tudo o que for mais antigo permanece no telemóvel, onde sempre esteve.

### Acontece alguma coisa se mudarmos de ideias?

Não, e convém dizê-lo claramente, porque este é o receio que impede muitas empresas de experimentar.

As conversas permanecem no telemóvel e sempre permaneceram. Desligar o número da API deixa a app WhatsApp Business a funcionar exatamente como antes, com as conversas intactas, porque nada foi transferido para outro local. A API foi acrescentada ao lado da app, em vez de a substituir.

O número também permanece no Portefólio empresarial da Meta da própria empresa. Um fornecedor liga-o como Tech Provider, o que é uma permissão e não uma forma de propriedade. Por isso, remover o fornecedor deixa o número onde estava, em vez de o levar consigo.

### O que é necessário para funcionar?

São necessárias três coisas, e duas delas já estão disponíveis.

O número tem de estar na app WhatsApp Business, e não na app WhatsApp para consumidores, e não pode já estar registado noutra Cloud API. Além disso, precisa de um Meta Tech Provider para fazer o onboarding, porque Coexistence não pode ser configurado diretamente num painel da Meta: a ligação é feita através da aplicação aprovada de um fornecedor.

É aqui que entramos. O Embedded Signup da Meta seleciona o portefólio, a conta e o número; depois, lê-se um código na app WhatsApp Business para confirmar a operação e o número fica ligado em poucos minutos. A app continua a funcionar durante todo o processo, incluindo enquanto a ligação está a ser criada.

- Partir do princípio de que é preciso escolher. Coexistence existe precisamente para não ter de escolher.
- Esperar conversas de grupo através da API. Permanecem na app e ficam sempre fora da API.
- Esperar uma opção no painel da Meta. O onboarding de Coexistence é feito através de um Tech Provider.

**É oficial?** Sim. Coexistence é uma funcionalidade da própria Meta e o termo usado pela Meta. Não é uma ponte, um dispositivo ligado nem uma solução alternativa.

**A equipa vai notar alguma diferença?** Apenas o desaparecimento de quatro funcionalidades: mensagens temporárias, visualização única, localização em tempo real e listas de transmissão. Tudo o resto fica como antes.

**Perco o histórico das conversas?** Não. O histórico permanece no telemóvel. Quando o número é ligado, o histórico recente também é copiado para o lado da API.

**Posso reverter a alteração?** Sim. Desligue o número e a app continua exatamente como antes, com as conversas intactas.

---

## Como ligar o WhatsApp a uma API sem perder as conversas

https://easycoexistence.com/pt-pt/connect-whatsapp-without-losing-chats

As suas conversas ficam no telemóvel e ligá-lo à API não as move. A Coexistence acrescenta a Cloud API à aplicação WhatsApp Business, em vez de a substituir, por isso as conversas ficam onde estão e a aplicação continua a funcionar.

### Porque é que ligar à API fazia perder conversas?

Porque o processo antigo era uma migração, não um acrescento. Registar um número na Cloud API retirava-o da aplicação WhatsApp Business, onde estavam todas as conversas. O número regressava como endpoint da API, sem histórico e sem aplicação. Por isso, muitas empresas analisavam a API uma vez e desistiam.

Essa era uma desvantagem real e a principal razão por que as pequenas empresas não aderiam à API oficial. Também levava algumas pessoas a recorrer a gateways não oficiais, que mantinham a aplicação a funcionar ao fingirem ser um dispositivo ligado e colocavam o número em risco de ser banido.

### O que faz a Coexistence de forma diferente?

Acrescenta a API sem remover a aplicação. O número é registado na Meta como número de API, enquanto a aplicação WhatsApp Business continua ligada a ele, por isso ambos funcionam ao mesmo tempo no mesmo número.

As conversas nunca são movidas. Permanecem no telemóvel, na aplicação, exatamente onde estavam, independentemente do que aconteça depois à ligação da API. Quando o número é ligado pela primeira vez, a Meta sincroniza o histórico recente com o lado da API para que a automatização não comece do zero, mas isso é uma cópia, não uma transferência. Nada é retirado do dispositivo.

Depois disso, uma mensagem de um cliente chega aos dois sítios: à aplicação no telemóvel e ao seu webhook. A equipa responde na aplicação, se quiser, o seu sistema responde quando deve, e ambos aparecem na mesma conversa.

### O que é sincronizado exatamente e o que não é?

O histórico recente de mensagens é sincronizado dentro de uma janela após a ligação. É suficiente para que uma automatização ou um agente tenha contexto de uma conversa em curso, em vez de responder sem contexto a alguém que nunca viu.

O que não é sincronizado é todo o conteúdo mais antigo, os ficheiros multimédia anteriores à ligação e as conversas de grupo. Nada disso se perde. Continua no telemóvel, na aplicação, disponível para a equipa exatamente como antes. Simplesmente não é copiado para o lado da API, porque a sincronização serve de ponto de partida para a automatização, não de arquivo.

Se precisar do histórico completo noutro local, exporte-o da aplicação. Esse é um trabalho separado da ligação do número e convém não confundir os dois.

### O que acontece se desligarmos mais tarde?

A aplicação continua a funcionar e as conversas permanecem lá, porque nunca saíram.

Desligar remove o lado da API do número. A aplicação WhatsApp Business continua a funcionar com todas as conversas intactas, e a empresa regressa exatamente ao ponto de partida, sem nada para restaurar. É importante compreender esta rede de segurança antes de começar: a decisão é reversível, ao contrário da antiga migração.

O número também permanece sempre no seu Portefólio empresarial da Meta. Um fornecedor liga-o como Tech Provider, uma permissão que concede e pode retirar, por isso sair de um fornecedor não significa recuperar-lhe um número.

- Exportar tudo antecipadamente por receio. As conversas não desaparecem.
- Esperar ver todo o histórico do lado da API. A sincronização fornece contexto recente, não um arquivo.
- Usar um gateway não oficial para manter a aplicação a funcionar. A Coexistence faz isso sem arriscar um banimento.

**Vou perder o meu histórico de conversas?** Não. Está no telemóvel e permanece lá. Ligar acrescenta a API à aplicação, em vez de a substituir.

**O histórico antigo aparece no meu sistema?** O histórico recente é sincronizado depois da ligação. As mensagens e os ficheiros multimédia mais antigos permanecem no telemóvel.

**A equipa pode continuar a usar a aplicação?** Sim, exatamente como antes. Esse é o objetivo da Coexistence.

**E se eu desligar?** A aplicação continua a funcionar com todas as conversas intactas, porque nada foi movido.

---

## A forma mais barata de obter a WhatsApp Business API

https://easycoexistence.com/pt-pt/cheapest-whatsapp-business-api

A API é gratuita. O pagamento destina-se à Meta pelas conversas e a um fornecedor pelo acesso. A parte da Meta é igual, independentemente do fornecedor, por isso o único custo variável a optimizar é o do fornecedor. A opção mais barata é uma tarifa fixa por número, sem margem adicional.

### O que está realmente a pagar?

São duas coisas distintas, e confundi-las explica por que razão as comparações de preços nesta categoria costumam falhar.

A primeira é o preço das conversas da Meta. A Meta cobra as conversas por categoria, com tarifas que variam consoante o país. As conversas de serviço dentro da janela de 24 horas funcionam de forma diferente das iniciadas pela empresa. Este custo existe qualquer que seja o fornecedor, porque pertence à Meta, e costuma ser o valor maior.

A segunda é o que um fornecedor cobra pelo acesso. Essa é uma decisão comercial inteiramente sua e a única parte da factura que pode realmente alterar ao escolher outro fornecedor. Quem compara fornecedores pelo custo total sem separar estes dois valores está a comparar ruído.

### Onde desaparece o dinheiro?

Na margem adicional, que é fácil de não notar por ser pequena em cada mensagem.

Vários fornecedores acrescentam uma tarifa por mensagem ao custo da Meta. A Twilio publica US$ 0.005 por mensagem recebida e enviada. A Gupshup publica US$ 0.001. Outros apresentam uma tarifa combinada que já inclui o custo da Meta, o que significa que a margem existe, mas não pode ser comparada com a tarifa publicada pela Meta.

Um décimo de cêntimo não é nada até ser multiplicado. Com cem mil mensagens por mês, a tarifa publicada pela Gupshup representa US$ 100 e a da Twilio US$ 500, todos os meses, além do que a Meta cobra. Estes são os valores que deve colocar numa folha de cálculo antes de escolher com base nas funcionalidades.

### Qual é a estrutura mais barata?

Uma tarifa fixa por número ligado, com a factura da Meta a ser enviada directamente para si e sem alterações.

Esta estrutura tem duas vantagens que as alternativas não têm. O custo deixa de aumentar depois de o número estar ligado, por isso crescer não fica mais caro. E a factura da Meta continua auditável, porque ninguém incluiu a sua tarifa nela. Assim, pode confirmar o que paga à Meta comparando-o com as tarifas publicadas pela própria Meta.

O nosso preço começa em US$ 9 por número ligado por mês e desce até US$ 1 à medida que adiciona números, sem custos por mensagem. À tarifa publicada pela Twilio, fica mais barato acima de aproximadamente 1 800 mensagens por mês, e a diferença aumenta a partir daí. As plataformas cobradas por utilizador são uma opção diferente: cobram pelas pessoas, não pelas mensagens, pelo que o ponto de equilíbrio depende do número de utilizadores.

### A opção mais barata é a certa?

Não automaticamente, e é importante reconhecer quando não é.

Se procura uma caixa de entrada partilhada, ferramentas de campanhas e análise num único produto onde a equipa trabalha todo o dia, uma plataforma cobrada por utilizador está a vender algo concreto e a tarifa paga esse produto. Pagar-nos menos e depois construir isso internamente não representa uma poupança.

A opção mais barata é adequada quando já dispõe de um sistema. Uma empresa com um CRM, um serviço de apoio, uma ferramenta de automação ou um agente de IA não precisa de outro local para ler mensagens; precisa que o WhatsApp chegue ao primeiro. Para esse objectivo, pagar por número e nada por mensagem é o mínimo que pode pagar mantendo-se na API oficial.

- Comparar fornecedores sem separar o custo das conversas da Meta da tarifa do fornecedor.
- Interpretar uma tarifa combinada por mensagem como se não tivesse margem adicional. Significa apenas que não está discriminada.
- Escolher a tarifa mais barata quando, na realidade, precisa da caixa de entrada que a plataforma vende.

**A WhatsApp Business API é gratuita?** O acesso é. A Meta cobra pelas conversas e os fornecedores cobram pelo acesso além disso. A parte da Meta é igual em todo o lado.

**Qual é o fornecedor mais barato?** A estrutura mais barata é uma tarifa fixa por número, sem margem adicional. A nossa começa em US$ 9 por número e desce até US$ 1 à medida que adiciona números.

**Um fornecedor mais barato significa uma API pior?** Não. A Cloud API é da Meta em todos os casos. O fornecedor altera o que fica à frente dela e o que cobra.

**Quando compensa um fornecedor mais caro?** Quando pretende o produto que está a comprar, como uma caixa de entrada partilhada onde a equipa trabalha todo o dia.

---

## Componentes de template: cabeçalho, corpo, rodapé e botões

https://easycoexistence.com/pt-pt/docs/template-components

Um template é composto por até quatro componentes: um cabeçalho, um corpo, um rodapé e botões. Apenas o cabeçalho e o corpo aceitam variáveis, e cada componente tem limites que determinam o que a mensagem pode dizer antes de a Meta a analisar.

### Cabeçalho

Opcional e disponível em quatro tipos: texto, imagem, vídeo ou documento. Um cabeçalho de texto está limitado a 60 caracteres e aceita uma única variável. Um cabeçalho multimédia inclui um ficheiro fornecido no momento do envio, permitindo anexar um recibo ou bilhete.

- Cabeçalho de texto: 60 caracteres, no máximo uma variável.
- Cabeçalho multimédia: imagem, vídeo ou documento, fornecido em cada envio.
- Apenas um cabeçalho por template.
- Está disponível um cabeçalho de localização para algumas categorias.

### Corpo

É a parte obrigatória, com até 1024 caracteres, e o único componente que aceita várias variáveis. As variáveis são posicionais e escritas como marcadores numerados, por isso a primeira é preenchida pelo primeiro parâmetro enviado.

A Meta rejeita corpos compostos sobretudo por variáveis e com pouco texto fixo, porque um template que, por si só, quase nada diz não se distingue de um campo aberto para conteúdo arbitrário. Escreva uma frase real à volta dos marcadores.

### Rodapé

Opcional, com 60 caracteres, é texto fixo sem quaisquer variáveis. É apresentado com tamanho menor e numa cor mais clara do que o corpo, o que o torna adequado para uma nota permanente, mas inadequado para algo de que a mensagem dependa.

Um uso comum é uma linha de exclusão em templates de marketing, que também ajuda a manter uma boa receção do template junto dos destinatários.

### Botões

Até dez no total, de três tipos, e a combinação influencia bastante a aprovação.

- Resposta rápida: envia uma resposta de texto fixa quando o destinatário toca no botão.
- Chamada para ação: abre um URL ou liga para um número de telefone.
- Os botões de URL aceitam uma variável, acrescentada a um URL base fixo.
- Copiar código: fornece ao destinatário um código para copiar, usado na autenticação.

### Porque é importante definir a estrutura antes da análise

A Meta analisa o template como um todo, e a maioria das rejeições deve-se à estrutura, não ao texto.

Um corpo composto quase totalmente por variáveis, um botão de URL que aponta para um local sem relação com a empresa ou uma mensagem de marketing submetida na categoria de utilidade são todos rejeitados por razões estruturais. Definir primeiro a estrutura torna simples a análise do texto e, quando um template é rejeitado por política, é devolvido o erro 132007, sem indicar a causa real.

- Escrever um corpo composto sobretudo por marcadores. A Meta rejeita templates com pouco texto fixo.
- Esperar variáveis no rodapé. É texto fixo, sem exceções.
- Submeter uma mensagem de marketing na categoria de utilidade. O texto não corrige uma categoria incorreta.

**Que partes aceitam variáveis?** O cabeçalho, no máximo uma, e o corpo, várias. Os rodapés nunca aceitam variáveis, e os botões de URL aceitam um valor acrescentado.

**Qual pode ser o comprimento do corpo?** 1024 caracteres, o que faz dele o componente mais longo, por uma margem significativa.

**Quantos botões são permitidos?** Até dez no total, com limites próprios para cada tipo.

**Porque foi o meu template rejeitado?** Na maioria dos casos, por causa da estrutura e não do texto: poucas palavras fixas ou a categoria errada. Isso devolve o erro 132007.

---

## O ciclo de estados de um template

https://easycoexistence.com/pt-pt/docs/template-status-lifecycle

Um template percorre uma sequência de estados, e a aprovação é apenas uma etapa intermédia, não o fim. Um template aprovado pode ser pausado por razões de qualidade, reativado, pausado novamente e, por fim, desativado permanentemente, sem intervenção humana.

### Os estados

A ordem pela qual um template normalmente passa por eles.

- PENDING: submetido e a aguardar análise.
- APPROVED: disponível para envio.
- REJECTED: recusado na análise, normalmente por estrutura ou categoria.
- PAUSED: temporariamente indisponível após uma queda de qualidade.
- DISABLED: permanentemente indisponível, o fim do percurso.

### Como um template é pausado

Não é algo que faça. Os destinatários bloqueiam ou denunciam as mensagens enviadas com o template, a sua classificação de qualidade passa de verde a amarelo e depois a vermelho, e a Meta pausa-o para travar a queda.

A pausa é temporária e termina por si só. O que importa é o que acontece depois: pausas repetidas agravam-se, e um template que continua a voltar ao vermelho acaba desativado permanentemente, em vez de ser novamente pausado.

### Os dois webhooks

Ambos são necessários para acompanhar todo o ciclo, e subscrever um sem o outro deixa um ponto cego.

- message_template_status_update: aprovação, rejeição, pausa e desativação.
- message_template_quality_update: a classificação de qualidade entre verde, amarelo e vermelho.
- O webhook de qualidade é o aviso antecipado; o webhook de estado é a consequência.
- Nenhum está ativo por predefinição, por isso é necessário subscrever ambos.

### Porque é que o amarelo é o momento de agir

Quando um template é pausado, o envio com ele já falha e uma campanha já está interrompida. O amarelo é o estado em que ainda funciona e a queda é visível.

Agir no amarelo significa analisar o público, além do texto. Um template bem escrito enviado a pessoas que não o esperavam acumula bloqueios tão depressa como um template mal escrito, e reescrever o texto mantendo a lista não altera nada.

### O que acontece ao editar

Um template aprovado pode ser editado, o que o envia novamente para análise. Isso é útil, mas tem uma consequência comum em produção: se a edição alterar o número de variáveis, todos os envios de uma integração não alterada começam a falhar com o erro 132012.

Trate o número de variáveis de um template como parte do contrato da integração, não como texto pertencente à equipa de marketing.

- Tratar a aprovação como permanente. Um template aprovado pode ser pausado e acabar desativado.
- Subscrever o estado, mas não a qualidade. O campo de qualidade é o aviso antecipado.
- Editar as variáveis de um template sem verificar o código que o envia.

**Um template aprovado mantém-se aprovado?** Não necessariamente. Feedback negativo continuado pode pausá-lo e, por fim, desativá-lo permanentemente.

**Qual é a diferença entre pausado e desativado?** Uma pausa termina por si só. Desativado é permanente e o template não pode voltar a ser utilizado.

**Como posso detetar o problema antecipadamente?** Subscreva o webhook de qualidade do template. Este comunica a passagem para amarelo enquanto o template ainda funciona.

**Porque é que os envios começaram a falhar depois de uma edição?** Se a edição alterou o número de variáveis, a integração não alterada envia agora um número incorreto de parâmetros e recebe o erro 132012.

---

## Enviar um template com variáveis

https://easycoexistence.com/pt-pt/docs/sending-a-template-with-variables

As variáveis do template são posicionais, não nomeadas. Envia-se uma lista de parâmetros por componente, pela ordem, e a contagem tem de corresponder exatamente ao que o template define. Há três erros diferentes quando isto é feito incorretamente, e cada um aponta para uma falha distinta.

### Como os parâmetros são associados

Por posição, não pelo nome. O primeiro parâmetro da lista do corpo preenche o primeiro marcador, o segundo preenche o segundo, e assim sucessivamente. Não é possível atribuir um nome a uma variável, e trocar dois parâmetros produz uma mensagem enviada com sucesso, mas com os valores nos locais errados.

Este último caso é perigoso, porque nada falha. Um cliente recebe uma confirmação de encomenda com a data no lugar do montante, e não é registado qualquer erro.

### Os componentes são listas separadas

Uma variável do cabeçalho e uma variável do corpo não partilham uma lista. Cada componente transporta os seus próprios parâmetros, e juntá-los provoca uma incompatibilidade na contagem.

- Os parâmetros do cabeçalho ficam num componente de cabeçalho, e existe no máximo um.
- Os parâmetros do corpo ficam num componente de corpo, pela ordem.
- Os parâmetros do URL do botão ficam num componente de botão, indexados pelo botão.
- Enviar uma única lista plana para todos devolve o erro 132000.

### Definir corretamente o idioma

Um template é identificado pelo nome e pelo idioma em conjunto, por isso o mesmo nome em dois idiomas corresponde a dois templates. Enviar en quando o template foi criado como en_US não faz fallback: falha com o erro 132001, que indica que o template não existe.

Liste os templates no número e copie a string exata do idioma, em vez de assumir o seu formato. Este é o erro de template mais comum e o menos descritivo.

### Parâmetros tipados

A maioria dos parâmetros é texto simples. Alguns não são, e enviá-los como texto falha com o erro 132012.

- Os parâmetros de moeda transportam um montante, um código de moeda e uma string de fallback.
- Os parâmetros de data e hora transportam um objeto estruturado com um fallback.
- Os parâmetros de multimédia do cabeçalho transportam um ID de multimédia ou uma ligação, não um nome de ficheiro.
- A string de fallback é apresentada se a aplicação do destinatário não conseguir formatar o valor.

### O que significa cada erro

As três falhas distinguem-se, o que reduz bastante as tentativas ao acaso se forem registadas separadamente, em vez de agrupadas como um erro de template.

O erro 132001 significa que o par nome e idioma não foi resolvido, por isso verifique primeiro o idioma. O erro 132000 significa que a contagem está errada, por isso compare-a com a própria definição do template. O erro 132012 significa que o formato de um valor está errado, normalmente porque um parâmetro tipado foi enviado como string simples.

- Assumir que en faz fallback para en_US. Não faz, e o erro indica que falta o template.
- Juntar os parâmetros do cabeçalho e do corpo numa única lista. São componentes separados.
- Enviar uma moeda ou uma data como texto simples. Os parâmetros tipados têm um formato definido.

**As variáveis do template têm nome?** Não. São posicionais, por isso a ordem dos parâmetros é todo o contrato.

**Porque é que o meu template não existe?** Normalmente, por causa do código de idioma. Um template é identificado pelo nome e pelo idioma em conjunto, e não há fallback.

**O que acontece se enviar demasiados parâmetros?** Erro 132000. Enviar demasiados falha da mesma forma que enviar poucos.

**Como envio um montante?** Como parâmetro de moeda, com um montante, um código de moeda e uma string de fallback, não como texto simples.

---

## Limites de taxa e throughput de mensagens

https://easycoexistence.com/pt-pt/docs/rate-limits-and-throughput

Existem quatro limites separados, e confundi-los é o que torna o limite de taxa tão confuso. O limite de mensagens restringe os destinatários únicos por dia em todo o portefólio empresarial, o throughput restringe as mensagens por segundo, o limite por par restringe as mensagens enviadas a uma só pessoa e o limite de gestão restringe as chamadas à API que não são mensagens.

### Nível de mensagens

O número de clientes únicos a quem pode entregar mensagens fora de uma janela de atendimento ao cliente, num período móvel de 24 horas. Desde 7 de outubro de 2025, é definido por portefólio empresarial e partilhado por todos os números que o integram, e sobe automaticamente à medida que a qualidade se mantém e o volume cresce.

- Os limites sobem por degraus: 250, 2.000, 10.000, 100.000 e destinatários únicos ilimitados por dia.
- Só contam as entregas fora de uma janela de atendimento ao cliente.
- As respostas dentro da janela de atendimento não contam.
- Uma descida de qualidade já não faz o limite recuar, mas impede-o de crescer.

### Throughput

Mensagens por segundo, o que é diferente do nível diário. Um número pode estar bem dentro do seu nível e, ainda assim, atingir o limite de throughput se enviar uma rajada.

Num número com Coexistence, este é o limite que mais surpreende, porque é mais baixo do que num número Cloud API padrão. Esse teto é da Meta e aplica-se a todos os fornecedores de Coexistence, pelo que nenhum fornecedor o pode aumentar.

### Limites por destinatário

Um limite à parte para o número de mensagens trocadas entre o seu número e um destinatário numa janela curta, reportado como erro 131056. Existe para evitar que uma pessoa seja inundada, por isso pode ser acionado numa conta com pouco volume.

A causa é quase sempre automática: um ciclo de repetição, um handler de webhook invocado duas vezes para o mesmo evento, ou um bot que divide uma resposta em várias mensagens curtas.

### Limites de chamadas de gestão

Nada têm a ver com mensagens. Ler números, listar templates e consultar o estado contam para um limite de conta separado, reportado como erro 80007.

O que o esgota é o polling. Uma consulta de estado a cada trinta segundos são milhares de chamadas por dia sobre dados que mudam algumas vezes por mês, e os webhooks dispensam quase todas.

### O que faz subir um limite

A qualidade e o histórico, não o pagamento. Não há plano para comprar nem fornecedor que possa levantar um limite em seu nome.

- Manter uma classificação de qualidade verde; são os bloqueios por parte dos destinatários que a fazem baixar.
- Enviar o volume de forma consistente, em vez de em rajadas.
- Concluir a verificação da empresa, um dos caminhos de 250 para 2.000.
- Utilizar pelo menos metade do limite atual; os aumentos acima de 2.000 são automáticos.

- Tratar todos os limites de taxa como um só. Quatro limites diferentes produzem quatro erros diferentes.
- Fazer polling do estado a intervalos curtos. Esgota o limite de gestão com dados que raramente mudam.
- Esperar pagar por um limite mais alto. Os limites mudam com a qualidade e o histórico.

**Porque é que atinjo o limite de taxa com pouco volume?** Provavelmente o limite por destinatário, erro 131056, que restringe as mensagens enviadas a uma só pessoa, independentemente do total da sua conta.

**Posso pagar por um limite de mensagens mais alto?** Não. Os limites sobem automaticamente com a qualidade e o histórico de envios.

**O throughput é mais baixo na Coexistence?** Sim. A Meta limita-o a um valor inferior ao de um número Cloud API padrão, e nenhum fornecedor o pode aumentar.

**O que conta para o limite de gestão?** As leituras e as chamadas de configuração: listar números, templates e estados. Os webhooks evitam quase todas.

---

## Enviar mensagens interativas: botões e listas

https://easycoexistence.com/pt-pt/docs/sending-interactive-messages

As mensagens interativas permitem ao destinatário tocar em botões ou numa lista, em vez de escrever. Existem dois tipos: botões de resposta e mensagens em lista. Ambos têm limites fixos reduzidos, que condicionam o desenho da conversa mais do que qualquer outro factor.

### Botões de resposta

Até três botões por baixo de uma mensagem. O destinatário toca num deles e a resposta chega ao seu webhook como uma mensagem recebida normal, com o id do botão. Assim, faz a correspondência pelo id e não pelo título. Os títulos estão limitados a vinte caracteres, um limite mais curto do que parece e que normalmente obriga a reescrever o texto.

- Máximo de três botões por mensagem.
- Título limitado a 20 caracteres.
- Cada botão inclui um id escolhido por si, devolvido na resposta.
- Cabeçalho, corpo e rodapé opcionais à volta dos botões.

### Mensagens em lista

Um único botão abre um menu com até dez linhas, agrupadas em até dez secções. Cada linha tem um título, uma descrição opcional e um id. Use esta opção quando três botões não forem suficientes. O destinatário tem de abrir a lista antes de ver o conteúdo, por isso o texto do botão assume especial importância.

- Até 10 linhas no total, distribuídas por até 10 secções.
- Título da linha limitado a 24 caracteres e descrição a 72.
- Uma lista por mensagem, sem combinação com botões.
- Não disponível em mensagens template de todas as categorias.

### Como chega a resposta

No mesmo webhook de mensagens que qualquer outra mensagem recebida, com um objeto interactive que identifica o id do botão ou da linha. Não é necessário subscrever nada à parte.

Faça a correspondência pelo id e não pelo título. Os títulos podem ser reescritos por quem edita o texto, mas os ids não mudam. Um processador que faça a correspondência pelo texto falha silenciosamente quando alguém corrige um erro.

### O que muda com a Coexistence

Nada nos próprios botões e listas. São mensagens normais da Cloud API e funcionam da mesma forma num número com Coexistence ou noutro número.

O que muda é o destino da resposta: o toque do cliente chega tanto à aplicação WhatsApp Business no telemóvel como ao seu webhook, porque um número com Coexistence entrega a mensagem nos dois locais. Um processador que responda automaticamente deve considerar que uma pessoa pode responder à mesma mensagem na aplicação.

- Fazer a correspondência das respostas pelo título do botão. Os títulos podem ser editados, os ids não.
- Desenhar para mais de três botões. O limite é rígido e não existe alternativa.
- Esquecer que uma pessoa pode responder ao mesmo toque na aplicação WhatsApp Business.

**Quantos botões posso enviar?** Três. É um limite rígido da plataforma e não existe alternativa.

**O que regressa quando alguém toca num botão?** Uma mensagem recebida normal no webhook de mensagens, com o id atribuído ao botão ou à linha.

**Posso combinar botões e uma lista?** Não. Uma mensagem contém uma opção ou a outra.

**Isto tem custos adicionais?** Não. São mensagens normais, cobradas pela Meta da mesma forma que qualquer outra mensagem nessa conversa.

---

## Enviar multimédia: imagens, vídeo, áudio e documentos

https://easycoexistence.com/pt-pt/docs/sending-media-messages

A multimédia é enviada carregando primeiro o ficheiro e usando o ID devolvido, ou fornecendo à Meta uma ligação pública para o obter. Carregar é mais fiável, e os limites variam por tipo de forma pouco intuitiva.

### Os limites por tipo

São diferentes para cada tipo, e exceder um limite devolve o erro 131053, sem uma descrição útil.

- Imagens: 5 MB. JPEG e PNG.
- Vídeo: 16 MB. MP4 e 3GPP, com vídeo H.264 e áudio AAC.
- Áudio: 16 MB. AAC, AMR, MP3, áudio MP4 e OGG com Opus.
- Documentos: 100 MB. Os tipos de documentos mais comuns, incluindo PDF e formatos Office.
- Autocolantes: 100 KB animados, 500 KB estáticos, apenas WebP.

### Carregar ou usar uma ligação

Há duas formas de enviar o mesmo ficheiro, e falham de maneiras diferentes.

Ao carregar, publica o ficheiro primeiro na Meta e recebe um ID de multimédia para referenciar ao enviar. Ao usar uma ligação, fornece à Meta um URL para obter o ficheiro no momento do envio. A ligação parece mais simples, mas acrescenta uma falha invisível: um URL que abre no seu navegador pode estar inacessível à infraestrutura da Meta devido à localização geográfica, a uma regra de firewall ou a um cookie de sessão que o navegador já possui.

Carregue o ficheiro. É um pedido adicional, mas elimina toda uma classe de falhas.

### Receber multimédia

A multimédia recebida chega como um ID de multimédia, não como bytes. O seu handler obtém o ficheiro separadamente usando esse ID.

- Obtenha-a rapidamente. Os IDs não permanecem válidos indefinidamente.
- Uma obtenção falhada devolve o erro 131052, o que normalmente significa que o carregamento do remetente ficou incompleto.
- Guarde o ficheiro por sua conta se precisar dele mais tarde. A Meta não é um arquivo.
- Registe a mensagem mesmo quando a obtenção da multimédia falha, para preservar o texto e o contexto.

### O que muda com a Coexistência

A multimédia num número com Coexistência funciona exatamente como em qualquer outro número da Cloud API, com os mesmos limites.

A única diferença relevante é o histórico. Quando um número se liga pela primeira vez, a Meta sincroniza mensagens recentes da aplicação WhatsApp Business, mas essa sincronização inclui o texto das mensagens, não um arquivo completo de multimédia. A multimédia anterior à ligação permanece no telemóvel, onde sempre esteve.

- Enviar uma ligação por parecer mais simples. A rede da Meta não é o seu navegador.
- Obter multimédia recebida horas mais tarde. Os IDs de multimédia expiram.
- Exportar vídeo sem verificar o codec. As predefinições do software de edição nem sempre são suportadas.

**Qual é o maior ficheiro que posso enviar?** 100 MB, mas apenas para documentos. O vídeo e o áudio têm um limite de 16 MB, e as imagens de 5 MB.

**Devo carregar o ficheiro ou enviar um URL?** Carregue-o. Assim, a acessibilidade deixa de ser uma causa de falha.

**Durante quanto tempo é válido um ID de multimédia?** Não é válido indefinidamente, por isso a multimédia recebida deve ser obtida assim que o evento chegar.

**A multimédia antiga é sincronizada quando faço a ligação?** Não. A sincronização do histórico inclui o conteúdo recente das mensagens; a multimédia anterior à ligação permanece no telemóvel.

---

## Reações a mensagens: enviar e receber emojis

https://easycoexistence.com/pt-pt/docs/message-reactions

Uma reação associa um único emoji a uma mensagem existente. Para enviar uma, é necessário indicar o message id e o emoji. Para a remover, envia-se a mesma reação com uma cadeia emoji vazia, em vez de chamar uma operação de eliminação.

### Enviar uma reação

Uma mensagem do tipo reaction, que inclui o message id da mensagem à qual se reage e um único emoji. Ao enviar uma segunda reação para a mesma mensagem, substitui-se a primeira em vez de a adicionar, porque cada remetente só pode ter uma reação por mensagem.

O message id tem de ser um que o seu número consiga ver: uma mensagem recebida desse cliente ou uma mensagem que lhe enviou.

### Remover uma reação

É esta a parte que costuma surpreender. Não existe uma chamada de eliminação. Envia-se a mesma mensagem de reação com o campo emoji definido como uma cadeia vazia, o que a remove.

Um processador preparado para esperar um evento de remoção ficará à espera indefinidamente. O que chega é uma reação com um emoji vazio, com a mesma estrutura de uma reação nova, e tem de ser interpretada como remoção através da verificação do campo.

### Receber reações

As reações recebidas chegam no messages webhook como uma mensagem do tipo reaction, indicando o message id ao qual estão associadas e o emoji.

- Subscreva o campo messages; não existe um campo separado para reações.
- Um emoji vazio significa que o cliente removeu a sua reação.
- O message id referenciado é de uma mensagem que enviou ou recebeu anteriormente.
- As reações não reabrem a janela de serviço de 24 horas.

### A janela continua a aplicar-se

Uma reação é uma mensagem, pelo que o seu envio exige que a janela de serviço ao cliente de 24 horas esteja aberta. Reagir a uma mensagem de um cliente com três dias devolve o erro 131047, exatamente como aconteceria com uma mensagem de texto.

Receber uma reação de um cliente reabre a janela, porque qualquer mensagem recebida o faz. Isto é importante para as automatizações: um gosto na sua última mensagem é um sinal válido de que já pode responder livremente.

- Procurar um endpoint de eliminação. A remoção usa a mesma chamada com um emoji vazio.
- Tratar um emoji vazio como malformado. É assim que uma remoção é expressa.
- Enviar uma reação fora da janela de serviço. Falha como qualquer outra mensagem.

**Como removo uma reação?** Envie a mesma mensagem de reação com uma cadeia emoji vazia. Não existe uma chamada de eliminação.

**As reações têm algum custo?** Não. Não iniciam uma conversa faturável.

**Posso reagir a qualquer mensagem?** Apenas a mensagens que o seu número enviou ou recebeu, e somente dentro da janela de serviço de 24 horas.

**A reação de um cliente reabre a janela?** Sim. Qualquer mensagem recebida desse cliente o faz, incluindo uma reação.

---

## Enviar mensagens de localização e contactos

https://easycoexistence.com/pt-pt/docs/sending-location-and-contacts

As mensagens de localização enviam um pin com nome e morada opcionais. As mensagens de contacto enviam um ou mais cartões de contacto. Ambas são simples, mas é importante saber que a localização em tempo real, que é atualizada à medida que alguém se desloca, não está disponível num número Coexistence.

### Mensagens de localização

Latitude e longitude, com um nome e uma morada opcionais apresentados sob o pin. O destinatário vê uma pré-visualização do mapa e pode abri-la na sua própria aplicação de mapas.

Vale a pena indicar o nome e a morada. Sem esses dados, o pin mostra apenas coordenadas, que não dizem ao cliente nada sobre estar ou não a consultar a agência certa.

### Receber uma localização

Quando um cliente partilha a sua localização, esta chega ao messages webhook como uma mensagem do tipo location, com coordenadas e, quando a aplicação do cliente as tiver fornecido, um nome e uma morada.

- As coordenadas estão sempre presentes; o nome e a morada não.
- Uma localização partilhada é uma mensagem, por isso reabre a janela de serviço de 24 horas.
- Considere as coordenadas aproximadas. A precisão do telemóvel varia.
- Guarde apenas o que for necessário. A Meta não é um histórico de localizações.

### Mensagens de contacto

Um ou mais cartões de contacto numa única mensagem, cada um com os campos de um vCard: nomes, telefones, emails, moradas, organização e data de nascimento. O destinatário pode guardar o cartão diretamente.

É útil para fornecer ao cliente os dados da pessoa certa, em vez de escrever um número numa conversa, onde chegaria como texto sem formatação e teria de ser copiado manualmente.

### O que o Coexistence remove

A localização em tempo real é uma das quatro funcionalidades do WhatsApp que a Meta desativa num número quando o Coexistence está ativo, juntamente com mensagens temporárias, multimédia de visualização única e listas de transmissão.

Tentar enviá-la devolve o erro 131051, unsupported message type, que parece um erro de formatação, mas não é. Nenhum fornecedor pode ativá-la: a restrição é da Meta e aplica-se a todos os números Coexistence. Os pins de localização estáticos não são afetados e funcionam normalmente.

- Enviar um pin sem nome ou morada. As coordenadas, por si só, não dizem nada ao cliente.
- Basear uma implementação na localização em tempo real. Está desativada em todos os números Coexistence.
- Interpretar o erro 131051 como um erro de formatação quando o tipo está realmente indisponível.

**Posso enviar a localização em tempo real?** Não num número Coexistence. A Meta desativa-a e nenhum fornecedor pode reativá-la.

**Os pins de localização estáticos funcionam?** Sim, normalmente, com nome e morada opcionais apresentados sob a pré-visualização do mapa.

**Quantos contactos cabem numa mensagem?** Vários. Cada um inclui os campos vCard padrão e pode ser guardado diretamente pelo destinatário.

**Uma localização partilhada reabre a janela de serviço?** Sim. É uma mensagem recebida como qualquer outra.

---

## EasyCoexistence vs AiSensy

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-aisensy

A AiSensy é uma plataforma de marketing WhatsApp e chatbot com planos mensais, popular entre empresas indianas de comércio eletrónico. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistência da Meta, entrega as mensagens ao sistema que já utiliza e cobra por número ligado. Para quem quer um produto onde trabalhar, a AiSensy é a opção adequada; para números e um sistema existente, a EasyCoexistence custa menos.

### O que é cada produto

Não competem pela mesma compra, e esclarecer isso torna a comparação útil.

- AiSensy:: Uma plataforma de interação no WhatsApp, centrada em campanhas de difusão, fluxos de chatbot e uma caixa de entrada partilhada para equipas, vendida em planos mensais por níveis, com limites de contactos e agentes.
- EasyCoexistence:: Infraestrutura de Coexistência. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API funciona no mesmo número e os eventos das mensagens passam diretamente da Meta para o CRM, apoio ao cliente, automatização ou agente de IA. Não há uma aplicação para a equipa passar a utilizar.

### Para quem foi concebido o produto

Ambos ligam o WhatsApp. A tarefa diária que cada um espera que faça é diferente.

- AiSensy:: Uma equipa de marketing que gere campanhas de difusão e funis de chatbot, quer o criador de campanhas, as listas de contactos e as análises num só lugar e aceita trabalhar dentro da plataforma.
- EasyCoexistence:: Uma empresa ou programador que já tem um sistema. Colocamos nele as mensagens do WhatsApp e mantemos a ligação ativa, sem interferir no resto. Se quer campanhas, execute-as onde já vivem os dados dos clientes.

### Manter a aplicação no telemóvel

É o motivo específico para existir a Coexistência e a pergunta que vale a pena fazer a qualquer plataforma.

- AiSensy:: O produto é a caixa de entrada da plataforma, por isso a expectativa é que as conversas sejam tratadas aí, em vez de na aplicação WhatsApp Business de um telemóvel.
- EasyCoexistence:: A aplicação WhatsApp Business continua a funcionar exatamente como antes. A equipa responde no telemóvel, a API vê as mesmas conversas e nenhuma das partes tem de parar. Essa é toda a funcionalidade.

### O que determina a fatura

A diferença estrutural e o fator que decide o total à medida que cresce.

- AiSensy:: Uma subscrição organizada por utilizadores e níveis de plano, por isso a fatura acompanha o tamanho da equipa e as funcionalidades desbloqueadas, quer os lugares sejam utilizados quer não.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não há lugares, e o preço por número diminui à medida que acrescenta números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos.

### O que acontece se sair

Vale a pena perguntar isto sobre qualquer serviço que guarde as suas conversas.

- AiSensy:: A caixa de entrada, o histórico de contactos e as automatizações vivem na plataforma. É isso que os faz funcionar e também o que transforma a saída num projeto de migração.
- EasyCoexistence:: Nada seu fica connosco. As mensagens foram entregues ao seu próprio sistema à medida que chegaram e o número está no próprio Portefólio empresarial Meta do cliente, por isso remover-nos deixa tudo exatamente onde estava.

- Comparar o preço de lugares com o preço por número sem contar ambos para a sua realidade.
- Pagar por uma caixa de entrada quando a equipa já trabalha num CRM.
- Assumir que a ligação ao WhatsApp é diferente. A Cloud API subjacente é da Meta nos dois casos.

**Qual é mais barata?** Para uma empresa com números e um sistema existente, a EasyCoexistence custa muito menos por número. Uma equipa de cinco pessoas numa só caixa de entrada pode preferir pagar por lugares.

**Perco uma caixa de entrada partilhada?** Nunca passa a utilizar uma. As mensagens chegam à ferramenta que a equipa já utiliza, onde já trabalha.

**A ligação ao WhatsApp é diferente?** Não. É a Cloud API da Meta em ambos os casos. O que muda é o que fica à frente dela e a forma como é faturada.

**Tenho campanhas de difusão?** Não através de nós e não lhe são cobradas. As mensagens chegam ao seu próprio sistema, por isso as campanhas são executadas onde já estão os dados dos clientes.

---

## EasyCoexistence vs Interakt

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-interakt

A Interakt é uma plataforma de comércio e apoio ao cliente no WhatsApp, vendida com planos mensais e limites por agente. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistence da Meta, entrega as mensagens no sistema que já utiliza e cobra por número ligado. Para empresas com números e um sistema próprio, connosco é muito mais barato por número.

### O que é cada produto

Não estão a disputar a mesma compra, e deixar isso claro torna a comparação útil.

- Interakt:: Uma plataforma de comércio no WhatsApp com integração de catálogo, notificações de encomendas, caixa de entrada partilhada e automação, vendida com planos mensais e limites de agentes e contactos.
- EasyCoexistence:: Infraestrutura de Coexistence. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API corre no mesmo número e os eventos de mensagens passam diretamente da Meta para o seu CRM, serviço de apoio, automação ou agente de IA. Não existe um produto para onde a sua equipa tenha de mudar.

### Onde vive a lógica de comércio

A verdadeira escolha para uma loja online, e está relacionada com o local onde o seu catálogo já se encontra.

- Interakt:: Dentro da plataforma, ligada à sua loja, o que é conveniente se quiser configurar notificações de encomendas e mensagens de catálogo num só local, sem desenvolvimento.
- EasyCoexistence:: Dentro da sua loja. Entregamos os eventos do WhatsApp ao seu backend, para que as notificações de encomendas sejam enviadas pelo sistema que já sabe o que é uma encomenda. Nada precisa de ser sincronizado com um segundo produto.

### Quanto paga uma agência

É aqui que os preços por agente e por número mais divergem.

- Interakt:: Planos com limites de agentes e contactos, por isso uma empresa que gere números para vários clientes compra licenças e limites por conta.
- EasyCoexistence:: Uma conta pode ter tantos números de clientes quantos quiser, cada um faturado como uma ligação a uma tarifa que diminui com o volume. Não há agentes para contar nem limites de contactos a ultrapassar.

### O que acompanha a fatura

A diferença estrutural e a que determina o total à medida que cresce.

- Interakt:: Uma subscrição baseada em utilizadores e níveis de plano, por isso a fatura acompanha o tamanho da equipa e as funcionalidades desbloqueadas, sendo paga mesmo quando as licenças não são utilizadas.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não há licenças, e a tarifa por número diminui à medida que se adicionam números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos.

### O que acontece se sair

Vale a pena perguntar isto sobre qualquer produto que guarde as suas conversas.

- Interakt:: A caixa de entrada, o histórico de contactos e as automações vivem na plataforma. É isso que os faz funcionar e também o que transforma a saída num projeto de migração.
- EasyCoexistence:: Nada seu fica dentro da nossa plataforma. As mensagens foram entregues ao seu sistema à medida que chegaram, e o número está no próprio Portefólio empresarial da Meta do cliente, por isso remover-nos deixa tudo exatamente onde estava.

- Comparar um preço por licença com um preço por número sem calcular ambos para a sua realidade.
- Pagar por uma caixa de entrada quando a sua equipa já trabalha num CRM.
- Partir do princípio de que a ligação ao WhatsApp é diferente. A Cloud API subjacente é da Meta nos dois casos.

**Qual é mais barato?** Para uma empresa com números e um sistema próprio, connosco é muito mais barato por número. Uma equipa de cinco pessoas numa única caixa de entrada pode preferir pagar licenças.

**Perco uma caixa de entrada partilhada?** Nunca muda para uma. As mensagens chegam à ferramenta que a sua equipa já utiliza, onde já trabalha.

**A ligação ao WhatsApp é diferente?** Não. É a Cloud API da Meta em ambos os casos. O que muda é o que está à frente dela e a forma como é faturada.

**Posso enviar mensagens de catálogo?** Sim, através da Cloud API no seu próprio número e enviadas pelo seu próprio sistema. Não criamos um catálogo porque a sua loja já tem um.

---

## EasyCoexistence vs DoubleTick

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-doubletick

A DoubleTick é uma plataforma de vendas do WhatsApp vendida por utilizador, centrada numa caixa de entrada partilhada para telemóvel. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistence da Meta, envia as mensagens para o sistema que já utiliza e cobra por número ligado. A comparação depende do produto que pretende integrar na sua operação.

### O que é cada produto

Não concorrem pela mesma compra, e esclarecer isso torna a comparação útil.

- DoubleTick:: Uma plataforma de vendas do WhatsApp centrada numa caixa de entrada partilhada no telemóvel, envio em massa e partilha de catálogo, cobrada por licença de utilizador e dirigida a equipas comerciais que trabalham a partir do telemóvel.
- EasyCoexistence:: Infraestrutura Coexistence. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API funciona no mesmo número e os eventos das mensagens vão directamente da Meta para o seu CRM, apoio ao cliente, automação ou agente de IA. Não há uma aplicação para onde a equipa tenha de mudar.

### Como trabalha a equipa comercial no dia a dia

A decisão de compra subjacente a ambos os produtos.

- DoubleTick:: Na aplicação deles, onde funcionam a caixa de entrada partilhada, o catálogo e o envio em massa, num plano que começa nos 2 500 rupias por mês e é cobrado por utilizador, fazendo a factura acompanhar o número de vendedores.
- EasyCoexistence:: No CRM que a equipa já utiliza. Enviamos-lhe a conversa, para que o vendedor veja o WhatsApp junto do registo da oportunidade, em vez de uma aplicação separada que tenha de se lembrar de abrir.

### Quanto custa um segundo número

É comum numa operação comercial com mais de uma linha.

- DoubleTick:: As licenças são a unidade facturável, pelo que um segundo número fica associado a uma subscrição por utilizador que cresce com a equipa.
- EasyCoexistence:: O segundo número é simplesmente o segundo número, à tarifa publicada, que desce à medida que se adicionam mais. O número de pessoas não entra no cálculo.

### O que acompanha a factura

A diferença estrutural e a que determina o total à medida que cresce.

- DoubleTick:: Uma subscrição organizada por utilizadores e níveis de plano, pelo que a factura acompanha a dimensão da equipa e as funcionalidades desbloqueadas, quer as licenças sejam usadas quer não.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não há licenças, e a tarifa por número desce à medida que se adicionam números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que fazia o primeiro e custa menos.

### O que acontece se sair

Vale a pena perguntar isto a qualquer serviço que guarde as suas conversas.

- DoubleTick:: A caixa de entrada, o histórico de contactos e as automações ficam na plataforma. É isso que os faz funcionar e também o que transforma a saída num projecto de migração.
- EasyCoexistence:: Nada seu fica connosco. As mensagens foram entregues ao seu próprio sistema à medida que chegaram e o número está no Portefólio empresarial da Meta do próprio cliente, pelo que remover-nos deixa tudo exactamente onde estava.

- Comparar um preço por licença com um preço por número sem calcular ambos para a sua estrutura.
- Pagar por uma caixa de entrada quando a equipa já trabalha num CRM.
- Assumir que a ligação ao WhatsApp é diferente. A Cloud API subjacente é da Meta em ambos os casos.

**Qual é mais barato?** Por número, a EasyCoexistence custa menos: a partir de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que adiciona números. A DoubleTick começa por cobrar por utilizador.

**Perco uma caixa de entrada partilhada?** Nunca muda para uma. As mensagens chegam à ferramenta que a equipa já utiliza, que é onde já trabalha.

**A ligação ao WhatsApp é diferente?** Não. Em ambos os casos é a Cloud API da Meta. O que muda é o que fica à frente dela e a forma como é facturada.

**Existe uma aplicação para telemóvel?** A nossa é infraestrutura, por isso a equipa usa a aplicação que já tem. A aplicação WhatsApp Business também continua a funcionar no telemóvel durante todo o processo.

---

## EasyCoexistence vs Zoko

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-zoko

A Zoko é uma plataforma de comércio no WhatsApp para lojas Shopify, vendida com planos mensais. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistência da própria Meta, entrega as mensagens ao sistema que já utiliza e cobra por número ligado. Para fluxos Shopify prontos, a Zoko é o produto adequado; para um sistema próprio, a EasyCoexistence tem o custo por número.

### O que é cada produto

Não concorrem pela mesma compra, e deixar isso claro torna a comparação útil.

- Zoko:: Uma plataforma de comércio no WhatsApp criada em torno da Shopify, com catálogo, recuperação de carrinhos abandonados, fluxos de encomendas e caixa de entrada partilhada, vendida com planos mensais.
- EasyCoexistence:: Infraestrutura de Coexistência. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API corre no mesmo número e os eventos de mensagens passam da Meta diretamente para o seu CRM, serviço de apoio, automatização ou agente de IA. Não há um produto para onde a sua equipa tenha de mudar.

### Se tem uma loja Shopify

A resposta honesta, porque se trata de uma compra genuinamente diferente.

- Zoko:: Criada exatamente para isso. A recuperação de carrinhos, o catálogo e os fluxos de encomendas são configurados, em vez de desenvolvidos, o que vale dinheiro se a Shopify for todo o seu negócio e quiser tudo a funcionar esta semana.
- EasyCoexistence:: A camada subjacente. Se a sua loja não for Shopify, ou se a lógica estiver no seu próprio back-end, entregamos-lhe os eventos do WhatsApp e deixamos o seu sistema decidir o significado de cada mensagem. Não há nada para configurar em torno de uma plataforma que não temos.

### O que acontece quando a loja não é todo o negócio

O caso em que uma plataforma nativa de loja deixa de se ajustar.

- Zoko:: Profundidade num ecossistema, a especialização que permite funcionar tão bem dentro dele.
- EasyCoexistence:: Indiferença ao ecossistema. O webhook vai para o seu endpoint, por isso a mesma ligação serve uma loja Shopify, um back-end personalizado, um fluxo n8n ou um agente de IA sem alterar a forma como o número está ligado.

### Ao que corresponde a fatura

A diferença estrutural e a que determina o total à medida que cresce.

- Zoko:: Uma subscrição organizada em torno de utilizadores e níveis de plano, pelo que a fatura acompanha o tamanho da equipa e as funcionalidades desbloqueadas, sendo paga mesmo quando os lugares não são utilizados.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não há lugares, e a tarifa por número diminui à medida que se adicionam números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que fazia o primeiro e custa menos.

### O que acontece se sair

Vale a pena perguntar isto sobre qualquer serviço que guarde as suas conversas.

- Zoko:: A caixa de entrada, o histórico de contactos e as automatizações vivem na plataforma. É isso que os faz funcionar e também o que transforma a saída num projeto de migração.
- EasyCoexistence:: Nada seu fica dentro de nós. As mensagens foram entregues ao seu próprio sistema à medida que chegaram, e o número está no próprio Portefólio empresarial da Meta do cliente, por isso remover-nos deixa tudo exatamente onde estava.

- Comparar o preço de lugares com o preço por número sem calcular ambos para a sua realidade.
- Pagar por uma caixa de entrada quando a sua equipa já trabalha num CRM.
- Partir do princípio de que a ligação ao WhatsApp é diferente. A Cloud API subjacente é da Meta em ambos os casos.

**Qual é mais barata?** Para uma equipa de cinco pessoas numa caixa de entrada, os lugares podem ser a opção adequada. Para uma empresa com vários números e um sistema existente, a EasyCoexistence custa muito menos por número.

**Perco uma caixa de entrada partilhada?** Nunca tem de mudar para uma. As mensagens chegam à ferramenta que a sua equipa já utiliza, onde já trabalha.

**A ligação ao WhatsApp é diferente?** Não. Em ambos os casos é a Cloud API da Meta. O que muda é o que está à frente dela e a forma como é faturado.

**Uso Shopify. Devo usar a Zoko?** A Zoko vende fluxos Shopify configurados num plano mensal. Se a sua lógica já vive na sua loja ou no seu back-end, integramos o WhatsApp por US$ 9 por número e mantém os fluxos onde já estão os dados das encomendas.

---

## EasyCoexistence vs Trengo

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-trengo

O Trengo é uma caixa de entrada multicanal para equipas, com WhatsApp, email, voz e chat, cobrada por utilizador. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistência da Meta, envia as mensagens para o sistema que já utiliza e cobra por número ligado. Para uma equipa que quer uma caixa de entrada, o Trengo é o produto; para quem já tem um sistema, a EasyCoexistence custa menos por número.

### O que é cada produto

Não competem pela mesma compra, e esclarecer isso torna a comparação útil.

- Trengo:: Uma caixa de entrada multicanal para equipas, que reúne WhatsApp, email, chat em direto, voz e redes sociais numa só vista, cobrada por lugar de utilizador e destinada a equipas de apoio que gerem vários canais.
- EasyCoexistence:: Infraestrutura de Coexistência. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API corre no mesmo número e os eventos das mensagens vão directamente da Meta para o seu CRM, helpdesk, automação ou agente de IA. Não há nenhum produto para onde a sua equipa tenha de mudar.

### Uma caixa de entrada para todos os canais

É a sua promessa central, e é uma boa promessa para a equipa certa.

- Trengo:: Email, WhatsApp, chat e voz num só lugar, com atribuição partilhada e regras. Para uma equipa de apoio afogada em separadores, essa consolidação é o produto, e funciona.
- EasyCoexistence:: Nós trabalhamos com um canal e não lhe pedimos para consolidar. Se o seu helpdesk já trata do email e do chat, o WhatsApp chega lá através de um webhook e a sua equipa nunca aprende a utilizar uma segunda ferramenta.

### O que paga quando a equipa cresce

O preço por lugar tem uma lógica própria, que vale a pena ver antes de contratar.

- Trengo:: Por utilizador, por isso cada nova contratação para o apoio acrescenta valor à factura mensal, use ou não o WhatsApp.
- EasyCoexistence:: Por número. Uma equipa de apoio com duas pessoas e outra com vinte pagam o mesmo, porque a unidade facturável é a ligação, não a pessoa.

### O que determina a factura

A diferença estrutural, e a que decide o total à medida que cresce.

- Trengo:: Uma subscrição baseada nos utilizadores e nos níveis do plano, por isso a factura acompanha o tamanho da equipa e as funcionalidades desbloqueadas, quer os lugares sejam utilizados, quer não.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não há lugares, e o preço por número desce à medida que se adicionam números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos.

### O que acontece se sair

Vale a pena perguntar isto a qualquer solução que guarde as suas conversas.

- Trengo:: A caixa de entrada, o histórico de contactos e as automações vivem na plataforma. É isso que as faz funcionar e também o que transforma a saída num projecto de migração.
- EasyCoexistence:: Nada que lhe pertença fica dentro de nós. As mensagens foram entregues ao seu próprio sistema à medida que chegaram e o número está no próprio Portefólio empresarial da Meta do cliente, por isso remover-nos deixa tudo exactamente onde estava.

- Comparar um preço por lugar com um preço por número sem calcular ambos para a sua realidade.
- Pagar por uma caixa de entrada quando a sua equipa já trabalha num CRM.
- Assumir que a ligação ao WhatsApp é diferente. A Cloud API subjacente é da Meta em ambos os casos.

**Qual é mais barato?** Uma equipa de cinco pessoas numa caixa de entrada pode preferir pagar por lugares. Uma empresa com números e um sistema existente paga muito menos por número connosco.

**Perco uma caixa de entrada partilhada?** Nunca tem de mudar para uma. As mensagens chegam à ferramenta que a sua equipa já utiliza, onde já trabalha.

**A ligação ao WhatsApp é diferente?** Não. É a Cloud API da Meta em ambos os casos. O que muda é o que está à frente dela e a forma como é facturada.

**Também preciso de email e chat. Tratam desses canais?** Não, e não cobramos por eles. Ligamos o WhatsApp ao helpdesk que já trata dos seus outros canais.

---

## EasyCoexistence vs Rasayel

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-rasayel

Rasayel é uma caixa de entrada de vendas centrada no WhatsApp, com integrações de CRM e preço por utilizador. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistence da Meta, envia as mensagens para o sistema que já utiliza e cobra por número ligado. O preço mais baixo resulta do tipo de solução pretendida.

### O que é cada produto

Não concorrem pela mesma compra, e esclarecer isso torna a comparação útil.

- Rasayel:: Uma caixa de entrada partilhada centrada no WhatsApp, criada para equipas de vendas, com integrações bidireccionais com CRMs como HubSpot e Pipedrive, cobrada por lugar de utilizador.
- EasyCoexistence:: Infraestrutura Coexistence. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API corre no mesmo número e os eventos das mensagens vão da Meta directamente para o seu CRM, helpdesk, automação ou agente de IA. Não existe um produto para onde a equipa tenha de mudar.

### Como levar o WhatsApp para o CRM

É a maior sobreposição entre os dois produtos e merece uma explicação precisa.

- Rasayel:: A caixa de entrada sincroniza as conversas com o CRM, para que um vendedor possa trabalhar em qualquer dos dois locais e o registo o acompanhe. É um produto real, com engenharia real por trás.
- EasyCoexistence:: A mensagem vai directamente da Meta para o seu CRM, sem uma caixa de entrada intermédia para sincronizar. Existe uma cópia da conversa, em vez de duas, e nada para reconciliar quando uma sincronização falha.

### O que está a pagar

Ambos levam o WhatsApp para um CRM. A factura é calculada de forma diferente.

- Rasayel:: Lugares, porque a caixa de entrada é o produto e cada vendedor precisa de um para trabalhar nela.
- EasyCoexistence:: A ligação. Toda a equipa de vendas lê o WhatsApp dentro do CRM que já paga, e cobramos por número, independentemente de quantas pessoas o utilizam.

### A que acompanha a factura

A diferença estrutural e a que determina o total à medida que cresce.

- Rasayel:: Uma subscrição organizada por utilizadores e níveis de plano, por isso a factura acompanha o tamanho da equipa e as funcionalidades desbloqueadas, sendo paga mesmo quando os lugares não são utilizados.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não há lugares, e o preço por número desce à medida que se adicionam números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos.

### O que acontece se sair

É uma pergunta importante para qualquer solução que guarde as suas conversas.

- Rasayel:: A caixa de entrada, o histórico de contactos e as automações ficam na plataforma. É isso que os faz funcionar e também o que transforma a saída num projecto de migração.
- EasyCoexistence:: Nada que lhe pertença fica connosco. As mensagens foram entregues ao seu sistema à medida que chegaram e o número está no próprio Portefólio empresarial da Meta do cliente, por isso remover-nos deixa tudo exactamente onde estava.

- Comparar um preço por lugar com um preço por número sem calcular ambos para a sua realidade.
- Pagar por uma caixa de entrada quando a equipa já trabalha num CRM.
- Assumir que a ligação ao WhatsApp é diferente. A Cloud API subjacente é da Meta em ambos os casos.

**Qual é mais barato?** Uma equipa de cinco pessoas numa única caixa de entrada pode preferir lugares. Uma empresa com vários números e um sistema existente paga muito menos por número connosco.

**Perco uma caixa de entrada partilhada?** Nunca passa a utilizar uma. As mensagens chegam à ferramenta que a equipa já utiliza, onde já trabalha.

**A ligação ao WhatsApp é diferente?** Não. É a Cloud API da Meta em ambos os casos. O que muda é o que está à frente dela e a forma como é facturada.

**Integram com o HubSpot?** Enviamos o webhook da Meta para qualquer endpoint, por isso um CRM com um webhook de entrada ou uma ferramenta de fluxos de trabalho à sua frente recebe directamente a conversa.

---

## EasyCoexistence vs Callbell

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-callbell

A Callbell é uma caixa de entrada WhatsApp multiagente para equipas pequenas, cobrada por utilizador. A EasyCoexistence é infraestrutura: liga um número através da funcionalidade Coexistência da Meta, entrega as mensagens no sistema que já utiliza e cobra por número ligado. Para escolher a opção mais barata, considere se pretende um produto onde a equipa trabalhe.

### O que é cada produto

Não estão a competir pela mesma compra, e esclarecer isso torna a comparação útil.

- Callbell:: Uma caixa de entrada WhatsApp multiagente para equipas pequenas, com fluxos de chatbot e automação básica, cobrada por licença de utilizador e popular entre pequenas empresas na América Latina e no sul da Europa.
- EasyCoexistence:: Infraestrutura de Coexistência. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API é executada no mesmo número e os eventos das mensagens vão da Meta diretamente para o seu CRM, serviço de apoio, automação ou agente de IA. Não existe um produto para onde a sua equipa tenha de se mudar.

### O caso da equipa pequena

É onde o preço deles é mais razoável e onde a comparação é mais próxima.

- Callbell:: Dois ou três agentes a partilhar um número, com uma caixa de entrada simples e sem CRM para integrar. O preço publicado é por utilizador e por mês, com o WhatsApp como suplemento pago, por isso até esta configuração pequena tem um custo de licenças e um custo de canal.
- EasyCoexistence:: A mesma empresa, se já tiver um sistema. Uma pequena loja que gere encomendas numa folha de cálculo ou num back-end simples recebe o WhatsApp nesse sistema por menos do que custa uma licença, e a equipa continua a responder na aplicação WhatsApp Business como sempre.

### Vários locais, uma conta

O caso que separa claramente as duas opções.

- Callbell:: Cada número e cada agente fazem parte da subscrição, por isso uma cadeia de lojas compra licenças e números em conjunto.
- EasyCoexistence:: Cada local é uma ligação à tarifa publicada, que desce à medida que se adicionam mais. Dez lojas com dez números e quarenta funcionários pagam dez números.

### A que acompanha a fatura

A diferença estrutural e a que determina o total à medida que cresce.

- Callbell:: Uma subscrição organizada por utilizadores e níveis de plano, por isso a fatura acompanha o tamanho da equipa e as funcionalidades desbloqueadas, sendo paga mesmo quando as licenças não são utilizadas.
- EasyCoexistence:: Um número ligado. Adicionar um colega não custa nada porque não existem licenças, e a tarifa por número desce à medida que se adicionam números, de US$ 9 para US$ 1. O quadragésimo número de uma agência faz tudo o que fazia o primeiro e custa menos.

### O que acontece se sair

Vale a pena perguntar isto sobre qualquer serviço que guarde as suas conversas.

- Callbell:: A caixa de entrada, o histórico de contactos e as automações vivem na plataforma. É isso que os faz funcionar e também o que transforma a saída num projeto de migração.
- EasyCoexistence:: Nada seu fica connosco. As mensagens foram entregues ao seu próprio sistema à medida que chegaram, e o número está no próprio Portefólio empresarial da Meta do cliente, por isso remover-nos deixa tudo exatamente onde estava.

- Comparar um preço por licença com um preço por número sem calcular ambos para a sua configuração.
- Pagar por uma caixa de entrada quando a sua equipa já trabalha num CRM.
- Partir do princípio de que a ligação WhatsApp é diferente. A Cloud API subjacente é da Meta nos dois casos.

**Qual é mais barata?** Para uma equipa de cinco pessoas numa caixa de entrada, as licenças podem ser a opção mais barata. Para uma empresa com vários números e um sistema existente, pagará muito menos por número connosco.

**Perco uma caixa de entrada partilhada?** Nunca tem de se mudar para uma. As mensagens chegam à ferramenta que a sua equipa já utiliza, onde já trabalha.

**A ligação WhatsApp é diferente?** Não. É a Cloud API da Meta em ambos os casos. O que muda é o que está à frente dela e a forma como é cobrada.

**A Callbell é mais barata para dois agentes?** Para um número e sem sistema existente, a Callbell pode ser mais barata. Ao adicionar um segundo local ou um CRM, o preço por número da EasyCoexistence torna-se rapidamente mais baixo.

---

## EasyCoexistence vs Baileys

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-baileys

Baileys é uma biblioteca de código aberto que liga ao WhatsApp implementando diretamente o protocolo de dispositivos ligados. Funciona, é gratuita ou barata e acarreta um risco que a via oficial não tem: os termos comerciais do WhatsApp não preveem mensagens automáticas através de uma sessão de dispositivo ligado, e um número usado desta forma pode ser restringido ou banido sem aviso. EasyCoexistence liga o mesmo número através da funcionalidade de Coexistência da Meta.

### Como cada um chega ao WhatsApp

Toda a comparação está aqui, e tudo o resto resulta disso.

- Baileys:: Uma biblioteca TypeScript que implementa o protocolo de dispositivos ligados do WhatsApp através de um websocket. Inicia sessão como o cliente web, lendo um código QR, e mantém a sessão por si própria. Não há aprovação da Meta porque não lhe é solicitada.
- EasyCoexistence:: A Cloud API da Meta, com credenciais emitidas pela Meta para a própria Conta WhatsApp Business do cliente, através da Coexistência. O número é registado na Meta como número de API e a aplicação WhatsApp Business continua a funcionar no telemóvel em simultâneo.

### O que acontece quando algo corre mal

Ambos falham por vezes. O que muda é haver ou não alguém a quem pedir ajuda.

- Baileys:: Um projeto comunitário no GitHub. Quando o WhatsApp altera o protocolo, a biblioteca tem de acompanhar a mudança, e a integração fica indisponível até isso acontecer. Não existe contrato de apoio nem recurso de banimento.
- EasyCoexistence:: Uma ligação na própria infraestrutura da Meta, monitorizada continuamente. Quando cai, lemos o motivo de desligação indicado pela Meta, distinguindo assim catorze dias de inatividade de uma remoção real, e recebe um aviso antes de o cliente dar por isso.

### Quanto custa, honestamente

A via não oficial parece geralmente gratuita, mas a comparação não é realmente sobre o custo da licença.

- Baileys:: Gratuita enquanto biblioteca, mas exige um servidor onde a executar, uma sessão para manter ativa e um engenheiro que a compreenda. O custo está na manutenção e no risco, não na licença.
- EasyCoexistence:: A partir de US$ 9 por número ligado por mês, com alojamento, monitorização e o conector MCP incluídos. Não há servidor para manter, sessão para voltar a ligar nem nada para reconstruir quando o protocolo muda.

### O que cada uma consegue realmente fazer

A parte honesta, e a razão pela qual os projetos não oficiais existem.

- Baileys:: Mais do que a API oficial em alguns aspetos: conversas de grupo, conversas pessoais, presença e confirmações de leitura ao nível do protocolo. É esse alcance que explica a sua existência.
- EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, multimédia e mensagens interativas, com webhooks entregues pela Meta. As conversas de grupo ficam fora da API e as respostas livres precisam de a janela de 24 horas aberta. São regras da Meta e aplicam-se a todos os fornecedores oficiais.

### Quem deve escolher qual

Há uma razão válida para cada opção, e tudo depende do valor que o número tem.

- Um projeto pessoal num número que não faria mal perder: a via não oficial é gratuita e capaz.
- Um número através do qual uma empresa responde a clientes: a via oficial, porque um banimento termina a linha comercial.
- Qualquer situação que envolva o número de um cliente: a via oficial, porque não cabe a si assumir o risco.
- Onde quer que a aplicação WhatsApp Business tenha de continuar a funcionar no telemóvel: Coexistência, que é o que fazemos.

- Testar uma ponte não oficial no número da empresa. Os banimentos chegam sem aviso e sem recurso.
- Interpretar anos de funcionamento sem interrupções como prova de segurança. A aplicação das regras é periódica, não contínua.
- Presumir que um banimento afeta apenas a API. Leva consigo o perfil WhatsApp Business.

**O Baileys funciona mesmo?** Sim, e é por isso que é popular. A questão não é se funciona, mas o que acontece ao número quando o WhatsApp se apercebe.

**Um número pode ser banido por isto?** Sim. Os termos comerciais do WhatsApp não preveem o acesso não oficial, e a aplicação das regras não dá aviso nem permite recurso.

**A minha aplicação WhatsApp Business deixa de funcionar convosco?** Não. Esse é o objetivo da Coexistência: a aplicação no telemóvel continua a funcionar enquanto a Cloud API opera no mesmo número.

**O Baileys é ilegal?** Não é um crime. É uma via que os termos comerciais do WhatsApp não preveem, e a consequência é a aplicação das regras contra o número, não uma ação judicial.

---

## EasyCoexistence vs WPPConnect

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-wppconnect

O WPPConnect é um projeto open-source que automatiza o WhatsApp Web numa sessão de navegador controlada. Funciona, é gratuito ou barato, mas envolve um risco que a via oficial não envolve: os termos comerciais do WhatsApp não preveem mensagens automáticas através de uma sessão de dispositivo ligado, e um número usado desta forma pode ser restringido ou banido sem aviso. O EasyCoexistence liga o mesmo número através da funcionalidade Coexistence da própria Meta.

### Como cada um chega ao WhatsApp

Toda a comparação está aqui, e tudo o resto decorre disso.

- WPPConnect:: Um projeto de automação de navegador que controla o WhatsApp Web numa sessão sem interface, com um wrapper REST por cima. O número é ligado por código QR e a sessão vive no perfil do navegador, pelo que o WhatsApp vê um dispositivo ligado, não um cliente de API.
- EasyCoexistence:: A Cloud API da Meta, com credenciais emitidas pela Meta para a própria conta WhatsApp Business do cliente, através da Coexistence. O número é registado na Meta como número de API e a aplicação WhatsApp Business continua a funcionar no telemóvel ao mesmo tempo.

### O que acontece quando algo corre mal

Ambos falham por vezes. A diferença é saber se existe alguém a quem pedir ajuda.

- WPPConnect:: Uma comunidade open-source, activa e disponível, mas sem obrigação perante ninguém. Uma alteração no WhatsApp Web pode interromper a gestão da sessão, e um banimento não tem via de recurso porque o acesso nunca foi aprovado.
- EasyCoexistence:: Uma ligação na própria infraestrutura da Meta, monitorizada continuamente. Quando cai, lemos o motivo de desligação indicado pela Meta, pelo que catorze dias de inactividade se distinguem de uma remoção real, e recebe um aviso antes de o cliente notar.

### Quanto custa, com honestidade

A via não oficial costuma parecer gratuita, mas a comparação não é realmente sobre o preço da licença.

- WPPConnect:: Gratuito, mais um servidor capaz de executar continuamente um navegador, memória para cada sessão e alguém que a reinicie quando falhar. As configurações com vários números multiplicam esse custo.
- EasyCoexistence:: A partir de US$ 9 por número ligado e por mês, com alojamento, monitorização e o conector MCP incluídos. Não há servidor para executar, sessão para voltar a ligar nem nada para reconstruir quando o protocolo muda.

### O que cada um consegue realmente fazer

A parte honesta, e a razão pela qual os projetos não oficiais existem.

- WPPConnect:: Tudo o que o WhatsApp Web consegue fazer, incluindo grupos e conversas pessoais, o que é genuinamente mais abrangente do que a API oficial. Também é mais lento e pesado, porque existe um navegador no percurso.
- EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, multimédia e mensagens interactivas, com webhooks entregues pela Meta. As conversas de grupo estão fora da API e as respostas livres precisam da janela de 24 horas aberta. Essas são as regras da Meta e aplicam-se a todos os fornecedores oficiais.

### Quem deve escolher qual

Existe um caso real para cada opção, e tudo depende do valor desse número.

- Um projecto pessoal num número que não se importaria de perder: a via não oficial é gratuita e capaz.
- Um número através do qual uma empresa responde aos clientes: a via oficial, porque um banimento termina a linha empresarial.
- Qualquer situação que envolva o número de um cliente: a via oficial, porque não cabe a si assumir o risco.
- Qualquer situação em que a aplicação WhatsApp Business tenha de continuar a funcionar no telemóvel: Coexistence, que é o que fazemos.

- Testar uma ponte não oficial no número empresarial. Os banimentos chegam sem aviso e sem recurso.
- Interpretar anos de funcionamento contínuo como segurança. A aplicação das regras é periódica, não contínua.
- Assumir que um banimento afecta apenas a API. Leva consigo o perfil WhatsApp Business.

**O WPPConnect funciona mesmo?** Sim, e é por isso que é popular. A questão não é se funciona, mas o que acontece ao número quando o WhatsApp repara.

**Um número pode ser banido por isto?** Sim. Os termos empresariais do WhatsApp não preveem o acesso não oficial, e a aplicação das regras não dá aviso nem permite recurso.

**A minha aplicação WhatsApp Business deixa de funcionar convosco?** Não. Esse é o objectivo da Coexistence: a aplicação no telemóvel continua a funcionar enquanto a Cloud API opera no mesmo número.

**Porque é popular no Brasil?** Chegou cedo, a documentação está em português e é gratuito, o que o tornou a opção predefinida para uma geração de integrações locais.

---

## EasyCoexistence vs Evolution API

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-evolution-api

A Evolution API é uma REST API de código aberto que envolve bibliotecas não oficiais do WhatsApp numa interface simples. Funciona, é gratuita ou barata, mas acarreta um risco que a via oficial não tem: os termos comerciais do WhatsApp não preveem mensagens automáticas através de uma sessão de dispositivo ligado, e um número usado desta forma pode ser restringido ou banido sem aviso. A EasyCoexistence liga o mesmo número através da funcionalidade Coexistence da Meta.

### Como cada uma chega ao WhatsApp

Toda a comparação está aqui, e tudo o resto resulta disso.

- Evolution API:: Uma REST API autoalojada e um gestor que envolve bibliotecas de dispositivos ligados numa interface simples, com painel, suporte para várias instâncias e webhooks. A experiência do programador é boa, mas cada instância continua a ser um dispositivo ligado por QR.
- EasyCoexistence:: A Cloud API da Meta, com credenciais emitidas pela Meta para a própria WhatsApp Business Account do cliente, através de Coexistence. O número é registado na Meta como número de API e a aplicação WhatsApp Business continua a funcionar no telemóvel ao mesmo tempo.

### O que acontece quando algo corre mal

Ambas falham por vezes. A diferença é saber se há alguém a quem pedir ajuda.

- Evolution API:: Um projeto de código aberto ativo, com uma comunidade grande. A interface é estável, mas aquilo que envolve não é autorizado, por isso um número banido por acesso não oficial perde-se, independentemente da qualidade do invólucro.
- EasyCoexistence:: Uma ligação na própria infraestrutura da Meta, monitorizada continuamente. Quando cai, lemos o motivo de desligação indicado pela Meta, distinguindo catorze dias de inatividade de uma remoção real, e avisamos antes de o cliente notar.

### Quanto custa, sem rodeios

A via não oficial costuma parecer gratuita, mas a comparação não é realmente sobre o preço da licença.

- Evolution API:: Licença gratuita e autoalojada, pelo que o custo real é a infraestrutura e a pessoa que a mantém. O acabamento torna o arranque barato, mas não altera o que existe por baixo.
- EasyCoexistence:: A partir de US$ 9 por número ligado e por mês, com alojamento, monitorização e o conector MCP incluídos. Não precisa de gerir um servidor, voltar a ligar uma sessão nem reconstruir nada quando o protocolo muda.

### O que cada uma consegue realmente fazer

A parte honesta, e a razão pela qual os projetos não oficiais existem.

- Evolution API:: Enviar e receber mensagens, multimédia, grupos e várias instâncias numa só implementação, com webhooks e um painel utilizável. Para um programador, é a opção não oficial mais agradável disponível.
- EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, multimédia e mensagens interativas, com webhooks entregues pela Meta. As conversas de grupo estão fora da API e as respostas livres precisam de ter aberta a janela de 24 horas. São regras da Meta e aplicam-se a todos os fornecedores oficiais.

### Quem deve escolher qual

Há um caso real para cada uma, e tudo depende do valor do número.

- Um projeto pessoal num número que não faria mal perder: a via não oficial é gratuita e capaz.
- Um número com que uma empresa responde aos clientes: a via oficial, porque um banimento termina a linha empresarial.
- Qualquer caso que envolva o número de um cliente: a via oficial, porque o risco não é seu para assumir.
- Sempre que a aplicação WhatsApp Business tenha de continuar a funcionar no telemóvel: Coexistence, que é o que fazemos.

- Testar uma ponte não oficial no número da empresa. Os banimentos chegam sem aviso e sem recurso.
- Interpretar anos de funcionamento contínuo como segurança. A fiscalização é periódica, não contínua.
- Pressupor que um banimento afeta apenas a API. Leva consigo o perfil WhatsApp Business.

**A Evolution API funciona mesmo?** Sim, e é por isso que é popular. A questão não é se funciona, mas o que acontece ao número quando o WhatsApp deteta o acesso.

**Um número pode ser banido por isto?** Sim. Os termos empresariais do WhatsApp não preveem o acesso não oficial, e a fiscalização não dá aviso nem possibilidade de recurso.

**A minha aplicação WhatsApp Business deixa de funcionar convosco?** Não. Esse é o objetivo de Coexistence: a aplicação no telemóvel continua a funcionar enquanto a Cloud API usa o mesmo número.

**Parece profissional. É mais seguro?** Não. A interface é melhor do que a maioria, mas o acesso subjacente é o mesmo acesso por dispositivo ligado, e a fiscalização atua sobre o número, não sobre o invólucro.

---

## EasyCoexistence vs Whapi

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-whapi

Whapi é um serviço alojado que vende acesso ao WhatsApp através de um gateway não oficial. Funciona, é gratuito ou barato e acarreta um risco que o percurso oficial não tem: um número contactado desta forma viola os termos do WhatsApp e pode ser banido sem aviso. EasyCoexistence liga o mesmo número através da funcionalidade Coexistence da própria Meta.

### Como cada um chega ao WhatsApp

Toda a comparação está aqui, e tudo o resto resulta disso.

- Whapi:: Um gateway alojado com uma API REST e um plano pago. A conveniência é real: não é preciso gerir um servidor nem manter uma biblioteca. No fundo, o número continua ligado como dispositivo, em vez de estar registado na Meta como número de API.
- EasyCoexistence:: A Cloud API da Meta, com credenciais emitidas pela Meta para a própria WhatsApp Business Account do cliente, através de Coexistence. O número fica registado na Meta como número de API e a aplicação WhatsApp Business continua a funcionar no telemóvel em simultâneo.

### O que acontece quando algo corre mal

Ambos falham por vezes. A diferença é saber se existe alguém a quem pedir ajuda.

- Whapi:: Um fornecedor comercial com apoio, algo que uma biblioteca de código aberto não oferece. O apoio não pode reverter um banimento, porque o acesso nunca foi autorizado pela Meta e não existe recurso para isso.
- EasyCoexistence:: Uma ligação na própria infraestrutura da Meta, monitorizada continuamente. Quando cai, lemos o motivo de desligação indicado pela Meta, por isso catorze dias de inatividade distinguem-se de uma remoção real, e recebe um aviso antes de um cliente dar por isso.

### Quanto custa, honestamente

O percurso não oficial costuma parecer gratuito, e a comparação não é realmente sobre o preço da licença.

- Whapi:: Uma mensalidade, por isso não é a opção barata do percurso de código aberto. Paga pela conveniência, mantendo o risco das ferramentas gratuitas.
- EasyCoexistence:: A partir de US$ 9 por número ligado por mês, com alojamento, monitorização e o conector MCP incluídos. Não é preciso gerir um servidor, voltar a ligar uma sessão nem reconstruir nada quando o protocolo muda.

### O que cada um consegue realmente fazer

A parte honesta, e a razão pela qual os projectos não oficiais existem.

- Whapi:: Enviar e receber mensagens, multimédia, grupos e conversas pessoais através de uma API REST simples, sem infraestrutura para gerir. Em termos de funcionalidades, é mais abrangente do que a API oficial.
- EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, multimédia e mensagens interactivas, com webhooks entregues pela Meta. As conversas de grupo ficam fora da API e as respostas livres precisam de ter aberta a janela de 24 horas. São regras da Meta e aplicam-se a todos os fornecedores oficiais.

### Quem deve escolher cada opção

Existe um caso real para cada uma, e depende inteiramente do valor do número.

- Um projecto pessoal num número que não faria mal perder: o percurso não oficial é gratuito e capaz.
- Um número usado por uma empresa para responder a clientes: o percurso oficial, porque um banimento encerra a linha comercial.
- Qualquer situação que envolva o número de um cliente: oficial, porque o risco não é seu para assumir.
- Sempre que a aplicação WhatsApp Business tenha de continuar a funcionar no telemóvel: Coexistence, que é o que fazemos.

- Testar uma ligação não oficial no número da empresa. Os banimentos chegam sem aviso e sem recurso.
- Interpretar anos de funcionamento sem interrupções como segurança. A aplicação das regras é periódica, não contínua.
- Assumir que um banimento afecta apenas a API. Leva consigo o perfil WhatsApp Business.

**Whapi funciona mesmo?** Sim, e é por isso que é popular. A questão não é se funciona, mas o que acontece ao número quando o WhatsApp dá por isso.

**Um número pode ser banido por isto?** Sim. O acesso não oficial viola os termos comerciais do WhatsApp, e a aplicação das regras não dá aviso nem permite recurso.

**A minha aplicação WhatsApp Business deixa de funcionar convosco?** Não. Esse é o objectivo de Coexistence: a aplicação no telemóvel continua a funcionar enquanto a Cloud API funciona no mesmo número.

**É pago, por isso é aprovado pela Meta?** Não. Pagar a terceiros não torna o acesso autorizado. A aprovação resulta da emissão de credenciais pela Meta para o número, que é o que Coexistence faz.

---

## Os melhores fornecedores de Coexistência do WhatsApp

https://easycoexistence.com/pt-pt/compare/best-whatsapp-coexistence-providers

Uma lista curta, porque a Coexistência é mais recente do que a indústria da API do WhatsApp e a maioria dos fornecedores ainda não a suporta. Estes são os que a suportam, com os preços e o tipo de negócio a que cada um se destina.

### 1. EasyCoexistence, para um negócio ou agência que quer apenas a ligação

Estamos em primeiro na nossa própria lista, por isso leia o resto e confirme as fontes. O caso é específico e verificável: o preço inicial publicado mais baixo desta lista, um modelo por número sem lugares nem níveis de plano, eventos de mensagens entregues pela Meta diretamente no seu sistema, em vez de outra caixa de entrada, monitorização contínua que lê o motivo de desligação indicado pela Meta e um conector MCP para um assistente de IA executar tudo.

- A partir de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que acrescenta números.
- Sem lugares, contrato ou taxa de configuração, com três dias grátis.
- Margem zero: a Meta cobra diretamente ao cliente pelas conversas.
- Dezasseis ferramentas MCP através de OAuth para Claude, ChatGPT, Cursor e Claude Code.

### 2. YCloud, para uma equipa que quer uma plataforma à sua volta

É a alternativa mais próxima em termos de posicionamento: suporta abertamente a Coexistência e compromete-se com margem zero nas mensagens do WhatsApp, os dois aspetos mais importantes. A diferença está na fatura. Os planos pagos começam nos US$ 39 por mês, estruturados por lugares de utilizador, canais e créditos de IA, antes de contar um único número. O nosso começa nos US$ 9 por número ligado, sem lugares nem créditos, por isso um negócio com um a três números paga uma fração, e uma agência com quarenta paga uma tarifa que desce para US$ 5.

### 3. SleekFlow, para uma equipa que trabalha numa caixa de entrada partilhada

Incluem a Coexistência entre as suas soluções e o produto é uma caixa de entrada omnicanal com campanhas e automatizações, cobrada por lugar de utilizador, com um número mínimo de lugares e um extra para números adicionais do WhatsApp. Este modelo serve uma equipa de vendas ou apoio ao cliente que quer trabalhar num só lugar. Serve mal um negócio com várias localizações, porque os lugares e os extras por número aumentam ambos os custos.

### 4. 8x8, para uma empresa que já compra serviços de comunicações

A documentação da Coexistência é a mais clara de qualquer fornecedor e vale a pena lê-la, independentemente da escolha, incluindo a nossa. O produto é uma CPaaS empresarial vendida com centro de contacto e voz, através de equipas de conta e acordos comerciais, o que faz sentido se já estiver a consolidar a despesa de comunicações. Para um número e um webhook, é uma forma pesada de chegar ao mesmo resultado.

### 5. Dualhook, um especialista direto

Usam a mesma arquitetura que nós: Coexistência com encaminhamento por webhook diretamente da Meta, sem armazenamento de mensagens, a um preço publicado. O valor publicado é US$ 12 por número, contra US$ 9 connosco; avisam aos treze dias que a contagem está a decorrer, em vez de lerem o motivo de desligação indicado pela Meta, e a documentação não descreve um conector MCP.

### O que perguntar a qualquer um deles antes de assinar

Quatro perguntas que distinguem os fornecedores desta lista e que uma página comercial não responde por si só.

- O número permanece no meu próprio Portefólio empresarial da Meta e a Meta cobra-me diretamente?
- Acrescentam algum valor por mensagem e esse valor é discriminado separadamente da tarifa da Meta?
- Voltam a aplicar o override do webhook depois de uma reconexão ou a entrega para silenciosamente?
- O que fazem quanto à regra de inatividade de catorze dias e leem o motivo de desligação indicado pela Meta?

- Escolher com base no número de funcionalidades. A Coexistência é o mecanismo da Meta, por isso a plataforma subjacente é idêntica em todo o lado.
- Assumir que um fornecedor suporta a Coexistência porque suporta o WhatsApp. A maioria ainda não suporta.
- Comparar o preço por lugar com o preço por número sem contar ambos para o seu próprio caso.

**Porque estão em primeiro na vossa própria lista?** Porque consideramos que o caso é sólido: o preço inicial publicado mais baixo desta lista, sem lugares, margem zero e monitorização incluída. Todos os valores têm fontes, por isso confirme-os.

**Que fornecedores suportam a Coexistência?** Muito menos do que os que suportam o WhatsApp em geral. Os fornecedores desta lista declaram-no nos próprios sites; a maioria da indústria da API do WhatsApp ainda não a oferece.

**O fornecedor altera aquilo que a Coexistência pode fazer?** Não. A funcionalidade é da Meta, por isso os limites são idênticos em todo o lado: as mesmas quatro funcionalidades desativadas, a mesma regra de catorze dias e ausência de conversas de grupo.

**Qual é a opção mais barata?** A nossa, ao preço inicial publicado, e a diferença aumenta com o número de linhas, porque a nossa tarifa por número diminui, enquanto os preços por lugar e por plano não diminuem.

---

## Os melhores fornecedores da Cloud API do WhatsApp

https://easycoexistence.com/pt-pt/compare/best-whatsapp-cloud-api-providers

Todos os fornecedores aqui ligam-se à mesma Cloud API, porque é da Meta e só existe uma. O que muda é a forma de cobrança, que os divide claramente em três grupos: uma taxa por mensagem, uma taxa por utilizador ou uma taxa por número ligado.

### Os três modelos de preços, a verdadeira escolha

As listas de funcionalidades parecem iguais porque a API subjacente é idêntica. A forma de calcular a fatura não é, e determina quanto paga à medida que a empresa cresce.

- Por mensagem: uma taxa por cada mensagem, por isso o custo aumenta exactamente com o sucesso da empresa.
- Por utilizador: uma taxa por pessoa, por isso o custo aumenta com a equipa e é pago quer iniciem sessão quer não.
- Por número: uma taxa por ligação, que deixa de aumentar quando o número está ligado.

### Fornecedores que cobram por mensagem

O grupo CPaaS. A Twilio publica US$ 0.005 por mensagem recebida e enviada, além das taxas da Meta. A Gupshup publica uma taxa de plataforma standard de US$ 0.001 por mensagem. A Bird apresenta uma tarifa combinada que já inclui a taxa da Meta, pelo que a margem existe, mas não pode ser comparada com a tarifa publicada pela Meta. A Infobip apresenta preços por país de destino através da equipa comercial. As quatro são plataformas capazes, e todas fazem com que o custo da plataforma dependa do volume de mensagens.

### Fornecedores que cobram por utilizador

O grupo das caixas de entrada. SleekFlow, Wati e Respond.io vendem uma caixa de entrada partilhada com campanhas e automação, cobrada por utilizador, com vários níveis de plano e, em vários casos, um suplemento por número do WhatsApp. É a compra certa se pretende que a equipa trabalhe todo o dia dentro de um único produto. É a escolha errada se a equipa já tem um CRM, porque paga pela segunda caixa de entrada quer alguém a abra quer não.

### Fornecedores que cobram por número

O grupo de infraestrutura, e o mais pequeno. A EasyCoexistence cobra a partir de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que adiciona números, sem qualquer custo por mensagem nem utilizadores. A Dualhook é a outra especialista com um preço publicado por número. O modelo serve uma empresa que já tem um sistema e quer ligá-lo ao WhatsApp, bem como uma agência com muitos números de clientes, onde uma tarifa decrescente por número se acumula.

### Onde os modelos se cruzam

Vale a pena calcular em vez de presumir, e a aritmética é curta.

- A US$ 0.005 por mensagem, uma tarifa de US$ 9 por número é mais barata acima de cerca de 1,800 mensagens por mês.
- A US$ 0.001 por mensagem, o ponto de equilíbrio é de cerca de 9,000 mensagens por mês.
- Um modelo por utilizador cruza-se com base no número de pessoas, não no volume, por isso compare utilizadores com números.
- As taxas de conversação da Meta são iguais em todos os modelos e não são o elemento comparado.

### O que nenhum deles muda

É importante saber isto antes de uma comparação de funcionalidades o convencer do contrário.

- A Cloud API é da Meta, pelo que a fiabilidade e a capacidade são da plataforma, não do fornecedor.
- A aprovação de templates é uma decisão da Meta, e nenhum fornecedor a acelera.
- A classificação de qualidade e o nível de mensagens são definidos pela Meta com base no comportamento dos destinatários.
- A Coexistência, quando suportada, tem limites idênticos em todo o lado porque a funcionalidade é da Meta.

- Comparar funcionalidades em destaque. A API subjacente é a mesma da Meta em todos os casos.
- Ignorar o volume de cruzamento. Um décimo de cêntimo não é nada até o multiplicar por um ano.
- Assumir que uma tarifa combinada por mensagem não tem margem. Significa que a margem não está discriminada.

**A Cloud API de um fornecedor é mais rápida do que a de outro?** Não. Em todos os casos, é a API da Meta. Um fornecedor só pode alterar o que fica à frente dela e o que cobra.

**Qual é o modelo mais barato?** Por número, acima de um volume moderado. À tarifa publicada pela Twilio, o ponto de equilíbrio ronda as 1,800 mensagens por mês; à da Gupshup, ronda as 9,000.

**Preciso mesmo de um fornecedor?** Para aceder à Cloud API através de um número que já utiliza a aplicação WhatsApp Business, sim: o onboarding da Coexistência requer um Meta Tech Provider.

**Quem me cobra pelas mensagens?** A Meta, se o seu fornecedor não as revender. Connosco, a Meta factura-lhe directamente e nunca acrescentamos margem.

---

## Os melhores servidores MCP para WhatsApp

https://easycoexistence.com/pt-pt/compare/best-whatsapp-mcp-servers

Ao procurar um servidor MCP para WhatsApp, a maioria dos resultados são projetos de código aberto que iniciam sessão no WhatsApp como dispositivo ligado. Funcionam, mas expõem o número a risco. A distinção importante não está nas funcionalidades, mas em saber se o servidor comunica com a API oficial da Meta.

### A divisão importante

Todos os servidores MCP para WhatsApp ficam de um lado de uma única linha, e essa linha não diz respeito às ferramentas.

- Oficial: o servidor chama a Cloud API da Meta com credenciais emitidas pela Meta. É autorizado e o número está protegido.
- Não oficial: o servidor utiliza uma biblioteca que inicia sessão como dispositivo ligado, tal como o cliente Web.
- A via não oficial não exige aprovação da Meta, razão pela qual é comum em projetos de código aberto.
- Também viola os termos do WhatsApp, e os números são banidos por esse motivo sem recurso nem aviso.

### Os projetos de código aberto que encontrará

A maioria dos servidores MCP para WhatsApp no GitHub baseia-se em bibliotecas como Baileys, WPPConnect ou Venom, que fazem engenharia inversa do protocolo de dispositivos ligados. São genuinamente engenhosos, gratuitos e dão a um assistente acesso a conversas pessoais e grupos que a API oficial não disponibiliza. O custo é a conta: um número banido desta forma leva consigo o perfil do WhatsApp Business, e não existe um canal de apoio para contestar. Para um número pessoal que alguém esteja disposto a perder, essa troca pode fazer sentido. Para o número através do qual uma empresa responde aos clientes, não faz.

### O que implica realmente executar um

A diferença prática, além do risco, e aquela que se torna evidente ao segundo dia.

- Um processo de servidor local, normalmente num portátil, que tem de continuar em execução para o assistente funcionar.
- Uma leitura de código QR para ligar o dispositivo, repetida sempre que a sessão cai.
- Credenciais num ficheiro de configuração local, onde passa a ficar um token da API.
- Nenhuma ligação entre o assistente e o número quando o portátil entra em suspensão.

### EasyCoexistence, a via oficial

Um servidor MCP remoto através de OAuth, sem nada para instalar e sem token num ficheiro de configuração. Dezasseis ferramentas abrangem as tarefas que as pessoas realmente pedem a um assistente: listar números, verificar o estado de um número, ler credenciais da API, enviar uma mensagem, listar, criar e enviar templates, verificar o estado dos templates, apontar o webhook para o seu sistema, pesquisar a documentação e iniciar uma nova ligação. Outras cinco configuram a Partner API: estado da configuração, chave de API, URL de eventos e links de ligação alojados. Funciona quer o portátil esteja aberto quer não, porque é alojado, e o número subjacente utiliza a Cloud API oficial da Meta através de Coexistence, por isso a aplicação WhatsApp Business continua a funcionar e nada fica em risco.

### O que a via oficial não consegue fazer

É importante dizê-lo claramente, porque é a razão da existência dos projetos não oficiais e deve saber isto antes de escolher.

- As conversas de grupo estão totalmente fora da Cloud API, em todos os fornecedores oficiais.
- Não é possível aceder às conversas pessoais de uma conta WhatsApp de consumidor.
- As respostas livres só funcionam durante a janela de atendimento de 24 horas; fora dela, um template aprovado abre a conversa.
- Estas são regras da Meta, não nossas, e nenhum fornecedor oficial pode eliminá-las.

- Avaliar um servidor MCP pelo número de ferramentas. A questão é saber se comunica com a API da Meta ou se finge ser um telemóvel.
- Testar uma ponte não oficial no número da empresa. Os banimentos chegam sem aviso e sem recurso.
- Partir do princípio de que um servidor local é privado. Um token num ficheiro de configuração num portátil é a opção mais fraca.

**Os servidores MCP do WhatsApp de código aberto são seguros?** Funcionam e iniciam sessão como dispositivo ligado, o que viola os termos do WhatsApp. Os números são banidos por esse motivo sem aviso.

**Um servidor MCP oficial pode ler as minhas conversas de grupo?** Não. As conversas de grupo estão fora da Cloud API da Meta em todos os fornecedores oficiais, incluindo nós.

**Tenho de instalar alguma coisa?** Não. O nosso é um servidor remoto através de OAuth, por isso adiciona um endpoint e inicia sessão. Nada é executado no seu dispositivo.

**Que assistentes podem utilizá-lo?** Qualquer cliente MCP. Claude, ChatGPT, Cursor e Claude Code são os que documentamos.

---

## EasyCoexistence vs Twilio

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-twilio

A Twilio é uma plataforma de comunicações generalista que revende o WhatsApp entre vários canais, com uma tarifa publicada por mensagem além da própria Meta. A EasyCoexistence faz uma coisa: liga um número da aplicação WhatsApp Business através de Coexistence e cobra um valor fixo por número.

### Para que serve cada uma

Os produtos destinam-se a problemas diferentes, e é importante esclarecer isso primeiro.

- Twilio:: Uma plataforma de comunicações para SMS, voz, email e WhatsApp, criada para equipas de engenharia que integram mensagens em vários canais. O WhatsApp é apenas um canal, com o mesmo modelo de preço dos restantes: por mensagem.
- EasyCoexistence:: Uma especialista em Coexistence. A aplicação WhatsApp Business no telemóvel continua a funcionar, a Cloud API usa o mesmo número, os eventos de mensagens vão para o seu próprio endpoint e monitorizamos a ligação. Uma tarefa, feita por completo.

### O que acontece ao preço à medida que cresce

Esta é a diferença que se acumula, e resulta de aritmética, não de opinião.

- Twilio:: US$ 0.005 por mensagem, recebida ou enviada, além do que a Meta cobrar. A tarifa cresce com cada conversa, pelo que o custo da plataforma depende do desempenho da empresa.
- EasyCoexistence:: Um valor fixo por número ligado. Dez mil mensagens num mês custam o mesmo que dez. O sucesso torna a plataforma mais barata por mensagem, não mais cara, e o preço por número também diminui com volume.

### Quem detém a conta do WhatsApp

O local onde ficam o número e a relação com a Meta determina a facilidade com que qualquer uma das partes pode sair.

- Twilio:: Os números são integrados através dos remetentes da Twilio, e a relação de mensagens passa pela infraestrutura da Twilio, onde também fica a relação de faturação.
- EasyCoexistence:: O número permanece no Portefólio empresarial Meta do cliente, na sua própria WhatsApp Business Account, com a Meta a faturar-lhe diretamente as conversas. Somos o Tech Provider que o ligou, e remover-nos não leva o número consigo.

### Para onde vão as mensagens

Ambas entregam as mensagens recebidas num servidor que controla. O que muda é o percurso e o que nele se encontra.

- Twilio:: As mensagens recebidas chegam ao seu webhook através da Twilio, que processa e fatura cada uma à medida que passa.
- EasyCoexistence:: Definimos o override_callback_uri da própria Meta na WhatsApp Business Account, para que os eventos de mensagens passem diretamente da Meta para o seu endpoint. Não passam por nós, não as armazenamos e não há nada no percurso para contabilizar.

### Aceder através de um assistente de IA

A pergunta mais recente, e aquela a que uma plataforma generalista tem menos razões para responder.

- Twilio:: Uma API REST completa, com SDKs para as principais linguagens, faturada à tarifa publicada de US$ 0.005 por mensagem. A integração que escrever é faturada sempre que envia ou recebe.
- EasyCoexistence:: A mesma API por baixo, mais um conector MCP remoto com dezasseis ferramentas através de OAuth, para que Claude, ChatGPT, Cursor e Claude Code possam listar números, verificar o estado, enviar mensagens e definir destinos de webhook sem escrever um cliente.

- Comparar apenas a tarifa principal. Uma cobrança por mensagem e uma cobrança por número cruzam-se num volume que deve ser calculado primeiro.
- Assumir que uma plataforma grande significa uma ligação WhatsApp melhor. A Cloud API subjacente é sempre da própria Meta.
- Ignorar quem a Meta fatura. Um fornecedor entre si e a fatura da Meta é um fornecedor que pode aplicar uma margem.

**A Twilio é mais barata com pouco volume?** Abaixo de cerca de dois mil mensagens por mês, a tarifa por mensagem é pequena. Acima desse valor, o preço fixo por número compensa e continua a compensar à medida que o volume cresce.

**A Twilio disponibiliza Coexistence?** A página de preços do WhatsApp não aborda o tema. Coexistence é aquilo para que fomos criados, por isso a aplicação WhatsApp Business continua a funcionar no mesmo número.

**A API é diferente?** Não. A Cloud API subjacente é da própria Meta nos dois casos. O que muda é quem está no percurso, o que cobra e quem a Meta fatura.

**Posso transferir um número mais tarde?** Connosco, sim: o número permanece no seu próprio Portefólio empresarial, por isso remover-nos deixa-o exatamente onde estava.

---

## EasyCoexistence vs Gupshup

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-gupshup

A Gupshup é uma plataforma de mensagens conversacionais que cobra uma taxa publicada por mensagem, além dos custos de conversação da Meta. A EasyCoexistence cobra uma mensalidade fixa por número ligado e não acrescenta nada à fatura de mensagens, uma diferença que se multiplica com o volume.

### A estrutura da fatura

Um décimo de cêntimo parece insignificante, mas, à escala, representa toda a conversa.

- Gupshup:: Uma taxa padrão de US$ 0.001 por mensagem, além da Meta, aplicada tanto a mensagens de template como de sessão. Com cem mil mensagens por mês, são cem dólares de taxa da plataforma antes dos custos da Meta.
- EasyCoexistence:: Nada por mensagem. Cem mil mensagens custam o mesmo que dez, porque a taxa segue o número e não o tráfego. Quanto mais utilizado o número, menor é a nossa taxa por conversa.

### Em torno de que é criada a plataforma

Ambas ligam o WhatsApp. Estão organizadas em torno de tarefas diferentes.

- Gupshup:: Uma plataforma conversacional com criação de bots, ferramentas de campanha e uma lista ampla de canais, dirigida a empresas que executam programas de envio em grande escala.
- EasyCoexistence:: Infraestrutura de Coexistence. A aplicação WhatsApp Business continua a funcionar no telemóvel, a Cloud API funciona no mesmo número e os eventos de mensagens chegam ao sistema ou agente de IA que já utiliza. Não lhe pedimos que mude a sua equipa para outro lugar.

### Onde ficam os dados das conversas

A resposta determina quanto do seu negócio funciona dentro do produto de outra empresa.

- Gupshup:: As mensagens passam pela plataforma, o que permite disponibilizar o criador de bots, as ferramentas de campanha e as análises. É uma troca razoável se pretende essas funcionalidades.
- EasyCoexistence:: Os eventos de mensagens vão diretamente da Meta para o seu endpoint através da substituição do webhook da própria Meta. Nunca vemos o conteúdo das conversas, por isso não há nada seu para extrair se sair nem nada no percurso para contabilizar.

### Ligar um número que já tem a aplicação

O problema específico para o qual Coexistence foi criado.

- Gupshup:: A página de preços publicada pela Gupshup não aborda Coexistence. Isso não prova que não o suporte e é a pergunta certa para lhes colocar diretamente.
- EasyCoexistence:: Este é todo o produto. Um número que já utiliza a aplicação WhatsApp Business liga-se através do Embedded Signup da própria Meta, mantém a aplicação a funcionar e obtém a Cloud API no mesmo número em poucos minutos.

- Considerar US$ 0.001 insignificante. Multiplique esse valor por um ano de volume real antes de decidir.
- Pagar por ferramentas de campanha que não vai utilizar. A taxa da plataforma cobre todo o produto, seja utilizado ou não.
- Assumir que qualquer fornecedor suporta Coexistence. Pergunte especificamente, seja qual for a sua escolha.

**Quanto custa realmente a taxa por mensagem?** Com cem mil mensagens por mês, os US$ 0.001 publicados pela Gupshup representam US$ 100 de taxa da plataforma. A nossa taxa por um número é de US$ 9, qualquer que seja o volume.

**A Gupshup suporta Coexistence?** A página de preços não o menciona. Coexistence é tudo o que fazemos.

**Perco funcionalidades de campanha convosco?** Não somos uma ferramenta de campanhas nem cobramos como tal. As mensagens chegam ao seu próprio sistema, por isso as campanhas são executadas onde já as executa.

**Quem paga à Meta?** O cliente paga diretamente, na sua própria conta WhatsApp Business. Nunca aplicamos margem a uma cobrança da Meta.

---

## EasyCoexistence vs Infobip

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-infobip

A Infobip é uma plataforma empresarial de comunicações, com preços do WhatsApp definidos por país e tratados através da equipa comercial. A EasyCoexistence publica o seu preço, oferece três dias grátis e liga um número sem falar com ninguém. É um produto diferente para um comprador diferente.

### Para quem foi criado cada produto

Nenhum é um produto pior. São vendidos a pessoas diferentes, e isso determina quase tudo o resto.

- Infobip:: Uma CPaaS empresarial, com encaminhamento omnicanal, ferramentas de centro de contacto e relações globais com operadores, vendida por equipas de conta a organizações com processos de aprovisionamento e compromissos de volume.
- EasyCoexistence:: Uma pequena empresa ou agência que já tem um número do WhatsApp Business e quer tê-lo na Cloud API ainda hoje. Regista-se, liga o número e está feito. Não há ninguém com quem falar porque não há nada para negociar.

### O que pode saber antes de se comprometer

A diferença mais prática, e aquela que se sente primeiro.

- Infobip:: As tarifas são apresentadas por país de destino e tratadas com a equipa comercial, o que é normal numa CPaaS empresarial e serve compradores que negoceiam volumes anuais.
- EasyCoexistence:: Toda a tabela de preços está na página de preços, na sua moeda, com os escalões de volume visíveis. Pode calcular o custo antes de criar uma conta, e os primeiros três dias não custam nada.

### Tempo entre a decisão e um número funcional

Para uma empresa com um número e um problema real, esta é a comparação que importa.

- Infobip:: Um processo de integração empresarial, que inclui apoio dedicado e ajuda na configuração, necessidades reais em implementações de grande dimensão.
- EasyCoexistence:: Minutos. O Embedded Signup da própria Meta seleciona o portefólio, a conta e o número, a aplicação WhatsApp Business continua a funcionar durante todo o processo e a monitorização começa de imediato.

### O que acontece quando a ligação falha

Todas as ligações de Coexistência acabam por ter um dia mau. O que muda é quem dá por isso.

- Infobip:: Canais de apoio empresarial e uma equipa de conta, o modelo certo quando existe um contrato e um contacto identificado por trás dele.
- EasyCoexistence:: Monitorizamos continuamente a ligação e lemos o motivo de desligação indicado pela própria Meta. Assim, um número desligado por 14 dias de inatividade distingue-se de um cliente que saiu efetivamente. O alerta chega antes de o cliente dar por isso.

- Comparar uma CPaaS empresarial com uma ferramenta por número apenas pelas funcionalidades. Respondem a perguntas diferentes.
- Iniciar um ciclo de aprovisionamento para um número. O tempo gasto custa mais do que a ferramenta num ano.
- Partir do princípio de que uma cotação será mais barata do que um preço publicado em pequenos volumes. Raramente é.

**Porque é que a Infobip não publica um preço fixo?** Os preços são definidos por país de destino, o que serve compradores empresariais que negoceiam volumes. O nosso preço é publicado porque o nosso comprador quer decidir hoje.

**A Infobip é melhor para uma grande empresa?** Foi criada para esse comprador, com alcance global junto de operadores e equipas de conta. Para uma empresa que liga os seus próprios números, somos a opção mais rápida e económica.

**Preciso de falar com alguém para começar?** Não. Tem três dias grátis no primeiro número ligado, e o número é ligado através do Embedded Signup da própria Meta.

**Quem me cobra as mensagens?** A Meta cobra diretamente na sua própria WhatsApp Business Account. Nunca aparecemos nessa fatura.

---

## EasyCoexistence vs YCloud

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-ycloud

A YCloud suporta Coexistence e, tal como nós, não acrescenta margem às tarifas de mensagens da Meta. A diferença está no que compra: os planos pagos são subscrições de uma plataforma com lugares, canais e créditos de IA, enquanto a nossa é infraestrutura com preço por número ligado.

### O que ambas fazem bem

Vale a pena dizê-lo claramente, porque reduz a comparação ao que realmente difere.

- YCloud:: A Coexistence é suportada e declarada abertamente, e a página de preços compromete-se com margem zero nas mensagens do WhatsApp. Nos dois aspetos mais importantes de um fornecedor, estão do lado certo.
- EasyCoexistence:: Os mesmos dois compromissos. Coexistence através do fluxo da própria Meta e nada acrescentado a uma mensagem da Meta. A diferença está em tudo o resto.

### O que a subscrição compra realmente

Este é o verdadeiro ponto de divergência e determina qual é mais barato para si.

- YCloud:: Uma plataforma. Os planos pagos começam nos US$ 39 por mês e distinguem-se pelo número de utilizadores, canais e créditos de IA, o formato certo se pretende uma equipa a trabalhar dentro do produto.
- EasyCoexistence:: Infraestrutura. A partir de US$ 9 por número ligado, sem lugares para contabilizar, níveis de canais ou créditos que se esgotem. Uma empresa com um número paga por um número, e uma agência com quarenta paga uma tarifa decrescente por número.

### Onde terminam as conversas

Ambas ligam à mesma Cloud API. O que acontece depois às mensagens é uma decisão de arquitetura.

- YCloud:: A plataforma deles, onde ficam a caixa de entrada, as campanhas e os créditos de IA, a partir de US$ 39 por mês antes de contar qualquer número. A sua equipa trabalha ali porque é onde estão as mensagens.
- EasyCoexistence:: O seu sistema. Definimos a substituição do webhook da própria Meta para que os eventos de mensagens passem diretamente da Meta para o seu endpoint ou para o seu agente de IA através de MCP. Não há nada para migrar para dentro ou para fora, nem uma segunda caixa de entrada para a equipa consultar.

### O que uma agência paga ao crescer

É o caso em que os dois modelos mais divergem.

- YCloud:: Níveis de planos com contagem de lugares, pelo que o crescimento implica uma série de decisões de atualização à medida que são adicionadas pessoas e canais.
- EasyCoexistence:: Uma tarifa por número que diminui à medida que são adicionados números, de US$ 9 até US$ 1. Não há conversa sobre atualização porque não existe nada para atualizar: o quadragésimo número faz tudo o que o primeiro fazia, por menos.

### Aceder a partir de um assistente de IA

É o aspeto que os níveis dos planos de nenhuma das plataformas descrevem e que começa a ser uma questão frequente.

- YCloud:: Os créditos de IA fazem parte da estrutura de planos deles, apontando para funcionalidades de IA integradas no produto.
- EasyCoexistence:: Um conector MCP remoto com dezasseis ferramentas através de OAuth. Claude, ChatGPT, Cursor e Claude Code podem listar números, verificar o estado da ligação, enviar mensagens e templates e definir destinos de webhook diretamente, sem desenvolver um cliente nem comprar créditos.

- Comparar um plano por lugar com uma tarifa por número sem contar primeiro os seus lugares e números.
- Pagar por uma caixa de entrada quando a sua equipa já tem uma. A tarifa da plataforma cobre-a, quer a abra quer não.
- Assumir que as funcionalidades de IA e um conector MCP são a mesma coisa. Uma funciona dentro do produto deles; o outro funciona dentro do seu.

**Ambos acrescentam realmente margem zero?** Sim. A página de preços da YCloud declara margem zero e nós também. Por isso, deve comparar a tarifa da plataforma, não a tarifa das mensagens.

**Qual é mais barato?** Para um a quatro números, a nossa opção: quatro números custam US$ 36 por mês, contra um plano de entrada de US$ 39. A partir de cinco números, compare o nosso total, com uma tarifa que desce até US$ 1 por número à medida que adiciona números, com o nível de plano de que os seus utilizadores e canais precisam.

**Perco uma caixa de entrada convosco?** Nunca teve de migrar para uma. As mensagens chegam ao seu próprio sistema ou agente de IA, onde a sua equipa já trabalha.

**A YCloud tem um conector MCP?** A página de preços descreve créditos de IA dentro da plataforma, não um servidor MCP. O nosso disponibiliza dezasseis ferramentas através de OAuth, utilizáveis a partir de qualquer cliente MCP.

---

## EasyCoexistence vs SleekFlow

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-sleekflow

A SleekFlow é uma plataforma de mensagens omnicanal vendida por lugar de utilizador, com um número mínimo de lugares e custos adicionais por número do WhatsApp. A EasyCoexistence cobra por número ligado e não tem o conceito de lugar, por isso a fatura acompanha os números que possui, não o tamanho da equipa.

### Pelo que está realmente a pagar

Os dois modelos de preço respondem a perguntas diferentes, e um deles pergunta pelo organograma.

- SleekFlow:: Uma caixa de entrada partilhada e uma plataforma de campanhas com preço por lugar de utilizador nos vários níveis de plano, o que faz sentido quando o produto é o local onde a equipa passa o dia.
- EasyCoexistence:: Uma ligação. A unidade é um número ligado, não uma pessoa, por isso adicionar um colega não custa nada e a fatura não muda quando a equipa cresce ou diminui.

### Onde a equipa trabalha

A decisão subjacente ao modelo de preço e a mais difícil de inverter.

- SleekFlow:: Dentro da SleekFlow. Esse é o produto: uma caixa de entrada, automatizações e campanhas num só lugar, genuinamente útil para uma equipa que queira trabalhar assim.
- EasyCoexistence:: Onde já trabalha. Os eventos de mensagens vão da Meta diretamente para o CRM, serviço de apoio ao cliente, ferramenta interna ou agente de IA através da substituição do webhook da Meta. Ninguém aprende uma nova caixa de entrada e nada tem de ser migrado.

### Adicionar um segundo ou terceiro número

É comum numa empresa com mais de uma localização, e é aqui que os modelos divergem claramente.

- SleekFlow:: Os números adicionais do WhatsApp são um extra além do plano baseado em lugares, por isso um segundo número é uma segunda decisão sobre a subscrição.
- EasyCoexistence:: O segundo número é simplesmente o segundo número, à tarifa publicada, que diminui à medida que adiciona mais. Vinte números numa conta não exigem alteração do plano nem conversa.

### O que acontece se deixar de pagar

Vale a pena perguntar isto sobre qualquer produto que retenha as suas conversas.

- SleekFlow:: A caixa de entrada, o histórico e as automatizações vivem na plataforma, o que os faz funcionar e também transforma a saída numa migração.
- EasyCoexistence:: Nada seu está dentro de nós para migrar. As mensagens foram entregues ao seu sistema à medida que chegaram e o número está no seu próprio Portefólio empresarial da Meta, por isso remover-nos deixa o número exatamente onde estava.

- Comparar um preço por lugar com um preço por número sem contar ambos. Três lugares e um número representam uma fatura muito diferente de um lugar e três números.
- Pagar por uma caixa de entrada que a equipa não vai abrir. As taxas dos lugares aplicam-se quer sejam utilizados quer não.
- Esquecer o extra por número ao calcular os custos de uma empresa com várias localizações.

**Qual é mais barato?** Somos nós, exceto se quiser especificamente uma caixa de entrada. O preço publicado deles é por lugar, com um número mínimo de lugares e um extra mensal por número do WhatsApp. O nosso é de US$ 9 por número ligado, descendo para US$ 1 à medida que adiciona números, sem lugares.

**Tenho uma caixa de entrada partilhada?** Não, e não paga por uma. As mensagens chegam ao seu próprio sistema, onde a equipa já trabalha.

**E se tiver várias localizações?** Cada número é faturado à tarifa publicada, que diminui à medida que adiciona mais. Não há alteração do plano nem extra para negociar.

**Os meus dados ficam bloqueados?** Connosco, não. As mensagens vão diretamente da Meta para o seu endpoint e o número permanece no seu próprio Portefólio empresarial.

---

## EasyCoexistence vs Bird

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-bird

A Bird cobra o WhatsApp por mensagem entregue, com a taxa própria da Meta incluída na tarifa apresentada. A EasyCoexistence cobra uma tarifa fixa por número ligado e nunca aparece na fatura das mensagens, pelo que o valor cobrado pela Meta permanece visível e separado.

### O que uma tarifa única esconde

Não é desonesto e é declarado abertamente na página deles. Ainda assim, muda aquilo que pode verificar.

- Bird:: Uma tarifa por mensagem entregue, com a parte da Meta já incluída. A página explica que a Bird cobra a sua taxa de envio durante o processamento e regista a parte da Meta a partir do recibo de entrega.
- EasyCoexistence:: Duas faturas separadas que nunca se misturam. A Meta fatura ao cliente as conversas na sua própria WhatsApp Business Account, e nós faturamos a ligação. Pode auditar cada uma contra a sua origem porque nunca foram combinadas.

### O que acontece quando a Meta altera as suas tarifas

A Meta revê periodicamente os preços das conversas, e os dois modelos repercutem essa alteração de forma diferente.

- Bird:: Uma tarifa única tem de ser revista quando a tarifa subjacente muda, o que altera o valor que lhe é apresentado.
- EasyCoexistence:: Nada muda do nosso lado. A alteração da Meta aparece na fatura da Meta do cliente, à tarifa própria da Meta, na data em que a Meta a aplica. A nossa tarifa é pela ligação e não tem relação com o custo de uma mensagem.

### Em torno de que se organiza cada produto

Ambos enviam mensagens do WhatsApp. Não competem pela mesma função.

- Bird:: Uma plataforma de marketing e envolvimento do cliente por email, SMS e WhatsApp, criada para equipas que executam campanhas em grande escala através de vários canais.
- EasyCoexistence:: Infraestrutura de Coexistência para um número que já utiliza a aplicação WhatsApp Business. A aplicação continua a funcionar, a Cloud API funciona em paralelo e os eventos chegam ao seu próprio sistema. Um número, uma função, bem executada.

### A quem pertence a conversa

A questão estrutural subjacente aos dois modelos de preços.

- Bird:: As mensagens são processadas e faturadas ao passarem pela plataforma, o que torna possíveis as ferramentas de campanhas e análise.
- EasyCoexistence:: Os eventos das mensagens vão diretamente da Meta para o seu endpoint através do próprio override da Meta. Não passam por nós e não os armazenamos, razão pela qual não temos nada a cobrar por mensagem.

- Comparar uma tarifa única com a tarifa publicada pela Meta como se fossem o mesmo valor. Uma inclui a outra.
- Assumir que um preço combinado significa ausência de margem. Significa que a margem não é discriminada.
- Escolher uma plataforma de campanhas para uma tarefa que é um número e um webhook.

**A tarifa da Bird é desonesta?** Não. Declara claramente que a taxa da Meta está incluída. O ponto é que uma tarifa combinada não pode ser verificada contra a tarifa publicada pela própria Meta.

**Quem me fatura as mensagens quando trabalho convosco?** A Meta, diretamente, na sua própria WhatsApp Business Account. Nunca aplicamos margem nem revendemos uma cobrança da Meta.

**E se a Meta aumentar as suas tarifas?** A alteração aparece na sua fatura da Meta à tarifa da Meta. A nossa tarifa não é afetada porque não está ligada às mensagens.

**A Bird suporta Coexistence?** A página de preços do WhatsApp deles não aborda esse tema. É precisamente aquilo que fazemos.

---

## EasyCoexistence vs Zenvia

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-zenvia

A Zenvia vende planos mensais de software, pacotes de canais separados e cobra uma taxa de configuração para ativar o WhatsApp. A EasyCoexistence cobra uma tarifa publicada por número ligado, sem plano, pacote ou custo de configuração, o que representa uma ordem de grandeza diferente para uma pequena empresa.

### Como é composta a fatura

A diferença estrutural, e a que determina o total.

- Zenvia:: Um plano mensal de software, mais um pacote de canais dimensionado para o volume esperado, mais uma taxa de configuração quando o canal do WhatsApp é ativado. São três decisões e três linhas, um modelo adequado a uma empresa com uma operação de marketing para gerir.
- EasyCoexistence:: Uma linha. Uma tarifa publicada por número ligado, que diminui à medida que se adicionam números, sem plano acima dela, pacote adicional ou qualquer valor para começar. Os custos das conversas da Meta são cobrados pela Meta ao cliente, separadamente e à tarifa definida pela Meta.

### Para que foi concebido cada produto

São ambos produtos sólidos, mas destinam-se a empresas diferentes.

- Zenvia:: Uma plataforma de experiência do cliente com campanhas multicanal, jornadas e uma grande base empresarial brasileira, vendida a empresas que gerem programas de comunicação estruturados.
- EasyCoexistence:: Uma empresa que já tem um número do WhatsApp Business num telemóvel e quer utilizá-lo na Cloud API sem perder a aplicação. A aplicação continua a funcionar, a API funciona com o mesmo número e as mensagens chegam ao sistema que a empresa já utiliza.

### O que acontece quando o volume cresce

Os dois modelos evoluem em sentidos opostos.

- Zenvia:: Os pacotes de canais são dimensionados pelo volume, por isso o crescimento implica passar para um pacote superior, e o nível do plano pode acompanhar essa mudança.
- EasyCoexistence:: A tarifa por número diminui à medida que se adicionam números, e o volume de mensagens não entra no cálculo. Um número que envia cem mil mensagens custa o mesmo que um número pouco utilizado.

### Tempo até ter um número funcional

Para uma pequena empresa, esta é muitas vezes a decisão principal.

- Zenvia:: Um processo comercial de integração, com uma etapa de ativação do canal do WhatsApp, que inclui apoio útil em implementações maiores.
- EasyCoexistence:: Minutos, através do Embedded Signup da Meta, com três dias gratuitos a partir do primeiro número ligado. A aplicação WhatsApp Business continua a funcionar durante todo o processo e a monitorização começa assim que o número é ligado.

- Comparar apenas o preço do plano. O pacote de canais e a taxa de configuração fazem parte do total.
- Comprar uma plataforma de campanhas para resolver um problema de ligação.
- Assumir que os custos das conversas da Meta estão incluídos. São pagos pelo cliente, na sua própria conta.

**Posso pagar em reais?** Sim. Os preços são publicados em reais e dólares, e a moeda fica fixada à utilizada na primeira subscrição.

**Existe uma taxa de configuração?** Não. São três dias gratuitos, seguidos da tarifa por número. Não há qualquer valor para ativar o WhatsApp num número.

**Perco as ferramentas de campanhas?** Não somos uma plataforma de campanhas nem cobramos como tal. As mensagens chegam ao seu próprio sistema, por isso as campanhas são executadas onde já as gere.

**Quem paga à Meta pelas conversas?** O cliente, diretamente, na sua própria conta do WhatsApp Business. Nunca acrescentamos uma margem a uma cobrança da Meta.

---

## EasyCoexistence vs 8x8

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-8x8

A 8x8 é um fornecedor empresarial de comunicações cuja documentação sobre Coexistence está entre as mais claras disponíveis, razão pela qual é frequentemente citada. A EasyCoexistence foi criada para a empresa que lê essa documentação e quer ligar um número hoje, sem um processo comercial empresarial.

### Onde as duas coincidem

A base técnica é partilhada, e vale a pena dizê-lo antes das diferenças.

- 8x8:: A documentação sobre Coexistence é rigorosa e invulgarmente clara quanto às limitações, incluindo as funcionalidades do WhatsApp que são desativadas quando um número é ligado. É uma referência genuinamente útil.
- EasyCoexistence:: As mesmas limitações, porque são da Meta e não de qualquer fornecedor. Também as documentamos e criámos o produto para conviver com elas: a regra de inatividade de catorze dias, a janela de sincronização e as funcionalidades que desaparecem.

### Da leitura ao número ligado

A lacuna que a documentação não resolve.

- 8x8:: Uma CPaaS empresarial com equipas de conta, produtos de centro de contacto e serviços de operadoras, vendida a organizações com processos de compras. A integração inclui o apoio de que as implementações de grande escala precisam.
- EasyCoexistence:: Registe-se e ligue o número. O Embedded Signup da Meta escolhe o portefólio, a conta e o número, a app do WhatsApp Business continua a funcionar e os primeiros três dias não têm custos. Não há ninguém com quem marcar uma chamada.

### O que sabe antes de aderir

A diferença prática para uma pequena empresa ou agência.

- 8x8:: O preço é definido comercialmente, o que é normal numa CPaaS empresarial e adequado para compradores que negoceiam em conjunto volumes de voz, centro de contacto e mensagens.
- EasyCoexistence:: Toda a tabela de preços está publicada, na sua moeda, com os escalões de volume visíveis. Uma agência com quarenta números pode calcular a fatura antes de criar uma conta.

### Depois de ligar o número

As ligações de Coexistence falham silenciosamente, a parte que a maioria das comparações ignora.

- 8x8:: Apoio empresarial e uma relação com a equipa de conta, o modelo certo quando existe um contrato associado.
- EasyCoexistence:: Monitorização contínua que lê o motivo de desligação indicado pela Meta, distinguindo catorze dias de inatividade de um cliente que saiu, além de um conector MCP com dezasseis ferramentas para que um assistente possa verificar o estado e voltar a ligar sem abrir um painel.

- Confundir documentação clara com o produto. A documentação descreve o mecanismo da Meta, partilhado por todos os fornecedores.
- Iniciar um processo empresarial para ligar um único número.
- Assumir que qualquer fornecedor acompanha a ligação depois de a criar. Pergunte especificamente, seja qual for a sua escolha.

**A documentação da 8x8 é rigorosa?** Sim, e citamo-la. As limitações que descreve são da Meta, pelo que se aplicam a todos os fornecedores de Coexistence, incluindo nós.

**Que funcionalidades deixam de funcionar com Coexistence?** Quatro, segundo a documentação da 8x8 e a nossa: mensagens temporárias, conteúdos de visualização única, localização em tempo real e listas de transmissão. As conversas de grupo estão totalmente fora da API.

**Preciso de um contrato empresarial?** Não connosco. Três dias gratuitos, preço publicado e um número ligado em minutos.

**O que acontece se a ligação cair?** Lemos o motivo de desligação da Meta e enviamos-lhe um alerta. Assim, a regra de inatividade de catorze dias distingue-se de uma saída efetiva.

---

## "Este número de telefone não é elegível" no registo da Coexistence

https://easycoexistence.com/pt-pt/docs/coexistence-error-number-not-eligible

O popup de registo da Meta indica que um número não é elegível quando a conta da app WhatsApp Business associada não passa as verificações da Meta para ligar à plataforma. O motivo documentado pela Meta é atividade insuficiente na app. A solução é usar a app de forma real e contínua nesse número e depois executar novamente o fluxo.

### O que diz exatamente a mensagem?

O popup mostra a mensagem no idioma em que é apresentado. Em inglês, lê-se "This phone number isn't eligible for registration or migration". Em espanhol, surge como "Este número de teléfono no cumple los requisitos para el registro ni la migración". A referência de erros do Embedded Signup da Meta indica a versão documentada mais próxima sob o código 3441045: "Your phone number isn't eligible to connect to the WhatsApp Business Platform".

Seja qual for o idioma, o significado é o mesmo. O fluxo chegou ao passo do número de telefone, a Meta analisou a conta da app WhatsApp Business registada nesse número e recusou ligá-lo à API. Nada foi alterado no telemóvel, e a app continua a funcionar exatamente como antes.

### Porque é que a Meta recusa um número aparentemente elegível?

A resolução da própria Meta para o 3441045 é curta: é necessária mais atividade na app WhatsApp Business para ajudar a determinar a elegibilidade. A Meta não publica um limiar, um número de dias nem uma contagem de mensagens, pelo que qualquer valor que se encontre noutro lado é uma observação de um fornecedor e não uma regra da Meta.

Lido de forma simples, isto aponta para contas com pouco uso genuíno: um número registado recentemente, ou que mal teve conversas reais.

Há outras duas recusas semelhantes que não são a mesma coisa. O código 3441042 significa que a funcionalidade não está disponível para números dessa região. E, do lado da API, o 2388091 e o 2388093 indicam que um número não é elegível para receber ou verificar um código de registo porque não está a ser migrado, o que pertence ao caminho da migração e não à Coexistence.

### O que fazer antes de voltar a tentar?

Use o número normalmente na app WhatsApp Business: conversas reais com clientes, enviadas e recebidas, durante um período significativo. Evite apagar a conta ou registar novamente o número enquanto espera, uma vez que a verificação da Meta incide sobre a atividade dessa conta e recomeçar deixa-lhe menos para analisar.

Verifique ao mesmo tempo o essencial. A app tem de ser a WhatsApp Business e não o WhatsApp de consumo, na versão 2.24.17 ou mais recente, e o número não pode estar ligado a outro fornecedor de API. Estas situações geram mensagens próprias, tratadas em páginas separadas.

Depois, execute o fluxo novamente desde o início. A Meta avalia a elegibilidade em cada tentativa, pelo que uma nova tentativa após atividade genuína é o único teste que conta.

- Repetir o fluxo várias vezes seguidas. A elegibilidade é avaliada pela Meta e as tentativas repetidas podem esbarrar antes em limites de pedidos.
- Registar o número de novo numa instalação limpa para recomeçar do zero. A verificação da Meta incide sobre a atividade, e um registo novo não tem nenhuma.
- Partir do princípio de que o fornecedor pode autorizar o número à força. Nenhum fornecedor pode anular a decisão de elegibilidade da Meta.

**O meu número foi banido?** Não. Esta mensagem diz respeito à ligação do número à API. A app WhatsApp Business continua a funcionar no telemóvel exatamente como antes.

**Quanto tempo deve esperar antes de voltar a tentar?** A Meta não publica um período fixo. A solução documentada é mais atividade real na app WhatsApp Business, por isso aguarde até o número estar em uso genuíno.

**Porque é que a mensagem menciona a migração?** O mesmo popup trata também da mudança de números entre contas. A recusa abrange os dois caminhos, por isso o texto refere ambos.

**Outro fornecedor obterá uma resposta diferente?** Não. Todos os fornecedores usam o mesmo Embedded Signup da Meta, e a verificação de elegibilidade é da Meta.

---

## "Este número de telefone já está registado numa conta do WhatsApp"

https://easycoexistence.com/pt-pt/docs/coexistence-error-number-already-registered

A janela de registo da Meta mostra esta mensagem quando o número já está registado num local que bloqueia o passo em curso: o WhatsApp de consumidor, uma conta da WhatsApp Business API ou uma conta noutra plataforma. Primeiro, é preciso desligar o número dessa conta. Depois de o desligar, a Meta indica que pode demorar alguns minutos até o número voltar a estar disponível.

### O que diz a documentação da Meta sobre esta mensagem?

A referência de erros do Embedded Signup da Meta indica a mensagem como "This number is registered to an existing WhatsApp account. To use this number, disconnect it from the existing account. Then, return to this page and re-enter the number." Acrescenta que o número pode demorar até 3 minutos a ficar disponível.

A explicação da Meta é que o número de telefone já está registado na sua plataforma, referindo o WhatsApp Messenger, a app WhatsApp Business e a WhatsApp Business API, e a solução sugerida é anular o registo do número ou usar outro. A janela é apresentada no idioma do utilizador, pelo que a mesma recusa chega em italiano, espanhol ou português com o mesmo significado.

### Porque é que um registo com Coexistence chega a este erro?

A Coexistência existe para ligar um número que já está registado na app WhatsApp Business, pelo que estar registado não é, por si só, o problema. A mensagem surge quando o fluxo não segue o caminho da Coexistência, ou quando o registo é de tipo errado.

Há três situações que a provocam. O número está no WhatsApp de consumidor e não na app WhatsApp Business, o que a Coexistence não consegue ligar. O fluxo executado é um registo normal de número novo e não a opção de ligar uma conta existente da app WhatsApp Business, pelo que a Meta trata o número como um a registar de raiz. Ou o número está registado diretamente na WhatsApp Business API, fora da app.

Cada uma exige uma correção diferente, e é por isso que a mensagem, por si só, não basta para agir.

### Como se liberta o número e se volta a tentar?

Ajuste a correção ao local onde o número se encontra.

Se estiver no WhatsApp de consumidor, passe-o primeiro para a app WhatsApp Business no telemóvel. Se estiver na app WhatsApp Business e a janela continuar a indicar este erro, confirme que o fluxo ofereceu a opção de ligar uma conta existente da app WhatsApp Business; sem esse ecrã, o fluxo é o errado. Se estiver registado na API através de outra plataforma, tem de ser desligado nessa plataforma.

Depois de desligar, aguarde alguns minutos, como a Meta refere, volte à janela e introduza o número novamente. Se a janela tiver sido fechada, recomece o fluxo desde o início em vez de reutilizar uma janela antiga.

- Voltar a tentar o mesmo número logo a seguir a desligá-lo. A Meta indica que a disponibilidade pode demorar até três minutos.
- Executar um registo normal de número novo para um número de app. A Coexistence precisa do fluxo que oferece a ligação da conta existente da app WhatsApp Business.
- Eliminar a conta da app WhatsApp Business para limpar o erro. Isso remove precisamente o registo que a Coexistence liga.

**De que conta existente está a Meta a falar?** A janela não o diz. É onde o número está registado neste momento: o WhatsApp de consumidor, a app WhatsApp Business no caminho errado, ou a API através de outra plataforma.

**Perco as minhas conversas se desligar?** Desligar de uma plataforma faz-se na app WhatsApp Business, em Definições, Conta, Plataforma empresarial. É uma ação distinta de eliminar a conta da app, que não é a solução.

**Vi isto em italiano. É o mesmo erro?** Sim. A janela está localizada, pelo que a mesma recusa aparece no idioma que a sessão utilizar.

**Um fornecedor tem de fazer alguma coisa?** Só se o número estiver ligado através desse fornecedor. Nesse caso, a desligação faz-se aí antes de o novo fluxo poder ser concluído.

---

## “Falha ao pedir o código: os nossos servidores estão temporariamente indisponíveis”

https://easycoexistence.com/pt-pt/docs/coexistence-error-request-code-unavailable

“Falha ao pedir o código: os nossos servidores estão temporariamente indisponíveis. Aguarde 1 hora antes de tentar novamente” aparece quando, durante o registo, se pede um código de verificação para um número e a Meta não o envia. A instrução da mensagem é a solução: deixar de pedir códigos, esperar a hora completa e voltar a tentar uma só vez, a partir de um fluxo novo.

### Trata-se de uma falha da Meta?

Pode ser, mas as mensagens vizinhas documentadas apontam para outra causa. A referência de erros do Embedded Signup da Meta não lista esta formulação exata. Lista, no entanto, uma família de recusas de códigos de verificação que se comportam da mesma forma: “You have requested your code too many times”, os códigos 2494158 e 2388367 para pedidos repetidos e 2593037 para um erro ao pedir o código. Em todos os casos, a pessoa é convidada a voltar mais tarde.

Existe também a possibilidade de um problema real na plataforma. Do lado da API, 133004 significa que um servidor está temporariamente indisponível, e o conselho da Meta é consultar a página de estado da WhatsApp Business Platform antes de voltar a tentar. Se a página de estado não mostrar nenhum incidente, trate a mensagem como um limite de pedidos de código para esse número e respeite a hora indicada.

### Porque é pedido um código para um número em Coexistence?

No caminho Coexistence, o número já está registado na app WhatsApp Business, e é por isso que a Meta diz aos parceiros para saltarem o passo de registo do número de telefone. O fluxo documentado pela Meta verifica a titularidade através da própria app: a empresa recebe uma mensagem da conta oficial Facebook Business na app WhatsApp Business, toca em Ligar e conclui aí o passo de verificação.

Assim, um pedido de código que continua a falhar é um indício para verificar em que caminho está o popup. Se o ecrã que propõe ligar uma conta existente da app WhatsApp Business nunca apareceu, o fluxo está a tratar o número como um novo registo e a pedir um código por SMS ou chamada de voz, que é onde estes limites se aplicam.

### Como voltar a tentar sem agravar a situação?

Espere a hora completa que a mensagem indica, sem pedir outro código entretanto. A Meta afirma que o sistema limita o número de vezes que um código pode ser pedido num determinado intervalo de tempo, pelo que os pedidos feitos durante a espera acabam por prejudicar.

Passada a hora, feche o popup antigo e inicie o fluxo de novo, em vez de carregar em reenviar numa janela que ficou aberta. Escolha a opção de ligar a conta existente da app WhatsApp Business, mantenha o telemóvel com o número desbloqueado e por perto, e conclua a verificação na app assim que ela chegar.

Se um código errado foi introduzido várias vezes, a orientação da Meta é diferente: o sistema permite um número limitado de tentativas de verificação e indica que se deve esperar cerca de 12 horas antes de voltar a tentar.

- Carregar repetidamente em reenviar durante a hora. A Meta limita a frequência com que um código pode ser pedido num período.
- Assumir que a indisponibilidade é permanente e mudar de número. A mensagem refere uma espera temporária.
- Executar um registo de número novo para um número da app. A Coexistence verifica através da app WhatsApp Business, não através de um novo registo por SMS.

**Esperar mais de uma hora ajuda?** Uma hora é o que a mensagem indica. Esperar mais tempo não prejudica, mas pedir códigos durante essa hora prejudica.

**O meu fornecedor pode repor o limite?** Não. Os limites dos códigos de verificação são aplicados pela Meta ao número, e nenhum fornecedor os pode anular.

**A app WhatsApp Business é afetada?** Não. A app continua a funcionar no telemóvel. A recusa diz respeito apenas ao passo de registo no navegador.

**Como sei se é uma falha real?** Consulte a página de estado da WhatsApp Business Platform da Meta. Se não mostrar nenhum incidente, trate a mensagem como um limite de pedidos de código.

---

## A leitura do código QR da Coexistência falha na app WhatsApp Business

https://easycoexistence.com/pt-pt/docs/coexistence-error-qr-code-pairing-failed

Quando a leitura do código falha durante o registo da Coexistência, as causas a verificar estão no telemóvel: uma app WhatsApp Business desatualizada, a leitura feita a partir da app ou do dispositivo errados, ou o pedido que se segue à leitura deixado sem resposta. A solução é atualizar a app, ler o código na app WhatsApp Business do telemóvel que tem o número e concluir todos os passos pedidos.

### O que deve acontecer no telemóvel?

A documentação da Meta descreve o lado do telemóvel em quatro passos. A empresa recebe, dentro da app WhatsApp Business, uma mensagem da conta oficial do Facebook Business e toca em Ligar. Toca em Ligar à Business Platform. Toca em Confirmar, que é onde escolhe se partilha o histórico de conversas. Depois conclui o passo do código de verificação e regressa ao navegador para terminar o fluxo.

O código apresentado no navegador é o que inicia essa conversa na app. Por isso, uma leitura que não faz nada, ou um telemóvel que mostra um erro assim que lê o código, significa que um desses passos não conseguiu começar. Tudo o que vem antes, no navegador, já funcionou.

### Porque falha a leitura?

Vale a pena verificar quatro causas, por esta ordem.

A app é demasiado antiga. A Meta exige a versão 2.24.17 da app WhatsApp Business ou superior e tem um erro do Embedded Signup, o 4563015, que indica simplesmente que se atualize a app para a versão mais recente.

A leitura foi feita na app errada. O código tem de ser tratado pela app WhatsApp Business que tem o número, no telemóvel principal. O WhatsApp de consumo, a app da câmara do telemóvel ou um dispositivo associado, como o WhatsApp Web ou Desktop, não são a mesma coisa.

Os pedidos não foram concluídos. A leitura apenas abre o passo; tocar em Ligar, Ligar à Business Platform e Confirmar é o que o faz avançar.

A janela foi fechada. Se a janela do navegador desaparece, o fluxo que o telemóvel estava a concluir desaparece com ela.

### Como se volta a tentar sem erros?

Atualize primeiro a app WhatsApp Business na loja de aplicações e abra-a de novo. Confirme que o telemóvel que tem na mão é o que tem o número e que está desbloqueado e com ligação à internet.

Depois, inicie o fluxo de registo novamente desde o princípio no navegador, escolha a opção de ligar a conta existente da app WhatsApp Business e mantenha a janela aberta enquanto trabalha no telemóvel. Trate o código a partir de dentro da app WhatsApp Business, responda a cada pedido à medida que aparece e regresse ao navegador para terminar.

Depois de a ligação ficar concluída, é normal que os dispositivos associados terminem a sessão. A Meta desassocia todas as apps complementares quando o número é ligado à API, e podem ser associadas de novo mais tarde.

- Ler o código com a app da câmara do telemóvel. O código tem de ser tratado pela app WhatsApp Business que tem o número.
- Fechar a janela do navegador enquanto se trabalha no telemóvel. O passo do telemóvel precisa do fluxo que o iniciou.
- Tratar como falha o facto de os dispositivos associados terminarem a sessão. A Meta desassocia as apps complementares na ligação; podem ser associadas de novo.

**Pode outra pessoa fazer a leitura pela empresa?** Só com o telemóvel que tem o número. O passo realiza-se na app WhatsApp Business desse dispositivo.

**Posso usar o WhatsApp Web para ler o código?** Não. Os dispositivos associados são complementares da conta. O passo do telemóvel pertence à app WhatsApp Business do telemóvel principal.

**Uma leitura falhada altera alguma coisa no telemóvel?** Não. Até o fluxo ser concluído, o número não fica ligado e a app funciona como antes.

**A minha app indica que está atualizada. O que fazer a seguir?** Verifique se o número da versão é 2.24.17 ou superior, reinicie o fluxo desde o princípio e conclua todos os pedidos.

---

## Registo na Coexistence bloqueado por um portefólio empresarial antigo

https://easycoexistence.com/pt-pt/docs/coexistence-error-inaccessible-business-portfolio

Se o número estiver ligado a um portefólio empresarial da Meta diferente do selecionado na janela de registo, a Meta recusa-o e indica que o número não está associado à empresa selecionada. É preciso desligar o número dentro desse outro portefólio, o que exige alguém com acesso de administrador, ou executar o fluxo nesse mesmo portefólio.

### O que diz a Meta quando isto acontece?

A referência de erros do Embedded Signup da Meta inclui o código 3441041: "The phone number you have entered is not associated with the business you selected. To continue, you need to unlink this phone number from that business or enter a different number."

A empresa selecionada é o portefólio empresarial escolhido no primeiro ecrã da janela. A mensagem significa que a Meta já associa o número a um portefólio diferente. Essa ligação pode vir de uma configuração anterior: uma agência que em tempos ligou o número, o Business Manager de um antigo colaborador ou uma conta de WhatsApp antiga criada para anúncios. Quem executa o fluxo hoje muitas vezes desconhece que existe.

### Como se desliga o número do outro portefólio?

A resolução documentada pela Meta tem duas partes, ambas realizadas dentro do portefólio que detém atualmente o número.

Primeiro, remova a conta do WhatsApp associada a esse número: Meta Business Suite, Definições, Contas, Contas do WhatsApp, Remover conta. Depois, elimine o próprio número de telefone no WhatsApp Manager, no separador Números de telefone.

Ambos os passos decorrem dentro desse portefólio, por isso é necessário alguém com acesso de administrador. A Meta já exige permissões de administrador apenas para criar contas do WhatsApp Business num portefólio. Quando o número estiver livre, execute o registo outra vez e selecione o portefólio que controla.

### E se ninguém conseguir aceder ao portefólio antigo?

Nesse caso, as opções realistas reduzem-se a duas.

Primeiro, recuperar o acesso. Quem criou o portefólio, ou qualquer administrador que ainda lá esteja, pode adicionar uma pessoa atual como administradora. Se o portefólio pertencer a uma agência, deve pedir-se à agência que conceda acesso ou que faça ela própria o desligamento.

Outra possibilidade é executar o fluxo dentro desse portefólio antigo, depois de o acesso ser restabelecido, em vez de tirar o número de lá. A Coexistence mantém as contas convertidas no portefólio do próprio cliente, pelo que o portefólio em que o fluxo é executado será aquele onde o número ficará depois. Escolha o que a empresa ainda controlará daqui a um ano.

- Criar um portefólio novo e voltar a tentar. O número continua ligado ao antigo, por isso a mesma recusa regressa.
- Eliminar a conta da app do WhatsApp Business para quebrar a ligação. A ligação existe do lado da Meta, dentro do outro portefólio.
- Deixar o número num portefólio que a empresa não controla. Quem o administra controla a ligação.

**O apoio da Meta pode mover o número por mim?** A correção documentada pela Meta para o 3441041 é desligar o número dentro do outro portefólio, por alguém com acesso a ele. A Meta não descreve a transferência do número em nome do cliente.

**Como descubro que portefólio tem o número?** A mensagem da Meta não o indica. Verifique todos os portefólios que alguém da empresa tenha utilizado, incluindo os que uma agência tenha criado.

**Desligar o número vai parar a app do WhatsApp Business?** Os passos removem a conta do WhatsApp e o número desse portefólio, no Meta Business Suite e no WhatsApp Manager. Não é na app do telemóvel que decorrem.

**Isto é o mesmo que o número estar noutro fornecedor?** Não. Isso é uma ligação à aplicação de outro parceiro. Aqui, o número pertence a um portefólio diferente.

---

## Opção «Ligar a sua app WhatsApp Business existente» não aparece

https://easycoexistence.com/pt-pt/docs/coexistence-error-option-not-showing

A opção de ligar uma conta existente da app WhatsApp Business só aparece quando a plataforma que inicia o Embedded Signup da Meta a ativou no seu código. Sem essa definição, a janela mostra o ecrã normal de seleção de conta e trata o número como um novo registo. A empresa não a pode ativar; tem de ser a plataforma.

### Quem controla se a opção aparece?

A plataforma que abre a janela. A documentação da Meta indica aos parceiros que acrescentem a propriedade featureType com o valor whatsapp_business_app_onboarding ao iniciar o Embedded Signup. A Meta dá também a forma de verificar: se o ecrã de seleção de conta tiver sido substituído por outro que propõe ligar uma conta WhatsApp Business existente, a funcionalidade está ativada.

Assim, quando a empresa vê os ecrãs habituais, em que se escolhe ou cria uma conta WhatsApp Business e se introduz um número para registar, a janela foi aberta sem essa definição. Nada nas definições da Meta da própria empresa altera isso. A empresa só pode mudar para uma ligação de registo de uma plataforma que a tenha ativada.

### Porque é que uma plataforma pode não a oferecer?

A Meta enumera requisitos do lado da plataforma antes de a opção poder ser ativada. A plataforma já tem de ser Solution Partner ou Tech Provider, tem de saber usar a Cloud API, tem de ter um callback de webhook capaz de receber e processar webhooks, e tem de executar o Embedded Signup com registo de sessões.

Uma ferramenta alojada pelo próprio cliente, ou uma integração criada numa app de programador que não é Tech Provider, não cumpre o primeiro destes requisitos, e nesse caso a opção não é algo que uma alteração de configuração do lado da empresa consiga recuperar. A solução é uma plataforma que tenha feito este trabalho.

A outra lacuna são as versões. As versões v2 e v3 do Embedded Signup ficam obsoletas a 15 de outubro de 2026, e a Meta pede aos parceiros que passem para a v4 antes dessa data.

### E se a opção aparece mas não é possível escolher a conta?

Trata-se de uma recusa diferente, e vem da conta, não da plataforma.

A referência de erros da Meta inclui o 3441047: a funcionalidade não está disponível para contas que usam mensagens de marketing, e a empresa tem de selecionar outra conta WhatsApp Business. O código 3441042 significa que a funcionalidade não está disponível para números dessa região. E uma app anterior à versão 2.24.17 é recusada, com um pedido para atualizar para a versão mais recente.

Cada um destes casos traz a sua própria mensagem na janela. Uma opção em falta, sem qualquer mensagem, remete para a forma como o fluxo foi iniciado.

- Procurar nas definições da Meta da empresa um interruptor da Coexistence. A opção é definida por quem inicia a janela.
- Concluir na mesma o fluxo normal. Sem a opção, a Meta trata o número como um novo registo, o que não é Coexistence.
- Presumir que uma integração mais antiga do Embedded Signup continua a cumprir os requisitos. A Meta torna a v2 e a v3 obsoletas a 15 de outubro de 2026.

**A empresa pode ativar a Coexistence por si?** Não na janela. A opção é definida pela plataforma que inicia o Embedded Signup, através da definição featureType.

**Como sei que a opção está ativada?** O teste da própria Meta: o ecrã de seleção de conta é substituído por outro que propõe ligar a sua conta WhatsApp Business existente.

**A empresa precisa de um portefólio empresarial verificado?** Os requisitos que a Meta enumera para esta opção estão do lado da plataforma que inicia o fluxo, além da versão 2.24.17 ou superior da app para a empresa.

**É uma restrição regional?** Uma recusa regional chega com mensagem própria, o código 3441042. Uma opção em falta, sem qualquer mensagem, remete para a forma como o fluxo foi iniciado.

---

## "Atualize a app WhatsApp Business" durante o registo da Coexistence

https://easycoexistence.com/pt-pt/docs/coexistence-error-business-app-outdated

A Coexistence exige a app WhatsApp Business na versão 2.24.17 ou superior no telemóvel que tem o número. Abaixo dessa versão, a janela de registo da Meta recusa o número e pede que a app seja atualizada para a versão mais recente. Atualiza-se na loja de aplicações e volta-se a executar o fluxo desde o início.

### O que diz a mensagem?

A referência de erros do Embedded Signup da Meta lista o código 4563015 com o texto "Update your WhatsApp Business App to the latest version to use this phone number", e a resolução é exatamente essa: atualizar a app para a versão mais recente.

O requisito que está na origem consta da documentação de integração da Coexistence da Meta: o cliente empresarial tem de usar a app WhatsApp Business na versão 2.24.17 ou superior. A mensagem pede a versão mais recente e não a mínima, e atualizar para a última versão disponível cumpre ambas.

### Que dispositivo tem de ser atualizado?

O telemóvel principal: o dispositivo onde o número está registado na app WhatsApp Business. É essa a app que a Meta verifica e é ela que trata do passo do telemóvel no fluxo.

Atualizar o WhatsApp Web, a app de computador ou um tablet associado à conta não conta, porque são dispositivos associados e não o registo em si. A documentação da Meta indica ainda que os clientes associados são desassociados quando o número se liga à API, e que o WhatsApp para Windows e o WhatsApp para WearOS deixam de ser suportados como clientes associados.

Numa configuração de agência, quem executa o fluxo no navegador muitas vezes não tem o telemóvel, pelo que este é o passo a confirmar com o titular da empresa antes de começar.

### Como se verifica a versão e se volta a tentar?

No telemóvel que tem o número, procure a versão instalada da app WhatsApp Business, na informação de ajuda da própria app ou na respetiva página da loja de aplicações do telemóvel. Se for inferior a 2.24.17, ou se a loja propuser uma atualização, instale-a.

Depois de atualizar, feche e volte a abrir a app para que a nova versão seja a que está em execução. Em seguida, inicie o fluxo de registo de novo desde o princípio, no navegador, em vez de retomar uma janela que já mostrou a recusa, e escolha a opção de ligar a conta existente da app WhatsApp Business.

A atualização faz-se na loja de aplicações e não na janela de registo, pelo que este passo cabe a quem tem o telemóvel. Confirme com essa pessoa o número da nova versão antes de executar o fluxo outra vez, em vez de presumir que a atualização foi concluída.

- Atualizar o WhatsApp Web ou a app de computador. A Meta verifica a app WhatsApp Business no telemóvel principal.
- Atualizar o WhatsApp normal num telemóvel que tem as duas apps. A app Business é uma instalação separada, com a sua própria versão.
- Voltar a tentar na mesma janela depois de atualizar. Inicie o fluxo de novo para que a verificação seja feita com a nova versão.

**A versão 2.24.17 chega, ou preciso da mais recente?** O mínimo indicado pela Meta é 2.24.17. O texto do erro pede a versão mais recente, pelo que atualizar por completo cobre ambos os casos.

**Atualizar faz perder conversas?** Uma atualização substitui a versão da app sobre o mesmo registo. Não equivale a apagar a conta nem a registar o número de novo, o que deve ser evitado.

**A versão importa depois de ligar?** O requisito da Meta é indicado para a integração. Manter a app atualizada continua a ser sensato, porque o telemóvel permanece parte da ligação.

**Isto é o mesmo que o número não ser elegível?** Não. A elegibilidade diz respeito à atividade da conta. Este caso é apenas a versão da app no telemóvel.

---

## Erro de Coexistence: número já ligado a outro fornecedor

https://easycoexistence.com/pt-pt/docs/coexistence-error-number-on-another-provider

O fluxo de Coexistence da Meta não liga um número da app WhatsApp Business a uma nova plataforma enquanto outra ainda o tiver. Se o número já está ligado a outro fornecedor, a janela de registo da Meta recusa-o e indica que a troca de parceiro não é suportada nesse fluxo. A empresa desliga a plataforma atual na app WhatsApp Business, espera 15 minutos e só depois faz o novo registo.

### Que mensagens indicam que o número está noutro fornecedor?

A referência de erros do Embedded Signup da Meta tem três para esta situação, na secção sobre a integração de utilizadores da app WhatsApp Business.

- 2655093: a empresa já está a partilhar esta conta WhatsApp Business com um parceiro, e a troca de parceiro não é suportada neste fluxo.
- 3441049: o número já está registado no produto e tem de ser desligado da conta atual na app WhatsApp Business.
- 2655094: desligue a sua plataforma empresarial para continuar e espere 15 minutos antes de tentar de novo.

### Como se desliga o fornecedor atual?

A partir do telemóvel, na app WhatsApp Business. O caminho indicado pela Meta é Definições, Conta, Plataforma empresarial, depois seleciona-se a plataforma ligada e toca-se em Desligar. A Meta refere também que a chamada de anulação de registo da API não pode ser usada num número que esteja em utilização com a app e a Cloud API em simultâneo, e por isso a desligação faz-se na app e não através do painel do fornecedor antigo.

Quando a empresa desliga, a Meta envia à plataforma anterior um webhook account_update com um evento PARTNER_REMOVED. É assim que o fornecedor antigo toma conhecimento. Qualquer subscrição junto desse fornecedor é um assunto à parte entre a empresa e ele.

### O que acontece depois de desligar?

Espere. As mensagens dos códigos 3441049 e 2655094 indicam ambas que se deve esperar 15 minutos antes de tentar de novo.

Depois, faça o registo da nova plataforma desde o início e escolha a opção de ligar a conta existente da app WhatsApp Business. É uma integração nova: a partilha do histórico de conversas volta a ser oferecida, e a nova plataforma tem 24 horas após a integração para sincronizar contactos e histórico.

Há um caso que ainda pode interromper a troca. A Meta refere que uma empresa que trabalhou com um parceiro no passado e continua a partilhar a linha de crédito desse parceiro pode ver um erro ao mudar para um novo parceiro, e publica um guia à parte para o resolver.

- Pedir ao fornecedor antigo que anule o registo do número. A Meta indica que a chamada de anulação não funciona num número usado com a app e a Cloud API.
- Tentar de novo poucos minutos depois de desligar. A Meta pede 15 minutos.
- Eliminar a conta da app WhatsApp Business para quebrar a ligação antiga. Desligar em Definições é o caminho documentado.

**Um número pode estar ligado a dois fornecedores em simultâneo?** Não através deste fluxo. A mensagem da Meta indica que a troca de parceiro não é suportada sem desligar primeiro o atual.

**Desligar vai apagar as minhas conversas?** Desligar remove a ligação à plataforma. A app WhatsApp Business continua no telemóvel e a funcionar.

**O novo fornecedor pode desligar o antigo por mim?** Não. A desligação é feita pela empresa, na app WhatsApp Business.

**O histórico volta a sincronizar com o novo fornecedor?** A nova integração volta a oferecer a partilha do histórico, e a nova plataforma tem 24 horas para fazer a sincronização.

---

## "This authorization code has expired" após o registo na Coexistence

https://easycoexistence.com/pt-pt/docs/coexistence-error-authorization-code-expired

Quando o Embedded Signup da Meta termina, entrega à plataforma que o iniciou um código de curta duração, que tem de ser trocado por um token de acesso em 30 segundos. Se a troca ocorrer mais tarde, ou usar um código de uma tentativa anterior, a Meta responde que o código de autorização expirou. Executar o fluxo de novo gera um código novo.

### Que código expirou?

Quando a empresa conclui o Embedded Signup, a Meta devolve os IDs dos ativos e um código de token trocável à janela do navegador que abriu o pop-up. A plataforma envia depois esse código para o seu próprio servidor, que chama o endpoint oauth access_token da Meta com o ID da app e o segredo da app para o trocar por um token empresarial.

O guia de implementação da Meta é explícito quanto ao tempo: o código de token trocável tem um tempo de vida de 30 segundos, pelo que a plataforma tem de conseguir trocá-lo antes de expirar. Uma troca tentada depois desse momento é recusada, e "This authorization code has expired" é a forma como essa recusa aparece. A empresa não fez nada de errado por terminar o pop-up devagar; o relógio começa a contar quando o código é devolvido.

### Porque é que acontece quando o pop-up termina tarde ou duas vezes?

Várias situações podem atrasar a troca para além desse limite.

O separador do navegador ficou em segundo plano ou o portátil entrou em suspensão quando o fluxo terminou, e por isso o código chegou ao servidor da plataforma muito depois de ter sido emitido. O servidor da plataforma colocou a troca em fila, atrás de outro trabalho, em vez de a fazer de imediato. Ou a pessoa abriu o fluxo duas vezes, concluiu ambos, e a plataforma trocou o código da primeira janela depois de a segunda terminar.

Em testes existe uma quarta: copiar o código da consola do navegador e trocá-lo à mão com cURL ou Postman. O guia da Meta avisa precisamente contra isto e recomenda ter o pedido de troca preparado antes de começar.

### Como se conclui a ligação?

Execute o fluxo de novo desde o início, numa única janela, e deixe-o terminar com a página da plataforma em primeiro plano. Cada conclusão devolve um código novo, e uma troca rápida desse código é tudo o que a plataforma precisa.

No caso de um número Coexistence, convém fazê-lo sem demora. A Meta converte a conta WhatsApp Business quando a empresa conclui o fluxo, e, depois de a plataforma integrar o cliente, tem 24 horas para sincronizar o histórico de mensagens; passado esse prazo, a empresa tem de ser desligada e concluir o fluxo outra vez.

Do lado da plataforma, a correção duradoura é trocar o código no servidor no instante em que chega, antes de qualquer outro passo de integração.

- Voltar a tentar a troca do token com o mesmo código. Expirou ao fim de 30 segundos e não regressa.
- Executar o registo em duas janelas ao mesmo tempo. Só conta o código da tentativa que está a ser trocada.
- Trocar o código a partir do navegador. A Meta exige a troca como pedido entre servidores, com o segredo da app.

**A empresa ligou o número ou não?** A empresa concluiu o fluxo da Meta, mas a plataforma não conseguiu transformar o código num token funcional, pelo que ainda não pode atuar sobre o número. Executar o fluxo de novo dá-lhe um código novo.

**É possível fazer o código durar mais tempo?** Não. A Meta define o tempo de vida de 30 segundos e nenhuma plataforma o pode prolongar.

**A app WhatsApp Business é afetada?** Não. A app continua a funcionar no telemóvel enquanto o problema é resolvido.

**Isto é o mesmo que um token de acesso expirado?** Não. Este é o código de registo de curta duração. Um token de acesso expirado numa ligação em funcionamento devolve o erro 190.

---

## "Your app is missing required Graph API permissions for Cloud API companion pairing"

https://easycoexistence.com/pt-pt/docs/coexistence-error-companion-pairing-permission

Esta mensagem significa que a plataforma que iniciou o registo não tem as permissões do WhatsApp que a Meta exige, ao nível de acesso que a Meta exige, para ligar à Cloud API o número de uma app WhatsApp Business. A Meta só permite que uma empresa conceda permissões para as quais a plataforma tenha acesso Advanced. A empresa não o consegue corrigir; tem de ser a plataforma.

### O que significa a mensagem?

O texto completo é: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." As referências públicas de erros da Meta não listam esta formulação exata, mas cada parte dela corresponde a algo que a Meta documenta.

"Your app" é a app Meta da plataforma que executa o registo, não a app WhatsApp Business que está no telemóvel. A Meta não define publicamente companion pairing; lido em contexto, descreve a Cloud API a juntar-se a um número que continua registado na app WhatsApp Business, que é o modelo da Coexistence. E as permissões "advanced" do WhatsApp Business referem-se ao acesso Advanced, o nível que a Meta concede através da App Review.

### Que permissões estão envolvidas?

A documentação de permissões da Meta indica duas que as integrações com o WhatsApp geralmente exigem. A whatsapp_business_management abrange metadados da conta, templates, números de telefone, análises e webhooks da conta. A whatsapp_business_messaging abrange o envio de mensagens e a receção de webhooks de mensagens e de estado.

Para um parceiro cujos clientes usam a sua app, a Meta exige App Review e acesso Advanced para cada permissão de que a app precisa. A Meta indica a consequência de forma direta: sem acesso Advanced para uma permissão, os clientes não a podem conceder à app através do Embedded Signup. As chamadas feitas com whatsapp_business_management em contas que a app não possui, sem acesso Advanced, devolvem o erro 200.

Uma plataforma pode verificar o que a empresa concedeu realmente, inspecionando o token com o endpoint debug_token da Meta, que lista as permissões concedidas em scopes.

### O que pode a empresa fazer?

Muito pouco do seu lado, e não deve tentar alterar as definições da Meta para resolver isto. A solução está na plataforma: tem de ser Tech Provider ou Solution Partner, o que a Meta indica como requisito para integrar utilizadores da app WhatsApp Business, e tem de ter o acesso Advanced aprovado para as permissões do WhatsApp.

O que a empresa pode fazer é comunicar a mensagem exata à plataforma, voltar a tentar quando a plataforma confirmar o seu acesso, ou usar uma plataforma que já tenha esse estatuto. Repetir o mesmo fluxo na mesma plataforma antes disso produz o mesmo resultado e não afeta a app WhatsApp Business no telemóvel.

- Conceder mais permissões nas definições Meta da própria empresa. O acesso em falta pertence à app da plataforma.
- Alojar uma ferramenta própria numa app de programador sem App Review. Sem acesso Advanced, as empresas não podem conceder as permissões necessárias.
- Voltar a tentar repetidamente na mesma plataforma. O resultado só muda quando o acesso dessa plataforma mudar.

**Há algum problema com a minha app WhatsApp Business?** Não. A mensagem refere-se à app Meta da plataforma, não à app que tem no telemóvel, que continua a funcionar.

**Posso conceder a permissão eu próprio?** Só aparecem para conceder as permissões para as quais a plataforma tem acesso Advanced. O acesso em falta tem de ser primeiro aprovado para a plataforma.

**Como obtém uma plataforma o acesso Advanced?** Através da Meta App Review, para cada permissão de que a sua app precisa, enquanto parceiro cujos clientes usam a app.

**A empresa precisa de App Review?** Não. A Meta indica que um programador direto que acede apenas aos dados da sua própria empresa não precisa de App Review nem de acesso Advanced.

---

## Erro 0 do WhatsApp: não foi possível autenticar o utilizador da app

https://easycoexistence.com/pt-pt/docs/whatsapp-error-0

O código de erro 0 indica que a Meta não conseguiu autenticar o utilizador da app associado ao token de acesso. A descrição da Meta diz: "We were unable to authenticate the app user." O token expirou, foi invalidado, ou o utilizador bloqueou o acesso de todas as apps aos seus dados. A solução é um novo token de acesso, não repetir o pedido.

### O que significa o código de erro 0 do WhatsApp?

Significa que a plataforma recebeu um pedido e não o conseguiu associar a um utilizador da app em que confie.

A Meta classifica o código 0 nos erros de autorização da referência de erros da Cloud API, com o texto de detalhes "We were unable to authenticate the app user." Os motivos possíveis que indica dizem todos respeito ao token: expirou, foi invalidado, ou a pessoa que o concedeu alterou uma definição que impede todas as apps de aceder aos seus dados.

Nada nessa lista diz respeito ao número de telefone, à conta WhatsApp Business ou à mensagem que se envia. O pedido nunca chegou suficientemente longe para que algum desses elementos fosse verificado.

### Como se corrige o erro 0?

Obtenha um novo token de acesso. É o remédio que a Meta indica e é o único que funciona.

Antes de o substituir, apure qual das três causas se aplicou, porque cada uma volta a surgir se for ignorada. Um token de utilizador com curta duração voltará a expirar na data prevista. Um token invalidado continuará a falhar até alguém conceder novamente o acesso. Um utilizador que desativou por completo o acesso das apps tem de o reativar antes de qualquer token desse utilizador poder funcionar.

Para envios de servidor para servidor, o guia de tokens de acesso da Meta recomenda tokens de System User, que descreve como de longa duração e adequados a serviços automatizados que não precisam de intervenção do utilizador.

### O erro 0 é o mesmo que o erro 190?

Sobrepõem-se na prática, mas a Meta lista-os em separado.

O erro 190 traz o texto de detalhes "Your access token has expired." O erro 0 é mais abrangente: cobre um token expirado, um token invalidado e um utilizador que bloqueou por completo o acesso das apps. Ambos constam da mesma tabela de autorização e ambos se resolvem com um novo token.

A diferença prática está no diagnóstico. Um 190 indica que o token expirou. Um 0 indica que a autenticação falhou e deixa a si a tarefa de apurar o motivo, o que vale a pena fazer antes de emitir um substituto que falhe exatamente da mesma forma uma hora depois.

- Repetir o mesmo pedido. Um token não autenticado continua não autenticado, por isso cada nova tentativa devolve novamente o código 0.
- Voltar a ligar o número. O número nunca chegou a ser verificado, pelo que voltar a integrá-lo pede ao titular da empresa um trabalho que não altera nada.
- Emitir um novo token de utilizador de curta duração para uma tarefa de backend. Vai expirar na data prevista e o erro regressa.

**O erro 0 significa que o meu número foi desligado?** Não. Os motivos da Meta para o código 0 dizem todos respeito ao token de acesso. O número e a app do WhatsApp Business no telemóvel não estão envolvidos.

**Onde está documentado o erro 0?** Na tabela de erros de autorização da referência de códigos de erro da Cloud API da Meta. A Cloud API assenta na Graph API, que usa o mesmo formato de erro.

**Esperar faz o erro 0 desaparecer?** Não. Um token expirado ou invalidado não se recupera por si. É necessário um novo token.

**Como verifico o que um token pode fazer?** Utilize o depurador de tokens de acesso da Meta ou o endpoint debug_token. Ambos mostram se o token é válido, quando expira e que permissões inclui.

---

## Erro 3 do WhatsApp: problema de capacidade ou permissões

https://easycoexistence.com/pt-pt/docs/whatsapp-error-3

O código de erro 3 significa que a app que chama o endpoint não tem uma capacidade ou permissão que esse endpoint exige. A descrição da Meta é "Capability or permissions issue." A Graph API dá-lhe o nome API Method. A solução é inspecionar as permissões concedidas ao token com o depurador de tokens de acesso e adicionar a que o endpoint necessita.

### O que significa o código de erro 3 do WhatsApp?

Significa que o pedido foi autenticado, mas a app não tem autorização para fazer o que solicitou.

A Meta inclui o código 3 entre os erros de autorização na referência da Cloud API, com o texto de detalhe "Capability or permissions issue." O guia de tratamento de erros da Graph API, que a Cloud API herda, chama a este mesmo código API Method e indica que se deve confirmar que a app tem a capacidade ou as permissões necessárias para a chamada.

Portanto, o token funciona. A identidade não é o problema, o que distingue este erro dos códigos 0 e 190. O problema é aquilo a que o token pode aceder.

### Como se verifica que permissões tem um token?

Com o depurador de tokens de acesso ou com o endpoint debug_token, que devolve a mesma informação.

A resposta lista as permissões concedidas na propriedade scopes. Compare essa lista com a página de referência do endpoint que falhou, já que cada referência indica as permissões que exige.

No WhatsApp, duas permissões cobrem quase tudo. A whatsapp_business_management é necessária para metadados da conta, templates, listagens de números de telefone, análises e webhooks da conta. A whatsapp_business_messaging é necessária para enviar qualquer mensagem e para receber webhooks de mensagens e de estado. Um token que tenha apenas uma delas falha nas chamadas que exigem a outra.

### Porque é que uma app de parceiro vê o erro 3 e um programador direto não?

Porque os parceiros que servem outras empresas têm uma barreira adicional.

O guia de permissões da Meta indica que um parceiro cujos clientes usam a sua app para aceder aos respetivos dados tem de passar o App Review e ter Advanced access em todas as permissões de que a app precisa. Um programador direto, que trabalha apenas com os dados da sua própria empresa, não precisa de App Review nem de Advanced access.

Assim, o mesmo código pode funcionar sem problemas na conta do próprio programador e falhar na conta de um cliente. Quando surge este padrão, a questão não é que permissão falta no token, mas se a app foi aprovada para usar essa permissão em ativos que não lhe pertencem.

- Gerar um novo token com os mesmos scopes. Um token novo com as mesmas permissões falha no mesmo ponto.
- Verificar o nome da permissão nas definições da app em vez de no token. O que conta é o que foi concedido ao token.
- Testar apenas na sua própria conta. As apps de parceiros precisam de Advanced access para que as contas de clientes aceitem a chamada.

**O erro 3 é um problema com o meu número de telefone?** Não. Diz respeito ao que o token da app pode fazer. O número não é verificado antes de o pedido ser recusado.

**Qual é a diferença entre o erro 3 e o erro 10?** O código 3 é um problema de capacidade ou permissões. O código 10 indica que uma permissão não foi concedida ou foi removida. Ambos se resolvem verificando os scopes do token.

**Que permissão é necessária para enviar mensagens?** A whatsapp_business_messaging. O guia de permissões da Meta indica que é obrigatória para enviar qualquer tipo de mensagem.

**Voltar a tentar ajuda?** Não. As permissões do token não mudam entre tentativas, pelo que o resultado é o mesmo.

---

## Erro 4 do WhatsApp: a app atingiu o limite de chamadas à API

https://easycoexistence.com/pt-pt/docs/whatsapp-error-4

O código de erro 4 significa que a app atingiu o limite de chamadas à API. A descrição da Meta é "The app has reached its API call rate limit." Conta as chamadas feitas pela app numa hora deslizante, não as mensagens enviadas a partir de um número. Consulte o consumo no Painel de Apps, aguarde e reduza a frequência com que a app chama a API.

### O que significa o código de erro 4 do WhatsApp?

Significa que a sua app fez demasiadas chamadas à API na janela atual e que as chamadas seguintes são recusadas até a contagem baixar.

A Meta lista o código 4 nos erros de limitação, com o texto de detalhe "The app has reached its API call rate limit." O guia de tratamento de erros da Graph API chama-lhe API Too Many Calls e descreve-o como um problema temporário de limitação.

Fica ao lado de outros dois códigos de limitação fáceis de confundir com ele. O 80007 indica que a conta do WhatsApp Business atingiu o seu limite. O 130429 refere-se ao throughput de mensagens da Cloud API. O código 4 não é nenhum deles: é o orçamento de chamadas da própria app.

### Como é calculado o limite de chamadas da app?

Para pedidos feitos com um token de acesso da app, o guia de limites da Graph API da Meta dá uma fórmula: as chamadas numa hora são iguais a 200 multiplicado pelo número de utilizadores.

O número de utilizadores baseia-se nos utilizadores ativos diários únicos da app, recorrendo-se aos valores semanais e mensais quando a utilização diária desce. É um limite da app no seu todo e não por utilizador, pelo que alguns utilizadores muito ativos podem consumir a maior parte.

O guia indica ainda que o consumo aparece no Painel de Apps e, depois de feitas chamadas suficientes, num cabeçalho X-App-Usage nas respostas. Esse cabeçalho permite ver o limite a aproximar-se antes de chegar o erro 4.

### O que fazer depois do erro 4?

Pare de chamar durante algum tempo e depois chame menos.

O guia de limites da Meta é direto quanto à primeira parte: quando o limite é atingido, deve parar-se de fazer chamadas à API, porque continuar aumenta a contagem e alonga o tempo até as chamadas voltarem a funcionar.

A segunda parte é de conceção. Distribua os pedidos de forma uniforme em vez de em rajadas, filtre as respostas para que uma só chamada devolva o necessário e evite chamadas que obtêm dados sobrepostos. As consultas repetidas são o culpado habitual. Uma integração que pede o estado da mesma conta de poucos em poucos segundos gasta o orçamento em respostas que já tem.

- Repetir em ciclo. Cada chamada extra soma à contagem e afasta a recuperação.
- Tratá-lo como um limite de envio. O código 4 conta as chamadas da app, enquanto o throughput de mensagens é o 130429.
- Consultar endpoints de estado a intervalos curtos. Leituras repetidas de dados que não mudaram gastam o orçamento horário.

**O erro 4 é o mesmo que o erro 130429?** Não. O 130429 é o throughput de mensagens de um número. O erro 4 conta as chamadas à API feitas pela sua app.

**Quanto tempo dura o erro 4?** Até a contagem de chamadas na janela deslizante de uma hora descer abaixo do limite. Chamar durante esse tempo prolonga-o.

**Onde posso ver quão perto a minha app está do limite?** Na secção Application Rate Limit do Painel de Apps e no cabeçalho X-App-Usage devolvido nas respostas.

**O erro 4 é o mesmo que o erro 80007?** Não. A Meta usa o 80007 quando a conta do WhatsApp Business atinge o seu limite, enquanto o erro 4 conta as chamadas da própria app.

---

## Erro 10 do WhatsApp: permissão não concedida ou removida

https://easycoexistence.com/pt-pt/docs/whatsapp-error-10

O código de erro 10 significa que o token da app não tem uma permissão de que o endpoint precisa, ou porque nunca foi concedida ou porque foi removida. A descrição da Meta é "Permission is either not granted or has been removed." A Meta indica ainda duas causas específicas do WhatsApp: um número que não consta da lista de permissões nos Flows com Endpoint e o não cumprimento dos requisitos de elegibilidade de uma API.

### O que significa o código de erro 10 do WhatsApp?

Significa que o token chegou à Meta e foi reconhecido, mas a permissão exigida pela chamada não consta dele.

A referência da Cloud API da Meta atribui ao código 10 o texto de detalhes "Permission is either not granted or has been removed." O guia de tratamento de erros da Graph API chama-lhe API Permission Denied e indica que se deve tratar a permissão em falta.

A palavra removida é importante. Uma permissão pode ser concedida na configuração inicial e retirada mais tarde, por exemplo quando alguém revoga o acesso da app nas Definições da empresa, pelo que uma integração que funcionou durante meses pode começar a devolver o erro 10 sem qualquer alteração ao seu próprio código.

### Que outras causas indica a Meta para o erro 10?

Duas que são específicas do WhatsApp, e ambas passam facilmente despercebidas porque nada têm que ver com permissões.

Nos WhatsApp Flows com Endpoint, a Meta indica que se deve confirmar que o número de telefone usado para definir a chave pública da empresa consta da lista de permissões. Um número fora dessa lista origina este código mesmo que o token tenha todas as permissões.

A Meta refere também que uma conta que não cumpra os requisitos de elegibilidade da API que está a chamar recebe este código. Nesse caso, nenhuma alteração ao token resolve, porque o obstáculo é a elegibilidade da conta e não a credencial.

### Como se corrige o erro 10?

Comece pelo depurador de tokens de acesso, que a Meta indica como primeira verificação.

Se a lista de permissões do token não incluir a que o endpoint exige, peça à empresa que a conceda de novo. Numa app de parceiro, isso implica também confirmar o Acesso avançado para essa permissão, uma vez que o guia de permissões da Meta o exige para contas de clientes.

Se as permissões parecerem completas, passe às duas causas específicas do WhatsApp. Numa chamada de Flows, verifique a lista de permissões para o número que definiu a chave pública. Em qualquer outro caso, leia os requisitos de elegibilidade da API que está a chamar e confirme que a conta os cumpre antes de alterar qualquer credencial.

- Presumir que a integração falhou por causa de uma publicação. Uma permissão removida nas Definições da empresa produz este código sem qualquer alteração ao código.
- Refazer o token quando a causa é a elegibilidade. Uma credencial não torna elegível uma conta que não o é.
- Ignorar a lista de permissões dos Flows. Nos Flows com Endpoint, um número que não conste dela devolve o erro 10 mesmo com todas as permissões.

**O erro 10 é o mesmo que o erro 131005?** Partilham a mesma descrição na referência da Meta. O código 10 é o código da Graph API e o 131005 pertence à gama do WhatsApp. Ambos se verificam da mesma forma.

**O erro 10 pode surgir num número que funcionava ontem?** Sim. A descrição da Meta inclui permissões que foram removidas, pelo que um acesso concedido anteriormente pode ser retirado mais tarde.

**O erro 10 significa que o meu token expirou?** Não. Um token expirado devolve o código 190 ou 0. O código 10 significa que o token é válido, mas não tem uma permissão.

**Como vejo que permissões foram concedidas?** Chame debug_token ou abra o depurador de tokens de acesso. A propriedade scopes lista todas as permissões do token.

---

## Erro 200 do WhatsApp: nenhum token de acesso fornecido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-200

O código de erro 200 significa que o pedido chegou à Meta sem token de acesso. A descrição da Meta é "No access token was provided" e a API devolve a mensagem 'Provide valid app ID'. Surge em certos endpoints GET, como whatsapp_business_profile. Os códigos 200 a 299 abrangem também permissões que não foram concedidas ou que foram removidas.

### Porque é que o erro 200 diz 'Provide valid app ID'?

Porque essa é a mensagem que a API devolve, embora o problema real seja a falta de token.

A referência de erros da Meta indica que o código 200 ocorre em certos endpoints GET, como whatsapp_business_profile, quando não é incluído nenhum token, e que a API devolve a mensagem 'Provide valid app ID'. A mesma referência refere que outros endpoints podem devolver 190 ou 104 para a mesma omissão.

Assim, o texto aponta para o app ID, mas a correção está no token. Verifique se o cabeçalho Authorization está presente e bem escrito, e se a variável que contém o token foi mesmo preenchida quando o pedido foi construído.

### Quando é que o erro 200 significa antes uma permissão em falta?

Quando o token está presente, mas a app não tem a permissão de que a chamada precisa.

A Meta indica o intervalo 200 a 299 como "Permission is either not granted or has been removed", com a mesma solução do código 10: verificar o token no depurador de tokens de acesso. Estão documentados dois casos concretos. O guia de permissões diz que uma app que utiliza whatsapp_business_management em WABAs que a sua empresa não possui, sem acesso avançado, recebe o erro 200. O guia de registo diz que anular o registo de um número sem whatsapp_business_management devolve o erro 200. O guia de tokens de acesso acrescenta um terceiro: um token de utilizador de sistema cujo utilizador não tem acesso ao recurso consultado é rejeitado com 200.

Leia o texto da mensagem para distinguir os casos. Um token em falta diz 'Provide valid app ID'.

### Em que difere o erro 200 do erro 190?

O erro 190 significa que foi enviado um token que expirou. O erro 200, no primeiro significado, quer dizer que não foi enviado token nenhum.

A referência da Meta afirma esta distinção diretamente: a solução para o 200 é garantir que o pedido inclui um token de acesso válido, e descreve esta condição como distinta do 190, que abrange tokens expirados ou inválidos.

Isto muda onde procurar. Um 190 leva-o à validade e à renovação dos tokens. Um 200 com 'Provide valid app ID' leva-o ao código que constrói o pedido, porque a credencial nunca saiu do seu sistema.

- Procurar um problema de app ID. A mensagem diz app ID, mas a causa documentada pela Meta é um pedido sem token.
- Renovar o token quando nunca chegou a ser enviado. Um token novo que o pedido continua a omitir produz o mesmo erro.
- Tratar todos os 200 como token em falta. Com um token presente, o intervalo 200 a 299 significa uma permissão em falta.

**O erro 200 pode surgir num número que funciona?** Sim. Descreve o pedido, não o número. Um número em perfeito estado rejeita na mesma uma chamada que chega sem token.

**Porque é que um endpoint devolveu 200 e outro 190?** A Meta indica que, para um token em falta, alguns endpoints GET devolvem 200, enquanto outros endpoints podem devolver 190 ou 104.

**Anular o registo de um número exige uma permissão especial?** Sim. O guia de registo da Meta diz que anular o registo sem whatsapp_business_management devolve o erro 200.

**O erro 200 está relacionado com o erro 10?** No significado de permissão, sim. Ambos têm a descrição de que uma permissão não foi concedida ou foi removida.

---

## Erro 130472 do WhatsApp: mensagem não enviada por causa de uma experiência

https://easycoexistence.com/pt-pt/docs/whatsapp-error-130472

O erro 130472 significa que uma mensagem de template de marketing não foi enviada porque o destinatário faz parte da experiência de mensagens de marketing da Meta. A descrição da Meta é "Message was not sent as part of an experiment." Uma pequena percentagem de utilizadores do WhatsApp não recebe templates de marketing, a menos que esteja aberta uma janela de atendimento ao cliente ou uma janela de ponto de entrada gratuito. A mensagem não é cobrada.

### O que significa o erro 130472 do WhatsApp?

Significa que a Meta reteve um template de marketing porque o destinatário pertence a um grupo de experiência.

A página de experiências da Meta explica que o WhatsApp realiza experiências contínuas para medir o efeito das mensagens na experiência do utilizador. Na experiência de mensagens de marketing, uma percentagem muito pequena de utilizadores do WhatsApp não recebe mensagens de template de marketing de nenhuma empresa, a menos que esteja aberta com essa empresa uma janela de atendimento ao cliente ou uma janela de ponto de entrada gratuito.

Quando se envia um template de marketing a um destes utilizadores, o WhatsApp não o envia e não cobra a mensagem. Chega um webhook de estado com `status` definido como failed e o código de erro 130472.

### Como chegar a um cliente que desencadeia o erro 130472?

Fazendo com que seja ele a enviar-lhe primeiro uma mensagem, o que abre uma janela de atendimento ao cliente.

A página de experiências da Meta é explícita: reenviar o template resulta no mesmo erro. A via sugerida é contactar o utilizador por outro canal que não o WhatsApp e pedir-lhe que envie uma mensagem, para que o template possa ser enviado dentro de uma janela de atendimento ao cliente aberta.

A experiência limita-se aos templates de marketing. Aplica-se aos utilizadores do grupo, independentemente da empresa que envia, pelo que nada na sua conta, no template ou no número a provocou, e alterar qualquer um deles também não ajuda.

### Como deve uma integração tratar o erro 130472?

Como um estado final para essa mensagem, não como uma falha a repetir.

Como o erro chega através do webhook de estado e não apenas na resposta ao envio, o tratamento pertence ao processador de webhooks. Marque a mensagem como retida pela experiência, não coloque nenhuma repetição em fila e mantenha-a fora dos alarmes de taxa de falhas, para que não pareça um problema de entrega.

Convém também separá-la nos relatórios. Uma campanha com alguns resultados 130472 não perdeu qualidade nem alcance por algo que tenha feito, e contá-los junto com as falhas genuínas torna os números mais difíceis de ler.

- Reenviar o template. A Meta indica que reenviar devolve o mesmo erro.
- Tratá-lo como um problema de qualidade. A experiência aplica-se a um grupo de utilizadores, da mesma forma para todas as empresas.
- Observar apenas a resposta ao envio. O estado 130472 chega através do webhook de mensagens.

**Sou cobrado por uma mensagem bloqueada com o 130472?** Não. A página de experiências da Meta indica que a mensagem não é enviada e que não é cobrada.

**Posso excluir a minha empresa da experiência?** Não. A Meta indica que não existem exceções nem exclusão voluntária, e que a experiência não tem data de fim definida.

**O erro 130472 afeta os templates de utilidade?** A Meta descreve a experiência como abrangendo mensagens de template de marketing. Não menciona outras categorias.

**Como posso entregar a mensagem mesmo assim?** Peça ao cliente, por outro canal, que lhe envie uma mensagem. Dentro da janela de atendimento ao cliente aberta, o template pode ser enviado.

---

## Erro 131005 do WhatsApp: acesso negado, permissão em falta

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131005

O erro 131005 significa que o token de acesso não tem uma permissão exigida pelo endpoint do WhatsApp, porque nunca foi concedida ou foi removida entretanto. A descrição da Meta é "Permission is either not granted or has been removed." Para o resolver, inspecione o token com o depurador de tokens de acesso e conceda a permissão em falta ou passe a usar um token que a tenha.

### O que significa o erro 131005 do WhatsApp?

Significa que o token é aceite como autêntico, mas não tem a permissão que o endpoint verifica.

A referência da Cloud API da Meta lista o 131005 com o texto de detalhe "Permission is either not granted or has been removed." O erro 10 da Graph API tem exatamente a mesma frase. A diferença está apenas na gama: o 10 é um código genérico da Graph API, enquanto o 131005 pertence aos códigos do WhatsApp que começam por 131.

Como as palavras são as mesmas, o diagnóstico é o mesmo. A solução que a Meta indica para ambos é usar o depurador de tokens de acesso e confirmar que a app tem as permissões exigidas pelo endpoint.

### Que permissão costuma estar em falta?

Normalmente uma das duas permissões do WhatsApp, e qual delas depende do que a chamada faz.

O guia de permissões da Meta divide-as por função. A whatsapp_business_messaging é necessária para enviar qualquer tipo de mensagem e para receber webhooks de mensagens e de estado. A whatsapp_business_management é necessária para os metadados da conta, a gestão de templates, a listagem de números de telefone, as estatísticas e os webhooks da conta.

Um token gerado apenas com a permissão de gestão consegue ler a conta e listar templates, mas falha no momento em que tenta enviar. Ao gerar um token de utilizador do sistema, o guia de tokens de acesso da Meta indica que se atribuam em conjunto business_management, whatsapp_business_management e whatsapp_business_messaging.

### Como se resolve o erro 131005?

Leia primeiro o token e altere só o que falta.

Chame o endpoint debug_token ou cole o token no depurador de tokens de acesso. A propriedade `scopes` lista todas as permissões concedidas. Compare-a com a página de referência do endpoint que falhou.

Se faltar uma permissão, gere um novo token que a inclua ou peça ao proprietário da empresa que a conceda de novo, caso o token venha de um fluxo de parceiro. Se todas as permissões estiverem presentes e o erro persistir, verifique se o utilizador do sistema associado ao token tem acesso à conta WhatsApp Business específica, pois um token pode ter todos os âmbitos e, mesmo assim, não estar atribuído a esse ativo.

- Presumir que o token expirou. A expiração devolve 190 ou 0. Este código indica que o token funciona, mas não tem uma permissão.
- Gerar um token apenas com a permissão de gestão e usá-lo para enviar. O envio exige whatsapp_business_messaging.
- Verificar os âmbitos e ficar por aí. O utilizador do sistema também precisa de ter acesso concedido a essa conta WhatsApp Business específica.

**O 131005 é o mesmo erro que o 10?** Têm a mesma descrição na referência da Meta. O 131005 pertence à gama do WhatsApp e o 10 à gama da Graph API.

**Uma permissão pode ser removida depois da configuração?** Sim. A descrição da Meta abrange expressamente as permissões que foram removidas, e não só as que nunca foram concedidas.

**O erro 131005 afeta a app WhatsApp Business no telemóvel?** Não. Diz respeito ao token da API. A app no telemóvel continua a funcionar como antes.

**Devo voltar a tentar depois do erro 131005?** Não. Voltar a tentar com o mesmo token produz o mesmo resultado. Corrija primeiro a permissão.

---

## Erro 131037 do WhatsApp: o número 555 não tem nome a apresentar aprovado

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131037

O erro 131037 significa que a mensagem foi enviada a partir de um número de telefone empresarial 555 cujo nome a apresentar não foi aprovado. A descrição da Meta é «O número de telefone empresarial 555 usado para enviar o pedido não tem um nome a apresentar aprovado.» Um número 555 não pode enviar mensagens até a Meta aprovar o nome, pelo que a solução é alterá-lo.

### O que é um número de telefone empresarial 555?

Um número que a Meta oferece através do Embedded Signup às empresas que reúnem as condições para o obter.

A descrição geral do Embedded Signup da Meta indica que os clientes empresariais podem reclamar até dois números 555. Usam o indicativo internacional dos EUA +1 com o indicativo de zona 555, são verificados automaticamente e não podem ser migrados para outra WhatsApp Business Account nem utilizados fora da WhatsApp Business Platform.

No restante, comportam-se como os números empresariais normais, sujeitos às regras de preços e às classificações de qualidade, com uma condição adicional que explica este erro: o nome a apresentar de um número 555 tem de estar aprovado antes de este poder enviar mensagens.

### Como se corrige o erro 131037?

Obtenha a aprovação do nome a apresentar, o que na prática significa alterá-lo para um que passe na revisão.

A solução da Meta é alterar o nome a apresentar do número 555, e remete para o artigo do Centro de Ajuda sobre como alterar o nome a apresentar do WhatsApp Business. No WhatsApp Manager, o caminho é Ferramentas da conta, Números de telefone, separador Perfil do número e, por fim, Editar na secção Nome a apresentar. Siga as diretrizes da Meta para nomes a apresentar, porque um nome rejeitado deixa a situação como estava.

O guia de nomes a apresentar da Meta acrescenta que, depois de a alteração do nome ser aprovada, há 14 dias para voltar a registar o número, e que voltar a registá-lo antes da aprovação não tem qualquer efeito.

### Como se verifica se o nome a apresentar está aprovado?

Peça o campo name_status no ID do número de telefone.

O guia de nomes a apresentar da Meta explica que o campo verified_name contém apenas a cadeia de texto do nome que é submetida a revisão e não indica se foi aprovado. O campo name_status indica-o. Um webhook phone_number_name_update também comunica a decisão, com decision definido como APPROVED ou REJECTED.

Quando um nome é rejeitado, name_status fica com o valor DECLINED. A Meta indica que se devem rever as diretrizes e editar o nome, ou apresentar um recurso através do apoio para programadores. Enquanto o estado não mudar, todos os envios desse número 555 continuarão a devolver 131037.

- Ler verified_name como sinal de aprovação. A Meta indica que só name_status mostra se o nome foi aprovado.
- Voltar a registar o número antes da aprovação. A Meta indica que não tem efeito até o novo nome ser aprovado.
- Alterar o nome repetidamente sem ler as diretrizes. A Meta permite 10 alterações por 30 dias.

**O erro 131037 afeta os números empresariais normais?** Não. A descrição da Meta refere-se especificamente a um número de telefone empresarial 555 sem nome a apresentar aprovado.

**Posso mudar um número 555 para outra conta?** Não. A Meta indica que os números 555 não podem ser migrados para outra WhatsApp Business Account.

**Como vou saber quando o nome for aprovado?** Chega um webhook phone_number_name_update com decision definido como APPROVED, e name_status passa a APPROVED.

**E se o nome a apresentar for rejeitado?** Edite-o de acordo com as diretrizes da Meta para nomes a apresentar, ou apresente um recurso através do apoio para programadores.

---

## Erro 131057 do WhatsApp: conta em modo de manutenção

https://easycoexistence.com/pt-pt/docs/whatsapp-error-131057

O erro 131057 indica que a conta do WhatsApp Business está em modo de manutenção, pelo que os pedidos para ela são recusados durante um curto período. A descrição da Meta é "Business Account is in maintenance mode." Um dos motivos indicados pela Meta é uma subida de throughput, que demora até um minuto. Espere e volte a tentar, em vez de alterar o que quer que seja no pedido.

### O que significa o erro 131057 do WhatsApp?

Significa que a Meta colocou a conta do WhatsApp Business em modo de manutenção e, nesse momento, não aceita pedidos para ela.

A referência da Cloud API indica o texto de detalhe "Business Account is in maintenance mode" e explica que um dos motivos pode ser uma subida de throughput na conta. A expressão "um dos motivos" é importante: a Meta aponta a subida como causa possível, não como a única.

Não há nada de errado no pedido. A mesma chamada, enviada sem alterações depois de a manutenção terminar, deverá ser aceite, o que faz deste um dos poucos códigos em que esperar resolve tudo.

### Porque é que uma subida de throughput causa o erro 131057?

Porque o número fica brevemente indisponível enquanto é passado para o ritmo mais elevado.

O guia de throughput da Meta indica que a Cloud API suporta até 80 mensagens por segundo por predefinição e até 1.000 por subida automática. O processo de subida pode demorar até um minuto, durante o qual o número não pode ser usado na plataforma e qualquer pedido à API devolve 131057. Depois da primeira subida, os aumentos seguintes ocorrem sem interrupção.

O guia enumera as condições de elegibilidade: um limite de mensagens ilimitado no portefólio empresarial, pelo menos 100K utilizadores únicos contactados fora de uma janela de atendimento ao cliente em 24 horas consecutivas e uma classificação de qualidade média ou superior.

### O erro 131057 aplica-se a um número em Coexistence?

Pode surgir em qualquer número, mas a explicação do throughput encaixa pior nos números em Coexistência.

O guia de throughput da Meta indica que os números usados em simultâneo com a app do WhatsApp Business e a Cloud API têm um throughput fixo de 20 mensagens por segundo, para manter a compatibilidade com a app. A subida automática para 1.000 descrita no mesmo guia aplica-se a números no nível predefinido.

Assim, num número em Coexistência, interprete o 131057 pelo seu sentido literal, uma conta em modo de manutenção, e aguarde antes de voltar a tentar. Se persistir bem para lá de alguns minutos, contacte o apoio ao cliente da Meta com o fbtrace_id da resposta, em vez de voltar a ligar o número.

- Alterar o pedido. O pedido é válido, pelo que alterá-lo não ajuda enquanto a conta estiver em manutenção.
- Repetir sem esperar. Durante uma subida, todas as chamadas feitas nesse minuto devolvem o mesmo código.
- Voltar a ligar o número. O modo de manutenção é do lado da Meta e termina sem qualquer ação da empresa.

**Quanto tempo dura o modo de manutenção?** A Meta indica que uma subida de throughput demora até um minuto. Para outras causas de manutenção, a Meta não publica uma duração.

**Serei avisado quando a subida terminar?** Sim. A Meta envia um webhook phone_number_quality_update com event definido como THROUGHPUT_UPGRADE quando o número é atualizado.

**Um throughput mais elevado custa mais?** Não. O guia de throughput da Meta indica que a subida é gratuita e não afeta os preços.

**O erro 131057 está relacionado com o 130429?** Indiretamente. O 130429 significa que enviou mais depressa do que o seu throughput permite. O 131057 pode surgir enquanto esse throughput está a ser aumentado.

---

## Erro 132005 do WhatsApp: o texto traduzido é demasiado longo

https://easycoexistence.com/pt-pt/docs/whatsapp-error-132005

O erro 132005 significa que o texto do template enviado é demasiado longo na tradução utilizada. A descrição da Meta é "Translated text is too long." A orientação da Meta é verificar no WhatsApp Manager se o template foi traduzido e, depois, rever o estado do template. O corpo de um template tem um máximo de 1 024 caracteres e o rodapé 60.

### O que significa o erro 132005 do WhatsApp?

Significa que o envio de um template falhou porque o texto, na versão de idioma que está a ser enviada, excede o que a plataforma permite.

A Meta inclui o 132005 entre os erros de templates, com o texto de detalhe "Translated text is too long." A solução indicada é verificar o WhatsApp Manager para confirmar que o template foi traduzido e consultar a documentação sobre qualidade de templates para saber como verificar o estado do template.

A palavra traduzido é a pista. Um template existe por idioma, e a versão que falha é a que corresponde ao código de idioma do pedido de envio, que pode não ser a que escreveu e verificou em primeiro lugar.

### Como se corrige o erro 132005?

Abra o template no WhatsApp Manager e consulte o idioma que está a enviar.

Confirme que existe uma tradução para o código de idioma do pedido e que o respetivo estado permite o envio. Depois, verifique o comprimento face aos limites de componentes da Meta: o corpo tem um máximo de 1 024 caracteres e o rodapé um máximo de 60. As traduções costumam ser mais longas do que o original, pelo que um template que cabe num idioma pode exceder o limite noutro.

Se uma tradução for demasiado longa, encurte essa versão de idioma no WhatsApp Manager. Voltar a enviar o mesmo template no mesmo idioma, sem o editar, falha da mesma forma.

### Como evitar o erro 132005 em templates multilingues?

Verifique cada versão de idioma face aos limites antes de a submeter, e não apenas a primeira.

Uma verificação simples de comprimento, na ferramenta em que redige os templates, apanha a maioria dos casos: conte os caracteres do corpo e do rodapé de cada tradução e compare com 1 024 e 60. Deixe margem quando o corpo tem variáveis, porque os valores preenchidos no momento do envio fazem parte da mensagem que o cliente recebe.

Mantenha o código de idioma da lógica de envio associado a traduções que realmente existem. Um pedido para um idioma que o template não tem é outro erro, o 132001, e manter os dois separados facilita a leitura dos registos.

- Verificar apenas o idioma original. A versão que falha é a tradução que corresponde ao código de idioma do pedido.
- Reenviar sem editar. O comprimento do texto não muda entre tentativas.
- Confundi-lo com o 132001. Esse código significa que o template não existe nesse idioma ou não está aprovado.

**O erro 132005 tem a ver com as minhas variáveis?** A descrição da Meta refere que o texto traduzido é demasiado longo. Verifique primeiro o comprimento da tradução, incluindo a margem para os valores das variáveis.

**Qual é o limite do corpo de um template?** A referência da Meta sobre componentes de templates define um máximo de 1 024 caracteres para o corpo.

**Onde se verifica a tradução?** No WhatsApp Manager, no template, na versão de idioma que corresponde ao seu pedido.

**O erro 132005 é o mesmo que o 132001?** Não. A Meta descreve o 132001 como um template que não existe no idioma especificado ou que não foi aprovado.

---

## Erro 133000 do WhatsApp: a tentativa anterior de anulação do registo falhou

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133000

O erro 133000 significa que uma tentativa anterior de anular o registo do número de telefone falhou, pelo que o número não pode ser registado até que isso fique resolvido. A descrição da Meta é "Uma tentativa anterior de anulação do registo falhou." A solução indicada pela Meta é anular novamente o registo do número e, depois, registá-lo. Ambos os endpoints estão limitados a 10 pedidos por número numa janela móvel de 72 horas.

### O que significa o erro 133000 do WhatsApp?

Significa que a plataforma ainda tem uma anulação do registo por concluir associada a este número e não vai registar o número por cima dela.

A Meta lista o 133000 com o texto de detalhes "Uma tentativa anterior de anulação do registo falhou" e uma correção de uma só linha: anular de novo o registo do número antes de o registar. Por isso, o erro surge normalmente numa chamada de registo, embora a causa esteja numa chamada anterior de anulação do registo.

A anulação do registo faz-se com um POST ao endpoint de anulação do registo do ID do número de telefone. O guia de registo da Meta avisa que esta operação torna o número inutilizável com a Cloud API até ser registado novamente, e que não elimina o número nem o seu histórico de mensagens.

### Como se corrige o erro 133000?

Repita a anulação do registo, confirme que teve êxito e só depois registe.

Uma chamada de anulação do registo bem-sucedida devolve success com o valor true. Só depois de obter essa resposta deve seguir-se a chamada de registo, com o campo messaging_product e o PIN de seis dígitos da verificação em dois passos do número.

A chamada de anulação do registo exige a permissão whatsapp_business_management. O guia de registo da Meta indica que um pedido de anulação do registo sem essa permissão devolve o erro 200, que pode ser confundido com uma segunda falha do mesmo tipo. Se a própria chamada de anulação do registo continuar a falhar, leia o valor de details em cada resposta antes de enviar outra, porque cada tentativa conta para o limite descrito abaixo.

### Porque é que o limite de tentativas é relevante aqui?

Porque corrigir este erro é, em si, uma sequência de tentativas, e a Meta limita-as.

O guia de registo limita os endpoints de registo e de anulação do registo a 10 pedidos por número da empresa numa janela móvel de 72 horas. Ao exceder esse limite, é devolvido o erro 133016 e o número fica bloqueado para essa operação nas 72 horas seguintes.

Um script que repita em ciclo chamadas de anulação do registo e de registo após uma falha pode gastar todo o limite em segundos e deixar o número inutilizável durante três dias. Faça cada tentativa de forma deliberada, guarde a resposta e pare para investigar após duas ou três falhas, em vez de continuar automaticamente.

- Chamar o registo de novo sem anular primeiro o registo. A correção da Meta exige que a anulação do registo termine antes de registar.
- Repetir automaticamente em ciclo as chamadas de registo e de anulação do registo. O limite é de dez pedidos em 72 horas e, ao excedê-lo, o número fica bloqueado.
- Anular o registo sem a permissão whatsapp_business_management. Isso devolve o erro 200, que esconde o estado real do número.

**Anular o registo elimina o meu número?** Não. O guia de registo da Meta indica que a anulação do registo não elimina o número nem o seu histórico de mensagens.

**Posso anular o registo de um número em Coexistence com a API?** Não. A Meta indica que o endpoint de anulação do registo não pode ser usado num número que esteja em uso na Cloud API e na app WhatsApp Business ao mesmo tempo.

**O que acontece após 10 tentativas?** A API devolve 133016 e bloqueia o número para essa operação nas 72 horas seguintes.

**Preciso do PIN para registar novamente?** Sim. O registo requer o PIN de seis dígitos da verificação em dois passos do número, quando essa verificação está ativada.

---

## Erro 133004 do WhatsApp: servidor temporariamente indisponível

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133004

O erro 133004 significa que o servidor que tratava o pedido estava temporariamente indisponível. A descrição da Meta é "O servidor está temporariamente indisponível." O pedido em si não tem culpa. A indicação da Meta é consultar a página de estado da WhatsApp Business Platform e ler o valor details na resposta antes de voltar a tentar, com um intervalo de espera.

### O que significa o erro 133004 do WhatsApp?

Significa que a plataforma não conseguiu processar o pedido naquele momento porque um servidor estava indisponível.

A Meta lista o 133004 na referência de erros da Cloud API com o texto de details "O servidor está temporariamente indisponível." A palavra temporariamente é a parte essencial. Nada no token de acesso, no número ou na mensagem está a ser rejeitado, e o mesmo pedido pode funcionar pouco depois.

O código surge entre os códigos 133, a maioria dos quais diz respeito ao registo e ao cancelamento do registo de números de telefone, pelo que é frequente encontrá-lo numa chamada de registo. A Meta não o restringe ao registo, por isso trate-o como uma condição do servidor onde quer que apareça.

### O que deve verificar antes de voltar a tentar?

Duas coisas, ambas indicadas na solução da própria Meta.

Primeiro, a página de estado da WhatsApp Business Platform em metastatus.com. Se a Meta estiver a reportar um incidente, voltar a tentar é inútil até ficar resolvido, e a página dá uma resposta mais rápida do que os seus próprios registos.

Segundo, o valor details dentro de error_data na resposta. A referência de erros da Meta descreve details como o motivo mais provável do erro, por vezes com orientação sobre o que fazer. Para este código, a Meta diz expressamente para o consultar antes de voltar a tentar. Se a página de estado não indicar problemas e details não der um tempo de espera, volte a tentar com um intervalo crescente em vez de o fazer de imediato.

### Em que difere o 133004 de outros erros temporários?

A Meta lista vários códigos que descrevem algo brevemente indisponível, e convém mantê-los separados nos registos.

O código 1 é descrito como pedido inválido ou possível erro do servidor, o código 2 como temporário por inatividade ou sobrecarga, e o 131016 como um serviço temporariamente indisponível. O 133004 refere-se especificamente a um servidor.

O tratamento é semelhante em todos: confirmar o estado da plataforma, ler o valor details e aguardar antes de voltar a tentar. Registar o código exato continua a ser importante, porque um conjunto de ocorrências de um código a uma certa hora do dia diz ao apoio da Meta muito mais do que uma nota genérica de que a API esteve em baixo.

- Repetir de imediato num ciclo apertado. Um servidor que está em baixo continua em baixo no milissegundo seguinte.
- Ignorar o valor details. A Meta diz para o ler antes de voltar a tentar, e pode conter o motivo.
- Alterar o pedido para contornar o erro. Nada no pedido causou o erro.

**O erro 133004 é culpa minha?** Não. A Meta descreve-o como um servidor temporariamente indisponível. O pedido não o causou.

**Onde fica a página de estado da WhatsApp Business Platform?** A Meta indica metastatus.com/whatsapp-business-api na sua referência de códigos de erro.

**Quanto tempo devo esperar antes de voltar a tentar?** A Meta não indica um tempo fixo. Consulte o valor details e a página de estado e depois volte a tentar com um intervalo crescente.

**O que devo enviar ao apoio da Meta se o erro persistir?** O fbtrace_id da resposta de erro, que a Meta diz poder ajudar a depurar o erro.

---

## Erro 133009 do WhatsApp: PIN da verificação em dois passos introduzido depressa demais

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133009

O erro 133009 significa que as tentativas de PIN da verificação em dois passos chegaram à Meta mais depressa do que esta as aceita. A descrição da Meta é "Two-step verification PIN was entered too quickly." O PIN pode estar certo ou errado. Leia o valor de details na resposta antes de tentar de novo e envie a tentativa seguinte só depois de passar a espera indicada.

### O que significa o erro 133009 do WhatsApp?

Significa que as tentativas de PIN para este número estão a chegar demasiado próximas umas das outras, e a Meta recusa a mais recente sem a avaliar.

A referência da Cloud API atribui ao 133009 o texto de details "Two-step verification PIN was entered too quickly" e uma só instrução: verificar o valor de details na resposta antes de tentar de novo.

Este código situa-se entre dois códigos vizinhos. O 133005 indica que o PIN estava incorreto. O 133008 indica que houve demasiadas tentativas de PIN para o número. O 133009 diz respeito apenas ao ritmo, e por isso aparece quando um processo envia tentativas de PIN em sucessão rápida, por exemplo um ciclo de repetição num pedido de registo.

### Como se corrige o erro 133009?

Abrande e deixe de adivinhar.

Leia o valor de details em error_data antes da tentativa seguinte. A referência da Meta descreve details como a razão mais provável do erro e, para este código, é a primeira coisa que a Meta manda verificar.

Depois, garanta que a tentativa seguinte usa um PIN que alguém conhece de facto. Se ninguém o conhece, o guia de verificação em dois passos da Meta descreve uma reposição no WhatsApp Manager: abra as definições do número de telefone, escolha Verificação em dois passos e clique em Alterar PIN. Um novo PIN conhecido é mais rápido do que uma série de tentativas que terminam em 133008 e numa espera mais longa.

### Onde é usado o PIN?

No registo do número para a Cloud API e em algumas operações da conta associadas.

O guia de verificação em dois passos da Meta indica que a definição exige um PIN de seis dígitos ao registar o número de telefone, e o pedido de registo recebe o PIN como campo obrigatório quando a verificação em dois passos está ativada. O guia de números de telefone da Meta acrescenta que o PIN é necessário para alterar o PIN ou para eliminar o número da plataforma.

Como raramente é preciso, esquece-se com facilidade. Guarde-o com as restantes credenciais da conta da empresa, e não com a pessoa que configurou o número pela primeira vez.

- Repetir o pedido de registo de imediato num ciclo. Tentativas rápidas de PIN são exatamente o que este código reporta.
- Experimentar PINs diferentes entre repetições. Demasiadas tentativas fazem passar do 133009 para o 133008.
- Ignorar o valor de details. A Meta indica-o como o que se deve verificar antes de tentar de novo.

**O erro 133009 significa que o meu PIN está errado?** Não necessariamente. Significa que as tentativas chegaram depressa demais. Um PIN incorreto é reportado como 133005.

**Quanto tempo devo esperar após o 133009?** A Meta não publica um tempo fixo. Leia o valor de details na resposta antes de tentar de novo.

**Posso desativar a verificação em dois passos por API?** Não. O guia de verificação em dois passos da Meta indica que não existe nenhum endpoint para a desativar. Pode definir um novo PIN.

**Como reponho um PIN esquecido?** No WhatsApp Manager, abra as definições do número de telefone, escolha Verificação em dois passos e clique em Alterar PIN.

---

## Erro 133015 do WhatsApp: número eliminado há pouco, eliminação por concluir

https://easycoexistence.com/pt-pt/docs/whatsapp-error-133015

O erro 133015 indica que o número de telefone a registar foi eliminado há pouco e que essa eliminação ainda não foi concluída. A descrição da Meta é: "The phone number you are attempting to register was recently deleted, and deletion has not yet completed." A solução documentada é esperar 5 minutos antes de voltar a tentar o pedido de registo.

### O que significa o erro 133015 do WhatsApp?

Significa que um pedido de registo chegou enquanto o mesmo número ainda estava a ser eliminado.

A referência da Meta apresenta o texto completo dos detalhes: "The phone number you are attempting to register was recently deleted, and deletion has not yet completed." A solução é igualmente concreta: esperar 5 minutos antes de repetir o pedido.

O caminho habitual até aqui é a mudança de um número. Elimina-se o número de uma conta WhatsApp Business e regista-se de imediato noutra, ou elimina-se e volta-se a adicioná-lo para recomeçar, e o segundo passo chega à Meta antes de o primeiro ter terminado em segundo plano.

### Como se elimina um número de telefone empresarial?

Apenas no WhatsApp Manager, e apenas por um administrador do portefólio empresarial.

O guia de números de telefone da Meta indica que um número empresarial não pode ser eliminado através da API. A eliminação faz-se no WhatsApp Manager, um número ligado exige o PIN da verificação em dois passos para ser eliminado, e um número que enviou mensagens pagas nos últimos 30 dias não pode ser eliminado até passarem 30 dias desde a última.

Eliminar não é o mesmo que anular o registo. O guia de registo da Meta explica que anular o registo apenas torna o número inutilizável com a Cloud API e não elimina o número nem o seu histórico de mensagens. O erro 133015 diz respeito especificamente à eliminação.

### Como evitar o erro 133015 ao mudar um número?

Inclua a espera no procedimento, em vez de a descobrir pelo caminho.

Depois de eliminar o número, faça uma pausa de pelo menos 5 minutos antes da chamada de registo. Se a chamada continuar a devolver 133015, espere outra vez em vez de voltar a tentar de imediato.

O motivo para ter paciência é o limite de registo. A Meta permite 10 pedidos ao endpoint de registo por número numa janela de 72 horas consecutivas e, depois de a ultrapassar, a API devolve 133016 e bloqueia o registo durante as 72 horas seguintes. Um ciclo de repetição que dispare a cada poucos segundos perante o 133015 pode esgotar essas dez tentativas antes de a eliminação sequer terminar.

- Repetir a chamada de registo a cada poucos segundos. Cada chamada conta para o limite de 10 por 72 horas.
- Confundir eliminação com anulação do registo. Anular o registo não elimina o número, e este código diz respeito à eliminação.
- Tentar eliminar o número através da API. A Meta só suporta a eliminação no WhatsApp Manager.

**Quanto tempo se deve esperar depois do erro 133015?** A Meta indica que se deve esperar 5 minutos antes de voltar a tentar o pedido de registo.

**Posso eliminar um número de telefone empresarial com a API?** Não. O guia de números de telefone da Meta indica que a eliminação só é possível no WhatsApp Manager.

**Porque é que não consigo eliminar o meu número?** A Meta bloqueia a eliminação de um número que enviou mensagens pagas nos últimos 30 dias. Pode eliminá-lo 30 dias depois da última.

**E se voltar a tentar demasiadas vezes?** Depois de 10 pedidos de registo em 72 horas, a API devolve 133016 e bloqueia o registo durante 72 horas.

---

## Erro 135000 do WhatsApp: erro desconhecido nos parâmetros do pedido

https://easycoexistence.com/pt-pt/docs/whatsapp-error-135000

O erro 135000 significa que uma mensagem não foi enviada devido a um erro desconhecido nos parâmetros do pedido. A descrição da Meta é "Falha no envio da mensagem devido a um erro desconhecido nos parâmetros do pedido." A orientação da Meta é consultar a referência do endpoint para confirmar a sintaxe correta e contactar o apoio ao cliente se o erro continuar a surgir.

### O que significa o erro 135000 do WhatsApp?

Significa que a plataforma não conseguiu enviar a mensagem, não soube indicar exatamente porquê e, mesmo assim, situou o problema nos parâmetros do pedido.

A referência da Meta atribui ao 135000 o texto de detalhes "Falha no envio da mensagem devido a um erro desconhecido nos parâmetros do pedido." A solução é consultar a referência do endpoint para determinar se a chamada usa a sintaxe correta, e contactar o apoio ao cliente se o código continuar a surgir.

Isto distingue-o do 131000, que a Meta descreve como um erro desconhecido sem apontar para os parâmetros, e cuja solução começa por voltar a tentar.

### Como se encontra o parâmetro errado?

Compare o corpo exato do pedido enviado com a referência do endpoint, campo a campo.

Registe o payload completo junto com o erro, porque o valor que o causa costuma variar de mensagem para mensagem: um número de telefone num formato inesperado, uma cadeia de caracteres vazia onde era esperado texto, ou um objeto aninhado com um campo no sítio errado. Depois leia o valor de details em error_data, que a Meta descreve como o motivo mais provável do erro.

Se um payload que falhou com 135000 passar a funcionar após uma alteração, guarde ambas as versões. A diferença é a resposta e indica o que validar antes de enviar da próxima vez.

### Quando contactar o apoio da Meta sobre o erro 135000?

Quando o pedido corresponde à referência e o código continua a surgir.

A Meta indica o apoio como passo seguinte para um 135000 persistente. Inclua o fbtrace_id da resposta de erro, que a Meta diz poder ajudar a depurar o erro, bem como a data e hora, o endpoint e o corpo do pedido sem credenciais.

Antes de abrir um pedido de apoio, confirme que o mesmo pedido falha de forma consistente. Um pedido que falha uma vez e, sem alterações, funciona um minuto depois aponta para a plataforma e não para os parâmetros, e a página de estado da Meta para a WhatsApp Business Platform é o local mais rápido para o confirmar.

- Repetir várias vezes o pedido idêntico. A Meta situa o problema nos parâmetros, pelo que o mesmo payload tende a falhar da mesma forma.
- Registar apenas o erro. Sem o corpo do pedido, não é possível encontrar o parâmetro em falta.
- Contactar o apoio sem o fbtrace_id. A Meta indica-o como o ID que ajuda a depurar o erro.

**O erro 135000 é o mesmo que o 131000?** Não. O 131000 é um erro desconhecido sem causa indicada. O 135000 é um erro desconhecido que a Meta atribui aos parâmetros do pedido.

**O erro 135000 é o mesmo que o erro 100?** Não. O erro 100 aponta parâmetros não suportados ou mal escritos. O 135000 indica que os parâmetros causaram um erro que a Meta não consegue identificar.

**Devo voltar a tentar depois de um 135000?** Não sem alterações. Verifique primeiro o pedido face à referência do endpoint.

**O que devo enviar ao apoio da Meta?** O fbtrace_id da resposta, o endpoint, a hora e o corpo do pedido sem credenciais.

---

## EasyCoexistence vs Z-API

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-z-api

A Z-API é uma API de WhatsApp brasileira, vendida por instância, que liga um número através da leitura de um código QR, tal como o WhatsApp Web associa um dispositivo. A EasyCoexistence liga o número à Cloud API oficial da Meta através da Coexistence, pelo que a app WhatsApp Business continua a funcionar e nada na ligação viola os termos do WhatsApp.

### Como cada um chega ao WhatsApp

Tudo o resto nesta página decorre desta diferença, por isso vem primeiro.

- Z-API:: A documentação refere que, tal como no WhatsApp Web, a ligação exige ler um código QR ou introduzir um número de telefone. O próprio site descreve a Cloud API oficial como um caminho distinto e apresenta-se como alternativa de mercado a ela.
- EasyCoexistence:: A Cloud API da Meta, com credenciais que a Meta emite para a conta WhatsApp Business do próprio negócio, ligada através do Embedded Signup da Meta. O número é registado como número de API e a app WhatsApp Business continua a funcionar no mesmo telemóvel.

### Quanto custa por número

Ambos cobram por número, o que faz desta uma das poucas comparações em que as unidades coincidem.

- Z-API:: 99,99 reais por instância por mês no plano Ultimate, ou 89,99 reais por instância no plano Partner, com um mínimo de dez instâncias, conforme publicado no site deles. O período de teste é de dois dias.
- EasyCoexistence:: US$ 9 por número ligado por mês de um a cinco números, descendo ao longo de seis escalões até US$ 1 cada à medida que adiciona números. Os primeiros três dias são gratuitos, e a Meta fatura os seus custos de mensagens diretamente ao negócio, sem qualquer margem adicional.

### O que acontece ao número se o WhatsApp atuar

Este é o risco que um preço por instância não mostra.

- Z-API:: Uma sessão de dispositivo associado não é uma via que os termos comerciais do WhatsApp autorizem para mensagens empresariais automatizadas, e uma conta acedida desse modo pode ser restringida ou banida.
- EasyCoexistence:: A ligação é uma funcionalidade da própria Meta, feita através do fluxo da própria Meta, por um Meta Tech Provider independente. Nada na forma como o número se liga pode ser alvo de medidas por parte do WhatsApp.

### Manter o telemóvel em uso

A maioria das pequenas empresas, com qualquer dos produtos, continua a responder aos clientes a partir do telemóvel, pelo que isto determina como decorre o dia.

- Z-API:: A instância é uma sessão associada no sentido do WhatsApp Web, pelo que dura apenas enquanto essa ligação se mantiver ativa. O site deles não menciona a funcionalidade Coexistence da Meta.
- EasyCoexistence:: A Coexistence é o produto inteiro. A equipa mantém a app WhatsApp Business, a API funciona no mesmo número e a ligação é monitorizada, para que uma quebra, como a regra dos 14 dias da Meta, seja assinalada logo que ocorra.

- Tratar uma instância ligada por QR e a Cloud API como o mesmo produto a preços diferentes. Chegam ao WhatsApp por vias diferentes.
- Usar o número principal de um negócio numa sessão de dispositivo associado. Um banimento leva consigo a presença do número no WhatsApp.
- Esquecer que a Cloud API cobra pelos templates. A Meta fatura-os ao negócio, fora de qualquer das subscrições.

**A Z-API é a API oficial do WhatsApp?** Não. O próprio site deles descreve a Cloud API oficial como o caminho através da Meta e a Z-API como uma alternativa de mercado, e a documentação refere que uma instância se liga como o WhatsApp Web.

**Algum dos dois é mais barato?** Sim, nós. A Z-API publica 99,99 reais por instância por mês. Nós cobramos US$ 9 por número ligado por mês até cinco números, descendo até US$ 1 à medida que adiciona números.

**Preciso de aprovação de templates convosco?** Apenas para mensagens que iniciam uma conversa fora da janela de 24 horas, que é a regra da Meta para todos os fornecedores oficiais. As respostas dentro da janela são em texto livre.

**Posso mudar um número da Z-API para a EasyCoexistence?** Sim. Desassocie a sessão, continue a usar a app WhatsApp Business e ligue o número através do Embedded Signup. Exige a versão 2.24.17 da app ou posterior e atividade real recente.

---

## EasyCoexistence vs Blip

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-blip

O Blip é uma plataforma conversacional brasileira para criar chatbots e prestar atendimento ao cliente no WhatsApp e noutros canais, com planos pagos cotados através da equipa comercial. A EasyCoexistence é a própria ligação ao WhatsApp, na Cloud API da Meta através da Coexistence, com uma tarifa publicada por número ligado e com a app WhatsApp Business a continuar a funcionar no telemóvel.

### O que é cada produto

Ambos usam a API oficial da Meta. Vendem coisas diferentes por cima dela.

- Blip:: Uma plataforma para criar bots com fluxos personalizados e processamento de linguagem natural, mais um posto de atendimento humano, no WhatsApp, Instagram, Messenger e outros canais. A página de preços afirma que são um Business Solution Provider oficial da Meta.
- EasyCoexistence:: A ligação entre um número que a empresa já usa na app WhatsApp Business e a Cloud API da Meta, mais a monitorização contínua dessa ligação. As mensagens seguem para o sistema que a empresa já utiliza: um CRM, o n8n, código próprio ou um agente de IA através de MCP.

### Quanto custa

A diferença está em poder ler o preço antes de falar com alguém.

- Blip:: Um plano gratuito até dois agentes, com conversas mensais limitadas. Os planos pagos não têm preço na página; o leitor é encaminhado para saber mais, pelo que o valor surge de uma conversa comercial.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, descendo para US$ 1 cada à medida que adiciona números, com os primeiros três dias grátis. A Meta fatura os custos de mensagens na conta da própria empresa e nada tem margem acrescentada.

### Se o telemóvel continua a funcionar

Para uma pequena empresa que responde a partir do telemóvel, esta costuma ser a primeira pergunta.

- Blip:: A página de preços não aborda a Coexistence. Pergunte-lhes se um número pode continuar na app WhatsApp Business enquanto está ligado, em vez de confiar nesta página.
- EasyCoexistence:: Sim, por conceção. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número, com o histórico recente de conversas sincronizado, enquanto a API corre em paralelo. O throughput num número com Coexistence é de 20 mensagens por segundo.

### Onde vive a lógica do bot

A automatização tem de correr em algum lado, e a escolha determina àquilo a que fica preso.

- Blip:: Dentro do Blip. Os fluxos, os bots e o atendimento humano são construídos e executados na plataforma deles, que é o produto que vendem.
- EasyCoexistence:: Onde já constrói. A Meta entrega os webhooks de mensagens diretamente no seu sistema, o conteúdo das conversas nunca é guardado do nosso lado, e um servidor MCP permite ao Claude, ChatGPT, Cursor ou Codex enviar mensagens a partir do número.

- Comparar o orçamento de uma plataforma de bots com uma tarifa de ligação linha a linha. Um inclui o construtor e o atendimento humano.
- Presumir que qualquer parceiro da Meta mantém a app WhatsApp Business a funcionar. A Coexistence tem de ser suportada e ativada.
- Esquecer os custos de mensagens da própria Meta. São faturados pela Meta em qualquer dos produtos.

**O Blip publica os seus preços?** Apenas o plano gratuito, até dois agentes com conversas limitadas. Os planos pagos não têm preço na página de preços deles.

**Algum dos dois é mais barato?** O nosso está publicado e o deles não, por isso o nosso é o que pode confirmar: US$ 9 por número ligado por mês, descendo para US$ 1 à medida que adiciona números, sem limites de agentes.

**Posso criar um chatbot com a EasyCoexistence?** Sim, na ferramenta que já utiliza. As mensagens chegam ao seu webhook, ao n8n, ao Make ou a um agente de IA através de MCP, e a lógica fica aí.

**A EasyCoexistence é um produto da Meta?** Não. Somos um Tech Provider independente da Meta, que utiliza o Embedded Signup e a Cloud API oficiais da Meta.

---

## EasyCoexistence vs Digisac

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-digisac

O Digisac é uma plataforma brasileira de atendimento multicanal, com preço por proposta personalizada a partir de 197 reais por mês, que opera a API oficial do WhatsApp através da Gupshup e da 360dialog e suporta a Coexistence por intermédio delas. A EasyCoexistence é um Meta Tech Provider que liga o próprio número, por um valor publicado por número, sem plataforma pelo meio.

### Como se define o preço

Um é uma proposta e o outro é uma tabela, e isso condiciona tudo o que vem depois.

- Digisac:: Sem planos fixos. A própria página indica que o preço inicial é de 197 reais e que varia com o número de agentes, canais, funcionalidades como módulos de IA e integrações, reunidos numa proposta elaborada pela equipa comercial.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, a descer em seis escalões até US$ 1 por número à medida que adiciona números. Sem agentes para contar nem módulos para acrescentar. Primeiros três dias grátis.

### Quem está entre si e a Meta

A cadeia de empresas por trás de um número determina quem o pode reparar quando falha.

- Digisac:: A plataforma opera a API através da Gupshup e da 360dialog, que são parceiros da Meta. O artigo sobre Coexistence refere que a ativação é feita com um fornecedor oficial, como a 360dialog, e que o Digisac acompanha o cliente nesse processo.
- EasyCoexistence:: Ninguém. Somos um Meta Tech Provider independente, a empresa regista-se através do Embedded Signup da própria Meta, na sua conta WhatsApp Business, e os webhooks da Meta seguem diretamente para o sistema da empresa.

### Onde trabalha a equipa

Uma plataforma de atendimento e uma ligação alteram coisas diferentes no dia de trabalho.

- Digisac:: Uma plataforma de atendimento partilhada que centraliza WhatsApp, Instagram, Telegram, Messenger, email e webchat, com distribuição de conversas, chat interno e funil de vendas. A equipa trabalha dentro dela.
- EasyCoexistence:: Nada de novo para iniciar sessão. A equipa mantém a app WhatsApp Business, e automatizações, um CRM ou um agente de IA atuam sobre o mesmo número através da API.

### Quanto tempo até o número funcionar

As pequenas empresas decidem muitas vezes só com base nisto.

- Digisac:: Primeiro uma proposta comercial, depois a ativação com o fornecedor. A página do Digisac inclui um CNPJ, um Meta Business Manager e o cumprimento das políticas entre os pré-requisitos.
- EasyCoexistence:: Normalmente em menos de dois minutos através do Embedded Signup: inicie sessão com o Facebook, indique o número e leia um código QR na app. A monitorização começa assim que o número se liga.

- Comparar o preço inicial do Digisac com um valor por número. O deles cresce com agentes, canais e módulos.
- Presumir que a Coexistence é uma funcionalidade da plataforma. É da Meta, ativada através de um fornecedor do lado da Meta.
- Deixar os custos da Meta fora do orçamento. São faturados pela Meta em qualquer das opções.

**O Digisac suporta a Coexistence?** Sim. O próprio artigo indica que é ativada com um fornecedor oficial, como a 360dialog, e que o Digisac acompanha o processo.

**Algum dos dois é mais barato?** Para um único número, somos nós: US$ 9 por mês contra um preço inicial de 197 reais que sobe com agentes, canais e módulos. O nosso desce à medida que se juntam números.

**Perco a caixa de entrada partilhada?** Não a vendemos. A equipa mantém a app WhatsApp Business, e tudo o resto funciona na ferramenta que escolher.

**Quem paga à Meta?** A empresa, diretamente, na sua conta WhatsApp Business. Nunca aplicamos margem sobre um custo da Meta.

---

## EasyCoexistence vs Octadesk

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-octadesk

O Octadesk é uma plataforma brasileira de atendimento ao cliente que combina chatbot, agentes de IA e helpdesk, com planos a partir de 2.499 reais por mês por 3.000 conversas, mais uma consultoria de onboarding obrigatória. A EasyCoexistence liga o número que já está na app WhatsApp Business à Cloud API da Meta através da Coexistência, com uma tarifa publicada por número, sem limite de conversas e sem setup.

### Para que serve a fatura mensal

As unidades são diferentes, e essa diferença cresce com cada cliente que escreve.

- Octadesk:: Um plano dimensionado por conversas: One a 2.499 reais por mês por 3.000, Flow a 4.399 reais por 5.500, Nexus sob consulta por 9.000. Os utilizadores de helpdesk são cobrados à parte, por utilizador, e todos os planos exigem uma consultoria de onboarding com preço sob consulta.
- EasyCoexistence:: Uma tarifa por número ligado: US$ 9 por mês de um a cinco números, a descer até US$ 1 cada à medida que se adicionam números. Um mês com dez mil conversas custa o mesmo que um mês calmo. A Meta cobra diretamente as suas próprias tarifas de mensagens.

### O que é cada um

Ambos colocam o número na API oficial. O que se constrói por cima é diferente.

- Octadesk:: Um ecossistema de atendimento: chatbot, agentes de IA, helpdesk com SLAs e histórico de tickets, e envio em massa por WhatsApp, com um número da API oficial do WhatsApp incluído em cada plano.
- EasyCoexistence:: A ligação e a sua monitorização. O número fica na app WhatsApp Business, a API funciona nele em simultâneo, e as mensagens chegam às ferramentas que a empresa já usa, incluindo agentes de IA através do nosso servidor MCP.

### Adicionar um segundo ou um décimo número

As agências e as empresas com várias filiais fazem esta pergunta antes de qualquer outra.

- Octadesk:: Cada plano indica um número da API oficial do WhatsApp como incluído. A página de preços do Octadesk não publica um preço para números adicionais.
- EasyCoexistence:: Números ilimitados por conta, cada um ao preço do escalão, e a tarifa por número desce à medida que a quantidade sobe: US$ 7 a partir de seis números, até US$ 1 à medida que se adicionam números.

### Se o telemóvel continua a funcionar

A pergunta que decide se uma equipa pequena tem de mudar a forma de trabalhar.

- Octadesk:: A página de preços do Octadesk não aborda a Coexistência. Confirme com eles se o número pode ficar na app WhatsApp Business depois de estar na API deles.
- EasyCoexistence:: Pode. A Coexistência é tudo o que ligamos: a app mantém as conversas, cerca de seis meses de histórico podem sincronizar, e a API funciona no mesmo número. A ligação é vigiada, para que uma falha seja assinalada de imediato.

- Comparar preços de planos sem contar as conversas. Os planos do Octadesk limitam-nas; uma tarifa de ligação não.
- Orçamentar sem a consultoria de onboarding. O Octadesk exige-a em todos os planos e o preço é sob consulta.
- Esperar que o plano cubra os custos de templates da Meta. A Meta cobra-os diretamente à empresa.

**Algum é mais barato?** Sim, por larga margem para uma empresa que precisa da ligação. O Octadesk começa em 2.499 reais por mês mais onboarding; nós cobramos US$ 9 por número ligado por mês.

**O que acontece depois de 3.000 conversas?** No plano One do Octadesk, passa-se para um plano superior. Connosco nada muda: não há limite de conversas a nenhum preço.

**O Octadesk suporta a Coexistência?** A página de preços deles não o diz. Pergunte-lhes em vez de confiar nesta página.

**Posso continuar a usar IA com a EasyCoexistence?** Sim. O nosso servidor MCP permite ao Claude, ChatGPT, Cursor, Claude Code e Codex enviar mensagens e templates no número.

---

## EasyCoexistence vs Huggy

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-huggy

O Huggy é uma caixa de entrada brasileira de atendimento omnicanal, com preço por plano e por utilizador ligado, e o WhatsApp cobrado à parte por quantidade e categoria. A EasyCoexistence é a própria ligação ao WhatsApp: a Cloud API da Meta no número que já está na app WhatsApp Business, através da Coexistence, com uma tarifa publicada por número ligado.

### Para que serve a fatura mensal

A fatura do Huggy cresce com a equipa. A nossa só cresce com os números.

- Huggy:: Um plano com um utilizador ligado e depois uma tarifa por cada utilizador extra: 69,90 reais no Starter, 119,90 reais no Intermediate, a partir de 579 reais por mês, e 189,90 reais no Custom, a partir de 989 reais. O WhatsApp é cobrado por cima, por quantidade e categoria, e a implementação é opcional, por 1.250 reais.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, a descer até US$ 1 cada à medida que adiciona números, sem qualquer contagem de utilizadores. Os primeiros três dias são gratuitos e a Meta fatura os custos de mensagens diretamente à empresa.

### O que é cada produto

Compra-se uma caixa de entrada e uma ligação por razões diferentes.

- Huggy:: Uma caixa de entrada de atendimento que centraliza WhatsApp, Instagram, Messenger, Telegram, email, SMS e voz, com chatbots e relatórios. A página deles diz que são parceiros oficiais da Meta para ativar a API oficial.
- EasyCoexistence:: A ligação entre o número da app WhatsApp Business e a Cloud API da Meta, monitorizada de forma contínua. As mensagens seguem para o sistema que a empresa já utiliza, através dos webhooks da Meta ou do nosso servidor MCP.

### Se a equipa muda a forma de trabalhar

A pergunta do dono antes de aceitar seja o que for.

- Huggy:: Os agentes entram na caixa de entrada do Huggy, onde as conversas de todos os canais são atribuídas e respondidas. A página de preços deles não menciona a Coexistence com a app WhatsApp Business.
- EasyCoexistence:: Ninguém muda de sítio. A app WhatsApp Business continua a funcionar no mesmo número, com as suas conversas, e a API funciona em paralelo para tudo o que a empresa automatize.

### Onde ficam guardadas as conversas

Uma decisão difícil de reverter mais tarde.

- Huggy:: Na plataforma deles, algo de que uma caixa de entrada precisa para mostrar as conversas aos agentes que as abrem.
- EasyCoexistence:: Não do nosso lado. O conteúdo das conversas nunca é guardado e a Meta pode encaminhar as mensagens recebidas diretamente para o webhook da própria empresa.

- Calcular o preço do Huggy sem a linha do WhatsApp. É cobrado à parte do plano, por quantidade e categoria.
- Contar apenas a equipa de hoje. Cada utilizador extra acrescenta uma tarifa mensal num plano de caixa de entrada.
- Comprar uma caixa de entrada para obter acesso à API num único número. Para isso basta a ligação.

**Qual é mais barato?** Para uma empresa que precisa da ligação, somos nós. O plano Intermediate do Huggy começa nos 579 reais por mês para um utilizador, antes do WhatsApp; o nosso custa US$ 9 por número ligado por mês.

**O Huggy usa a API oficial?** A página de preços deles diz que são parceiros oficiais da Meta e que ativam a API oficial da Meta.

**O Huggy suporta a Coexistence?** A página de preços deles não o menciona. Pergunte-lhes diretamente, em vez de confiar nesta página.

**Têm uma caixa de entrada?** Não. A equipa continua a usar a app WhatsApp Business, que é para isso que serve a Coexistence.

---

## EasyCoexistence vs Umbler Talk

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-umbler-talk

O Umbler Talk é uma caixa de entrada de WhatsApp, CRM e chatbot brasileiro na API oficial, com preço por agente a partir de 99,90 reais por mês e um mínimo de dois agentes. A EasyCoexistence liga o número que já está na app WhatsApp Business à Cloud API da Meta através da Coexistência, com preço por número ligado, pelo que a fatura nunca depende de quantas pessoas respondem.

### Para que serve a fatura mensal

O Umbler Talk conta pessoas. A EasyCoexistence conta números.

- Umbler Talk:: Por agente por mês: 99,90 reais no Essencial com pelo menos dois agentes, 149,90 reais no Impulso e 219,90 reais no Escala com pelo menos três. A fatura mínima possível são dois agentes no Essencial, 199,80 reais por mês.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, a descer por seis escalões até US$ 1 cada à medida que se adicionam números. Sem contagem de agentes e sem mínimo. Primeiros três dias grátis, e a Meta fatura as mensagens diretamente.

### O que é cada produto

Ambos funcionam na API oficial da Meta, o que o Umbler Talk afirma com clareza na sua página.

- Umbler Talk:: Uma caixa de entrada partilhada com funil de CRM visual, chatbot, agentes de IA, base de conhecimento e webchat, mais campanhas de WhatsApp nos planos superiores. A equipa trabalha lá dentro.
- EasyCoexistence:: A ligação e a sua monitorização. O número fica na app WhatsApp Business, a API funciona sobre ele ao mesmo tempo, e as mensagens chegam ao seu CRM, ao n8n, ao seu próprio código ou a um agente de IA através de MCP.

### Quantos números cabem

Para agências e negócios com várias filiais, o limite de números pesa mais do que o nome do plano.

- Umbler Talk:: Dois números de WhatsApp no Essencial e até três no Impulso, com o Escala descrito como limite dinâmico de números. Mais números significa um plano superior para todos os agentes.
- EasyCoexistence:: Números ilimitados por conta, cada um ao preço do escalão, e o preço por número desce à medida que a quantidade sobe. O vigésimo número custa menos do que o primeiro.

### Se a app WhatsApp Business continua a funcionar

A pergunta que uma equipa pequena faz antes de tudo.

- Umbler Talk:: A página de planos não menciona a Coexistência. Pergunte-lhes se um número continua a funcionar na app WhatsApp Business depois de ligado.
- EasyCoexistence:: Sim. A Coexistência é a única coisa que ligamos, pelo que a app mantém as conversas e a API funciona a par dela, com a ligação vigiada contra quedas, como a regra dos 14 dias da Meta.

- Ler o preço por agente como se fosse a fatura. O mínimo são dois agentes, e mais nos planos superiores.
- Escolher um plano pelo limite de números e acabar a pagar a tarifa superior por cada agente.
- Deixar de fora do orçamento os custos de templates da Meta. A Meta fatura-os diretamente à empresa.

**Algum é mais barato?** Sim, nós. A fatura mínima do Umbler Talk são dois agentes a 99,90 reais cada, 199,80 reais por mês; a nossa é de US$ 9 por número ligado, seja quem for que lhe responda.

**O Umbler Talk usa a API oficial do WhatsApp?** Sim. A página deles indica que o Umbler Talk usa a API oficial do WhatsApp e cumpre as diretrizes da plataforma.

**O Umbler Talk suporta a Coexistência?** A página de planos não a menciona. Pergunte-lhes em vez de confiar nesta página.

**A EasyCoexistence cobra por agente?** Não. A tarifa é por número ligado, independentemente de quantas pessoas respondem nele ou trabalham com ele através da API.

---

## EasyCoexistence vs Whaticket

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-whaticket

O Whaticket é uma caixa de entrada multiagente para WhatsApp e outros canais, a partir de US$ 49 por mês, com o mínimo de três utilizadores e uma linha de WhatsApp, ligada por QR code ou pela API oficial com Coexistence. A EasyCoexistence é apenas a ligação oficial: a Cloud API da Meta no número da app WhatsApp Business, a US$ 9 por número.

### Como cada uma liga o número

O Whaticket vende dois caminhos para o WhatsApp. A EasyCoexistence vende um.

- Whaticket:: Uma escolha entre WhatsApp QR, uma sessão lida como no WhatsApp Web, ou WhatsApp API com Coexistence. O próprio site avisa que o envio em massa com o WhatsApp Business pode provocar bloqueios e recomenda a API para reduzir esse risco.
- EasyCoexistence:: Apenas a Cloud API da Meta, ligada através do Embedded Signup da Meta com Coexistence, pelo que a app WhatsApp Business continua a funcionar no mesmo número. Não existe a opção de sessão por QR code, por isso não há uma via não oficial como alternativa.

### Para que serve a fatura mensal

As duas faturas são compostas por partes diferentes.

- Whaticket:: US$ 49 por mês no Basic, com três utilizadores e uma linha, US$ 20 por mês por cada linha adicional, e o plano Pro a US$ 109. As campanhas numa ligação por QR code consomem créditos, a partir de US$ 25 por 1 000 mensagens; as campanhas por API estão isentas.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, descendo para US$ 1 cada um à medida que adiciona números. Sem utilizadores, sem créditos. A Meta cobra os custos de mensagens diretamente à empresa, sem qualquer margem. Os primeiros três dias são gratuitos.

### O que é cada produto

Um é onde os agentes trabalham. O outro é a canalização por baixo.

- Whaticket:: Uma caixa de entrada multiagente que centraliza e automatiza canais de mensagens, com campanhas, para que a equipa responda dentro da sua plataforma.
- EasyCoexistence:: A ligação mais a monitorização 24/7. A equipa mantém a app WhatsApp Business, as mensagens chegam ao seu próprio webhook e os agentes de IA atuam no número através do nosso servidor MCP.

### Quanto custa um segundo, quinto ou décimo número

As agências e as empresas com várias filiais fazem esta conta antes de tudo o resto.

- Whaticket:: US$ 20 por linha extra, além do plano, pelo que cinco linhas no Basic somam US$ 129 por mês para três utilizadores.
- EasyCoexistence:: Cinco números somam US$ 45 por mês, e o preço por número continua a descer: US$ 7 cada a partir de seis, até US$ 1 à medida que adiciona números.

- Usar um número da empresa na ligação por QR code. O próprio site do Whaticket avisa que o envio em massa aí pode provocar bloqueios.
- Esquecer os créditos de mensagens. As campanhas numa ligação por QR code são cobradas por cada mil mensagens, além do plano.
- Calcular as linhas extra ao preço do plano. Cada uma acrescenta US$ 20 por mês.

**Alguma das duas é mais barata?** Sim, a EasyCoexistence. Uma linha no Whaticket Basic custa US$ 49 por mês; um número ligado connosco custa US$ 9. Com cinco números, são US$ 129 contra US$ 45.

**O Whaticket suporta Coexistence?** Sim. A página de preços indica o WhatsApp API com Coexistence como opção de ligação, a par da ligação por QR code.

**A ligação por QR code é oficial?** Não. Associa uma sessão da mesma forma que o WhatsApp Web. O próprio site do Whaticket recomenda a API para reduzir o risco de bloqueios.

**Têm uma caixa de entrada como a do Whaticket?** Não. A equipa mantém a app WhatsApp Business e tudo o que automatizar corre nas suas próprias ferramentas.

---

## EasyCoexistence vs Leadsales

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-leadsales

A Leadsales é um CRM conversacional mexicano para vender por WhatsApp, Facebook e Instagram. O plano Basic, a US$ 97 por mês, liga o WhatsApp através da sessão web, e a API oficial começa no plano Professional, a US$ 133. A EasyCoexistence liga o número à Cloud API da Meta através da Coexistence, por US$ 9 por número.

### Que plano chega oficialmente ao WhatsApp

Na Leadsales, o método de ligação depende do plano. Na EasyCoexistence, não depende.

- Leadsales:: O Basic liga o WhatsApp através do Messenger e da sessão web, não da Business API. O Professional, a US$ 133 ou MX$ 3.239,88 por mês, e o Advanced, a US$ 247, usam a API oficial.
- EasyCoexistence:: Todos os números estão na Cloud API da Meta, ligados através do Embedded Signup da própria Meta com Coexistence, pelo que a app WhatsApp Business continua a funcionar no telemóvel. Não existe um nível não oficial mais barato.

### Para que serve a fatura mensal

A Leadsales limita utilizadores e conversas por plano. A EasyCoexistence não limita nenhum dos dois.

- Leadsales:: O Basic inclui 3 utilizadores e 5 000 conversas ativas, o Professional 4 utilizadores e 20 000, o Advanced 5 utilizadores e 50 000, com descontos até 20% na faturação anual.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, descendo até US$ 1 cada à medida que se acrescentam números. Sem contagem de utilizadores, sem contagem de conversas, três primeiros dias gratuitos, e a Meta fatura as mensagens diretamente à empresa.

### O que é cada produto

Um CRM e uma ligação resolvem problemas diferentes.

- Leadsales:: Um CRM de vendas com funis, espaço de trabalho partilhado, envio em massa por etapa e um agente de IA nos planos superiores. Os leads são trabalhados dentro da Leadsales.
- EasyCoexistence:: A ligação e a sua monitorização. As mensagens chegam ao CRM ou à ferramenta que a empresa já utiliza através dos webhooks da Meta, e os agentes de IA atuam sobre o número através do nosso servidor MCP.

### O que acontece a um número na sessão web

O risco que o plano mais barato acarreta.

- Leadsales:: Um número no plano Basic chega ao WhatsApp através de uma sessão web e não da Business API, um caminho que os termos comerciais do WhatsApp não autorizam para mensagens empresariais automatizadas.
- EasyCoexistence:: Nada na ligação pode ser alvo de sanção, porque é a funcionalidade Coexistence da própria Meta, feita através do fluxo da própria Meta, e a ligação é monitorizada 24 horas por dia.

- Escolher o plano Basic pelo preço e presumir que usa a API. Liga-se através da sessão web.
- Contar os utilizadores e esquecer o limite de conversas ativas. Cada plano define um.
- Esperar que o plano inclua os custos de templates da Meta. A Meta fatura-os diretamente à empresa.

**Qual é mais barato?** A EasyCoexistence. O plano mais barato da Leadsales com a API oficial custa US$ 133 por mês; um número ligado connosco custa US$ 9.

**A Leadsales usa a API oficial do WhatsApp?** No Professional e no Advanced, sim. O plano Basic liga o WhatsApp através do Messenger e da sessão web.

**A Leadsales suporta Coexistence?** A página de preços indica que, em alguns casos, o número continua utilizável no telemóvel e, noutros, passa totalmente para a API. Connosco, o número fica sempre na app WhatsApp Business.

**Posso manter o meu CRM e usar a EasyCoexistence?** Sim. A Meta entrega as mensagens ao webhook que escolher, por isso qualquer CRM que aceite webhooks pode recebê-las.

---

## EasyCoexistence vs Treble

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-treble

A Treble é uma plataforma latino-americana da API do WhatsApp Business para fluxos automatizados, campanhas e atendimento com IA, vendida através da sua equipa comercial, sem preço público. A EasyCoexistence liga à Cloud API da Meta, através da Coexistence, o número que a empresa já usa na app WhatsApp Business, em autoatendimento e por um preço publicado de US$ 9 por número ligado por mês.

### O que acontece à app WhatsApp Business

Os dois produtos partem de pressupostos opostos quanto ao telemóvel.

- Treble:: Na página inicial, a Treble descreve-se como uma solução baseada na API do WhatsApp Business, e não na app gratuita WhatsApp Business. Não menciona a Coexistence, por isso pergunte-lhes se um número pode continuar na app.
- EasyCoexistence:: A app mantém-se. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número, com cerca de seis meses de histórico de conversas sincronizado, enquanto a Cloud API funciona em paralelo para a automação.

### Quanto custa

Um preço pode ser consultado hoje. O outro exige uma conversa.

- Treble:: Sem preços públicos. A página inicial não mostra preço e a página de preços pede uma palavra-passe, pelo que o valor vem da equipa comercial deles.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, descendo em seis escalões até US$ 1 cada à medida que adiciona números. A Meta fatura as mensagens diretamente à empresa e nada é acrescido de margem.

### O que é cada produto

Ambos assentam na API oficial da Meta. Vendem camadas diferentes.

- Treble:: Uma plataforma de fluxos de conversa automatizados, campanhas em massa e atendimento com IA, com integrações nativas com HubSpot e Salesforce e uma API para ligações personalizadas.
- EasyCoexistence:: A ligação e a sua monitorização 24/7. A Meta entrega os webhooks diretamente ao seu sistema, o conteúdo das conversas nunca é guardado do nosso lado e um servidor MCP permite que agentes de IA enviem mensagens a partir do número.

### Quanto tempo até um número estar ativo

Muitas vezes é a pergunta decisiva para uma pequena empresa.

- Treble:: Através de um processo comercial, uma vez que os planos e os preços são acordados com a equipa deles antes da integração.
- EasyCoexistence:: Normalmente menos de dois minutos através do Embedded Signup da Meta: inicie sessão com o Facebook, introduza o número e leia um código QR na app. Os requisitos são a versão 2.24.17 da app ou posterior e atividade real recente.

- Passar um número de app com muito movimento para uma configuração só com API sem verificar a Coexistence. O telemóvel deixa de ser o local onde a equipa responde.
- Comparar o orçamento de uma plataforma de campanhas com o custo de uma ligação. Um inclui fluxos e campanhas.
- Deixar de fora os custos dos templates da Meta. São faturados pela Meta, não por nenhum dos fornecedores.

**A Treble publica preços?** Não. A página inicial não mostra nenhum e a página de preços está protegida por palavra-passe.

**Algum dos dois é mais barato?** O nosso preço está publicado e o deles não, pelo que o nosso é o que pode verificar: US$ 9 por número ligado por mês, descendo até US$ 1 à medida que adiciona números.

**A Treble suporta a Coexistence?** A página inicial não a menciona e descreve a Treble como baseada na API, e não na app WhatsApp Business. Pergunte-lhes.

**Posso fazer campanhas com a EasyCoexistence?** Sim, através da Cloud API com templates aprovados, a partir do seu próprio sistema ou ferramenta. A Meta fatura-lhe os templates diretamente.

---

## EasyCoexistence vs Botmaker

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-botmaker

A Botmaker é uma plataforma latino-americana de chatbot e atendimento ao cliente sobre a WhatsApp Business Platform, a partir de US$ 149 por mês para 3.000 conversas, mais uma taxa única de US$ 99 para abrir a conta WhatsApp. Suporta Coexistence. A EasyCoexistence é apenas a ligação Coexistence, a US$ 9 por número ligado por mês, sem pacotes de conversas.

### Pelo que se paga a fatura mensal

A Botmaker vende conversas. A EasyCoexistence vende a ligação.

- Botmaker:: Standard a US$ 149 por 3.000 conversas, Scale a US$ 249 por 5.000, Pro a US$ 499 por 10.000, com US$ 0,07 a US$ 0,05 por conversa adicional e US$ 99 para abrir a conta WhatsApp. As mensagens iniciadas pela empresa levam o custo do WhatsApp mais uma taxa de serviço de 20%.
- EasyCoexistence:: US$ 9 por número ligado por mês, de um a cinco números, descendo até US$ 1 cada à medida que acrescenta números. Sem pacote, sem excedente, sem taxa de arranque. A Meta fatura os seus custos diretamente à empresa e nós nunca os majoramos.

### Como funciona a Coexistence em cada uma

Ambas mantêm a app WhatsApp Business a funcionar no número. O resto da configuração é diferente.

- Botmaker:: O centro de ajuda da Botmaker indica que a Coexistence só está disponível para linhas novas ou novas configurações, que o bot fica em pausa quando alguém responde a partir do telemóvel e que as conversas de grupo não são suportadas na plataforma.
- EasyCoexistence:: A Coexistence é o produto: autónoma, através do Embedded Signup da Meta, em cerca de dois minutos, seguida de monitorização 24/7, de modo que uma queda, como a regra de 14 dias da Meta, é sinalizada no momento em que acontece.

### O que é cada produto

Uma plataforma de bots e uma ligação são compras diferentes.

- Botmaker:: Uma plataforma para criar bots e gerir o atendimento por agentes no WhatsApp, com dez a cinquenta postos de agente incluídos, consoante o plano. Os fluxos ficam dentro da Botmaker.
- EasyCoexistence:: A ligação. Os webhooks da Meta chegam ao seu próprio sistema, o conteúdo das conversas nunca é guardado do nosso lado e um servidor MCP permite que Claude, ChatGPT, Cursor, Claude Code ou Codex atuem sobre o número.

### O que o crescimento faz à fatura

Os dois modelos evoluem em sentidos opostos à medida que a empresa tem mais movimento.

- Botmaker:: Mais conversas significam excedente por conversa ou passagem ao plano seguinte, pelo que um mês movimentado custa mais do que um mês calmo.
- EasyCoexistence:: O volume de mensagens não entra no preço. Só a adição de números altera a fatura, e o valor por número desce à medida que são adicionados.

- Comparar os preços dos planos e esquecer a taxa de abertura de conta de US$ 99 e a taxa de serviço de 20% nas mensagens iniciadas pela empresa.
- Dimensionar um plano com base nas conversas de hoje. O excedente é cobrado por cada conversa acima do pacote.
- Esperar que uma resposta dada no telemóvel deixe o bot a funcionar. Na Botmaker, o bot fica em pausa quando o telemóvel responde.

**A Botmaker suporta Coexistence?** Sim. O centro de ajuda documenta-a, disponível para linhas novas ou novas configurações.

**Qual é mais barata?** A EasyCoexistence. A Botmaker começa em US$ 149 por mês, mais US$ 99 para abrir a conta; um número ligado connosco custa US$ 9 por mês, sem nada a pagar para começar.

**Acrescentam alguma taxa aos custos da Meta?** Não. A Meta fatura as mensagens na conta da própria empresa e nós nunca as majoramos.

**Posso criar um bot com a EasyCoexistence?** Sim, no n8n, no Make, em código próprio ou com um agente de IA através do MCP. As mensagens chegam ao seu sistema através dos webhooks da Meta.

---

## EasyCoexistence vs Gallabox

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-gallabox

O Gallabox e a EasyCoexistence resolvem problemas diferentes. O Gallabox é uma caixa de entrada para equipas e um conjunto de automação sobre a API oficial do WhatsApp Business, vendido em planos com um número fixo de utilizadores. A EasyCoexistence é a própria ligação: a Cloud API da Meta no mesmo número da app WhatsApp Business, com preço por número, sem caixa de entrada e sem licenças de utilizador.

### O que paga a fatura mensal

Os dois têm preços assentes em unidades diferentes, e é a unidade que determina como a fatura cresce.

- Gallabox:: Planos com preço mensal e dimensão de equipa fixa. O Basic custa ₹ 2,999 por mês, faturados trimestralmente, para 3 utilizadores, descritos na página como limite máximo, e as equipas maiores passam para o Essential ou o Advanced.
- EasyCoexistence:: A partir de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que se adicionam números. Não há contagem de utilizadores nem de contactos, pelo que contratar alguém ou responder a mais clientes não altera a fatura.

### Como se ativa a Coexistence

Ambos usam a funcionalidade Coexistence da Meta, pelo que a app WhatsApp Business continua a funcionar no telemóvel. O caminho até lá é que difere.

- Gallabox:: A documentação indica que a Coexistence não está ativada por predefinição e que é preciso contactar o apoio do Gallabox antes de começar, para que o espaço de trabalho seja ativado primeiro.
- EasyCoexistence:: A Coexistence é o produto. O responsável do negócio conclui o Embedded Signup da Meta em cerca de dois minutos, em autoatendimento, com a app na versão 2.24.17 ou posterior e o número não associado a outro fornecedor.

### Onde ficam guardadas as conversas

Esta é a diferença que mais importa a quem constrói a sua própria interface ou gere números de clientes.

- Gallabox:: Dentro da plataforma deles. Uma caixa de entrada partilhada, um construtor de chatbot e uma ferramenta de difusão precisam de ter as mensagens guardadas do seu lado para as mostrar aos agentes.
- EasyCoexistence:: Connosco não. A Meta encaminha os webhooks diretamente para o endpoint que indicar, e as conversas nunca são guardadas do nosso lado. O seu CRM, a sua aplicação ou o seu agente de IA é o destino dos dados.

### Qual escolher

Se a compra é uma caixa de entrada de equipa com chatbots e campanhas, o Gallabox é esse tipo de produto, e é uma compra diferente de uma ligação.

Se a compra é o próprio número, ligado oficialmente e mantido ativo, a EasyCoexistence é a opção mais restrita e mais barata. Serve a agência que integra números de clientes na sua própria infraestrutura, o programador que já tem uma interface ou o responsável que quer automação sem tirar a equipa do telemóvel. A ligação é monitorizada, incluindo a regra dos 14 dias da Meta, e a Meta fatura as mensagens diretamente à sua conta, sem margem nossa.

- Comparar diretamente os preços dos planos. Um inclui caixa de entrada e créditos de IA; o outro é apenas a ligação.
- Iniciar o processo de registo da Coexistence antes de o fornecedor a ter ativado e voltar a tentar repetidamente o mesmo número.
- Comprar uma caixa de entrada com limite de utilizadores para números cujas mensagens vão ser tratadas pelo seu próprio software.

**A EasyCoexistence é mais barata do que o Gallabox?** Quanto à ligação, sim. O Gallabox Basic custa ₹ 2,999 por mês, faturados trimestralmente, para 3 utilizadores. A EasyCoexistence custa US$ 9 por número ligado por mês, sem limite de utilizadores, pelo que um número com uma equipa de qualquer dimensão custa US$ 9.

**O Gallabox suporta a Coexistence?** Sim. A documentação descreve-a e indica que o apoio ao cliente tem de a ativar no seu espaço de trabalho antes da configuração.

**A EasyCoexistence tem uma caixa de entrada como o Gallabox?** Não. A equipa mantém a app WhatsApp Business, e o software recebe as mesmas mensagens através de webhooks entregues pela Meta ao seu próprio sistema.

**Quem paga as tarifas de mensagens da Meta?** Com a EasyCoexistence, paga o próprio cliente, diretamente à Meta, na sua conta WhatsApp Business, sem qualquer acréscimo nosso.

---

## EasyCoexistence vs TimelinesAI

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-timelinesai

A TimelinesAI é uma caixa de entrada WhatsApp partilhada, sincronizada com CRMs e cobrada por utilizador, que liga um número por QR code, pela API oficial do WhatsApp Business ou por Coexistence. A EasyCoexistence liga números apenas pela Cloud API da Meta com Coexistence, cobra por número e envia cada mensagem para o seu próprio sistema, em vez de uma caixa de entrada.

### Como cada uma liga o número

O método de ligação determina a que fica exposto o número, por isso vem em primeiro lugar.

- TimelinesAI:: Três opções em todos os planos: uma ligação por QR code, que associa o número como dispositivo associado, a API oficial do WhatsApp Business, ou a Coexistence, que faz funcionar a app e a API em conjunto.
- EasyCoexistence:: Um só método: a Cloud API da Meta com Coexistence, através do Embedded Signup da própria Meta. Não existe opção de sessão QR, pelo que nenhum número ligado através de nós depende de uma ligação de dispositivo associado que tenha de se manter ativa.

### O que paga a fatura mensal

Por utilizador e por número crescem por razões diferentes.

- TimelinesAI:: $35 por utilizador por mês no Starter, ou $28 com faturação anual, e $49 por utilizador no Pro. A página de preços indica que é necessário um lugar para cada utilizador que ligue uma conta WhatsApp.
- EasyCoexistence:: A partir de US$ 9 por número ligado por mês até cinco números, baixando para US$ 1 à medida que adiciona números. As pessoas não são contadas de todo, e a Meta cobra-lhe diretamente as tarifas das mensagens.

### Onde ficam as conversas

Uma caixa de entrada e uma ligação colocam os dados em locais diferentes.

- TimelinesAI:: Na caixa de entrada partilhada, sincronizada depois com o CRM que escolher. A caixa de entrada é o produto, por isso as mensagens passam e são apresentadas na plataforma deles.
- EasyCoexistence:: Diretamente para o seu endpoint. A Meta entrega os webhooks no URL que indicar e as conversas nunca são guardadas do nosso lado, o que mantém os dados de um cliente dentro de sistemas que controla.

### Qual escolher

Uma equipa comercial que quer uma caixa de entrada partilhada dentro do seu CRM procura uma caixa de entrada, e a TimelinesAI é uma.

Uma empresa que quer o número ligado de forma oficial, sem nenhuma sessão QR no percurso e sem nada guardado por um intermediário, procura uma ligação. A EasyCoexistence é essa ligação, com monitorização do estado que lê os motivos de desligação da própria Meta, um servidor MCP para assistentes de IA e uma tarifa fixa por número, independentemente do tamanho da equipa.

- Associar um número empresarial por QR code porque é mais rápido. Uma sessão de dispositivo associado não é a Business Platform da Meta.
- Contar lugares para números a que responderá software e não pessoas.
- Misturar números associados por QR e números ligados por API na mesma conta, sem registar qual é qual.

**A EasyCoexistence é mais barata do que a TimelinesAI?** Por número ligado, sim. O TimelinesAI Starter custa $35 por utilizador por mês. A EasyCoexistence custa US$ 9 por número ligado por mês, e uma equipa de qualquer dimensão a responder pela app WhatsApp Business não acrescenta nada.

**A TimelinesAI suporta Coexistence?** Sim. A página de preços indica a Coexistence a par do QR code e da API oficial em todos os planos.

**Posso ligar um número por QR code com a EasyCoexistence?** Não. Todos os números são ligados pela Cloud API da Meta com Coexistence, nunca como dispositivo associado.

**Continuo a usar o WhatsApp no telemóvel?** Sim. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número enquanto a API corre em paralelo.

---

## EasyCoexistence vs Periskope

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-periskope

O Periskope liga um número do WhatsApp através da leitura de um código QR no ecrã Associar dispositivo do telemóvel, e a sua documentação indica que os números da API do WhatsApp não podem ser associados. O EasyCoexistence segue o caminho oposto: o número é registado na Cloud API da Meta através da Coexistence, pelo que a app WhatsApp Business continua a funcionar e a ligação é a oficial.

### Como cada um chega ao WhatsApp

Tudo o resto nesta página decorre do método de ligação.

- Periskope:: Abra as definições do WhatsApp no telemóvel, escolha Associar dispositivo e leia o código QR que o Periskope mostra. O número fica ligado como dispositivo associado, e a página inicial do Periskope anuncia que isto dispensa a API Business.
- EasyCoexistence:: O Embedded Signup da Meta regista o número na Cloud API com credenciais que a Meta emite para a sua própria WhatsApp Business Account. A Coexistence mantém a app no telemóvel a funcionar com o mesmo número.

### Quanto custa por mês

Ambos publicam os preços, e contam coisas diferentes.

- Periskope:: O Starter custa $25 por utilizador por mês e o Pro $35, com o primeiro telemóvel incluído e cada telemóvel adicional faturado como uma licença própria ao preço do plano. O Enterprise exige pelo menos 50 utilizadores ou telemóveis.
- EasyCoexistence:: US$ 9 por número ligado por mês de um a cinco números, descendo ao longo de seis escalões até US$ 1 à medida que adiciona números. Sem licenças de utilizador, e a Meta fatura as mensagens diretamente à sua conta, sem margem adicional.

### A que fica exposta a ligação

O WhatsApp trata de forma diferente uma sessão de dispositivo associado e um registo na API.

- Periskope:: O acesso por dispositivo associado funciona fora da Business Platform da Meta. Os termos comerciais do WhatsApp regulam a utilização automatizada e por terceiros, e um número acedido assim não tem estatuto ao nível da API junto da Meta.
- EasyCoexistence:: Cada chamada vai para a Cloud API da Meta. Quando uma ligação cai, lemos o motivo de desconexão indicado pela própria Meta e enviamos um alerta, incluindo a regra de 14 dias de atividade na app que se aplica aos números em Coexistence.

### Qual escolher

A questão é quanto vale o número e onde tem de funcionar. O modelo do Periskope assenta na associação de números existentes como dispositivos, incluindo grupos, e não aceita de todo números de API.

Para um número de que os clientes dependem, ou o número de um cliente pelo qual uma agência é responsável, o caminho oficial é o que se mantém dentro das regras da Meta. O EasyCoexistence oferece esse caminho por um valor fixo por número, mantém a app WhatsApp Business a funcionar e entrega as mensagens ao seu próprio sistema.

- Presumir que uma ferramenta paga significa que o acesso é autorizado pela Meta. A autorização vem de a Meta emitir credenciais da API.
- Associar um número empresarial como dispositivo e tentar depois passá-lo para um fornecedor de API sem o desassociar primeiro.
- Fixar o preço por utilizador quando a maioria das mensagens será tratada por automação e não por pessoas.

**O EasyCoexistence é mais barato do que o Periskope?** Sim. O Periskope Starter custa $25 por utilizador por mês, e cada telemóvel adicional mais $25. O EasyCoexistence custa US$ 9 por número ligado por mês, sem encargos por utilizador.

**O Periskope usa a API oficial do WhatsApp?** Não. A sua documentação liga os números por código QR através de Associar dispositivo e indica que os números da API do WhatsApp não podem ser associados.

**Posso usar grupos através do EasyCoexistence?** Não. As conversas de grupo ficam fora da Cloud API da Meta, e essa regra aplica-se a todos os fornecedores oficiais.

**A minha app vai continuar a funcionar?** Sim. A Coexistence mantém a app WhatsApp Business a funcionar no telemóvel enquanto a Cloud API corre no mesmo número.

---

## EasyCoexistence vs Wassenger

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-wassenger

A Wassenger é uma caixa de entrada para equipas e uma plataforma de API do WhatsApp com dois conectores: uma sessão por código QR e a Cloud API da Meta, com Coexistence do lado da API. A EasyCoexistence oferece apenas a Cloud API com Coexistence, não tem caixa de entrada e cobra cada número ligado a partir de US$ 9 por mês, em vez de um plano com um número fixo de agentes.

### Como cada uma liga o número

O centro de ajuda da própria Wassenger compara os seus dois conectores, o que é o melhor ponto de partida.

- Wassenger:: Um conector QR, descrito como uma ligação baseada em sessão através de um serviço worker que exige o telemóvel online e está sujeito à deteção de spam do WhatsApp, e um conector Cloud API autenticado com a Meta. A Coexistence é oferecida do lado da API.
- EasyCoexistence:: Apenas a Cloud API da Meta, através do Embedded Signup da Meta com Coexistence. No produto não existe worker de sessão nem conector QR, pelo que não há nada que se possa escolher mal.

### O que paga a fatura mensal

Um plano de agentes e uma tarifa por número crescem com coisas diferentes.

- Wassenger:: O Professional custa 39,90 € por mês para um número e 3 agentes, o Business 69,90 € com 6 agentes, o Enterprise 99,90 € com 9 agentes. Os custos de template definidos pela Meta são faturados à parte, ao preço de custo.
- EasyCoexistence:: US$ 9 por número ligado por mês, a descer até US$ 1 à medida que adiciona números, sem contagem de agentes. A Meta fatura as mensagens diretamente à sua WhatsApp Business Account, nunca através de nós.

### Onde ficam as conversas

Uma caixa de entrada guarda o que mostra. Uma ligação reencaminha o que recebe.

- Wassenger:: Na caixa de entrada partilhada da equipa, onde os agentes recebem conversas atribuídas, executam campanhas e usam o assistente de IA. As mensagens ficam na plataforma para que os agentes possam trabalhá-las.
- EasyCoexistence:: No seu próprio sistema. A Meta encaminha os webhooks diretamente para o endpoint que definir, as conversas nunca são guardadas do nosso lado e a equipa continua a responder a partir da app do WhatsApp Business.

### Qual escolher

Uma equipa que quer agentes a iniciar sessão numa caixa de entrada partilhada está a comprar uma caixa de entrada, e é em torno disso que os planos da Wassenger são construídos.

Quem quer o número na API oficial e nada mais, uma agência que liga números de clientes, um programador que alimenta uma aplicação existente, um proprietário que acrescenta automação sem uma nova ferramenta, obtém na EasyCoexistence um produto mais restrito: um só tipo de ligação, uma tarifa fixa por número, uma monitorização que avisa antes de uma ligação Coexistence caducar e um servidor MCP para Claude, ChatGPT e Cursor.

- Começar com um conector QR para testar e deixar o número da empresa nele depois de funcionar.
- Comparar um plano de 39,90 € com uma tarifa por número sem contar os agentes e a caixa de entrada incluídos no plano.
- Mudar um número de conector sem verificar se o histórico de conversas o acompanha.

**A EasyCoexistence é mais barata do que a Wassenger?** Para a ligação, sim. O Wassenger Professional custa 39,90 € por mês para um número. A EasyCoexistence custa US$ 9 por número ligado por mês, e cinco números custam US$ 45 no total.

**A Wassenger suporta Coexistence?** Sim. A Wassenger publica uma página e um artigo de ajuda sobre Coexistence, para usar a app do WhatsApp Business e a sua plataforma de API no mesmo número.

**O conector QR da Wassenger é oficial?** A Wassenger descreve-o como baseado em sessão e sujeito à deteção de spam do WhatsApp. O conector Cloud API é o que é autenticado com a Meta.

**Preciso de um servidor para usar a EasyCoexistence?** Precisa de um endpoint para receber webhooks, ou de um assistente de IA ligado através do servidor MCP. O alojamento da própria ligação está incluído.

---

## EasyCoexistence vs WANotifier

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-wanotifier

O WANotifier é uma plataforma de marketing e notificações no WhatsApp sobre a API oficial, com preço por plano e escalão de contactos e limites mensais de mensagens. A EasyCoexistence é a própria ligação oficial, com Coexistence, cobrada por número ligado, sem limite de contactos nem de mensagens. Ambos repassam as tarifas de mensagens da Meta sem margem, pelo que a diferença está no que a subscrição efetivamente paga.

### O que paga a fatura mensal

O WANotifier cobra pela dimensão do público. A EasyCoexistence cobra por número.

- WANotifier:: Essentials $69, Advanced $119 e Premium $199 por mês com faturação mensal, no escalão de menos de 1 000 contactos, com limites mensais de envio de 4 000, 8 000 e 12 000 mensagens. Uma lista de contactos maior faz subir para um escalão superior.
- EasyCoexistence:: A partir de US$ 9 por número ligado por mês para até cinco números, descendo até US$ 1 à medida que adiciona números. Uma lista de cinquenta mil contactos custa o mesmo que uma lista de cinquenta.

### Como a Coexistence se enquadra

Ambos ligam-se através da API oficial da Meta e ambos oferecem Coexistence, pelo que a app WhatsApp Business continua no telemóvel.

- WANotifier:: A Coexistence surge como funcionalidade em todos os planos, a par de campanhas, chatbots, sequências graduais e uma caixa de entrada partilhada pela equipa.
- EasyCoexistence:: A Coexistence é o produto inteiro: Embedded Signup em autoatendimento em cerca de dois minutos, monitorização contínua do estado e alertas baseados nos motivos de desligação da própria Meta, incluindo a regra dos 14 dias de atividade da app.

### Para onde vão as mensagens

Uma ferramenta de campanhas trata as mensagens por si. Uma ligação entrega-as.

- WANotifier:: Para o painel, a caixa de entrada e o construtor de automações deles, com uma API REST e webhooks nos planos Advanced e Premium para integrações.
- EasyCoexistence:: Diretamente para o seu endpoint em cada número, porque a Meta encaminha os webhooks para o URL que indicar. Nada é guardado do nosso lado, e um servidor MCP permite ao Claude, ao ChatGPT ou ao Cursor trabalhar com o número.

### Qual escolher

Quem quer envios em massa, sequências graduais e um construtor de chatbots num só painel está a comprar uma ferramenta de campanhas, um produto diferente de uma ligação.

Quem já tem o software, ou o está a construir, precisa do número ligado oficialmente e mantido ligado. Isso é a EasyCoexistence, por um valor que não varia com os contactos nem com o volume, enquanto as tarifas de mensagens da própria Meta vão diretamente para a sua conta nos dois casos.

- Escolher um plano pelo preço sem verificar o limite mensal de mensagens que o acompanha.
- Deixar a lista de contactos ultrapassar o limite de um escalão a meio do mês sem orçamentar a subida.
- Pensar que 0% de margem significa ausência de custo da plataforma. Aplicam-se tanto a subscrição como as tarifas da Meta.

**A EasyCoexistence é mais barata do que o WANotifier?** Sim, no que toca à ligação. O WANotifier Essentials custa $69 por mês no menor escalão de contactos. A EasyCoexistence custa US$ 9 por número ligado por mês, sem limite de contactos nem de mensagens.

**O WANotifier suporta Coexistence?** Sim. A página de preços deles indica a WhatsApp Coexistence em todos os planos.

**Ambos repassam as tarifas da Meta sem margem?** Sim. O WANotifier indica 0% de margem e, com a EasyCoexistence, a Meta fatura diretamente na sua própria conta.

**Posso enviar campanhas com a EasyCoexistence?** Pode enviar templates aprovados através da Cloud API a partir do seu próprio sistema ou de um assistente de IA. Não existe um construtor de campanhas.

---

## EasyCoexistence vs Eazybe

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-eazybe

A Eazybe é uma camada de CRM para equipas comerciais, instalada como extensão do Chrome no WhatsApp Web, com preço por utilizador no plano Starter e planos superiores que acrescentam um número de API do WhatsApp e Coexistence. A EasyCoexistence é apenas a ligação oficial: a Cloud API da Meta com Coexistence, com preço por número, que entrega as mensagens ao seu próprio sistema.

### Como cada uma chega ao WhatsApp

Os dois produtos situam-se em sítios diferentes: um no navegador do comercial, outro na API da Meta.

- Eazybe:: Uma extensão do Chrome acrescentada à sessão do WhatsApp Web que cada comercial já tem aberta, com etiquetas, sincronização com o CRM e agendamento. Os planos superiores listam também um número de API do WhatsApp e Coexistence.
- EasyCoexistence:: A Cloud API da Meta, registada através do Embedded Signup da Meta com Coexistence. Nada corre num separador do navegador, pelo que as mensagens circulam quer alguém tenha o WhatsApp Web aberto, quer não.

### O que paga a fatura mensal

A Eazybe mostra os preços na moeda local do visitante e muda a unidade de cobrança entre planos.

- Eazybe:: O Starter tem preço por utilizador por mês. O Scaler, o Basic AI e o Pro AI têm preço por número por mês, com 3 ou 5 utilizadores incluídos e cada utilizador adicional cobrado à parte, além das respostas de IA faturadas por resposta.
- EasyCoexistence:: US$ 9 por número ligado por mês, descendo para US$ 1 à medida que adiciona números. Sem contagem de utilizadores, sem créditos de IA, e a Meta fatura as mensagens diretamente à sua própria conta.

### Onde acabam as conversas

Uma extensão de CRM copia as conversas para um CRM. Uma ligação encaminha-as para o sistema que escolher.

- Eazybe:: Sincronizadas a partir do WhatsApp Web para os CRM com que se integram, como HubSpot, Zoho e Salesforce, através da sua plataforma.
- EasyCoexistence:: Entregues pela Meta como webhooks ao endpoint que indicar, nunca guardadas do nosso lado. O seu CRM, a sua aplicação, uma ferramenta de automatização ou um assistente de IA através do servidor MCP recebe-as diretamente.

### Qual escolher

Uma equipa comercial que quer campos de CRM ao lado de cada conversa no navegador está a comprar uma extensão de CRM, e é isso que o plano Starter da Eazybe é.

Uma empresa que quer todos os números na API oficial da Meta, sem dependência de uma sessão do navegador, compra a ligação. A EasyCoexistence fornece-a por uma tarifa fixa por número, vigia continuamente o seu estado, avisa antes de a regra de 14 dias de atividade na app caducar e deixa a equipa na app WhatsApp Business que já utiliza.

- Tratar uma extensão do navegador no WhatsApp Web como uma ligação por API. Depende de o separador estar aberto.
- Comparar um plano por utilizador com uma tarifa por número sem contar quantos comerciais partilham cada número.
- Presumir que todos os planos incluem a API oficial. Na Eazybe aparece a partir do Scaler.

**A EasyCoexistence é mais barata do que a Eazybe?** Para um número partilhado por uma equipa, sim. O Starter da Eazybe cobra por utilizador, e os planos de API cobram por número mais os utilizadores adicionais. A EasyCoexistence custa US$ 9 por número ligado por mês, independentemente da dimensão da equipa.

**A Eazybe suporta Coexistence?** A Eazybe publica uma página sobre Coexistence que descreve a app WhatsApp Business e a API oficial no mesmo número.

**Preciso de ter o WhatsApp Web aberto para a EasyCoexistence?** Não. A Cloud API corre nos servidores da Meta, e a equipa continua a usar a app WhatsApp Business no telemóvel.

**Posso sincronizar mensagens com o meu CRM?** Sim, apontando os webhooks da Meta para o seu CRM, para uma ferramenta de automatização como o n8n ou o Make, ou para o seu próprio código.

---

## EasyCoexistence vs Superchat

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-superchat

O Superchat é uma caixa de entrada unificada para WhatsApp, Instagram, email e outros canais, vendida em planos com contrato mínimo de 12 meses, e a sua opção Coexistence está identificada como beta. A EasyCoexistence faz uma só coisa: liga o número de WhatsApp à Cloud API da Meta através da Coexistence, com preço por número ligado por mês, e entrega as mensagens ao seu próprio sistema.

### O que paga a mensalidade

O Superchat conta contas e números dentro de um plano. A EasyCoexistence conta apenas números.

- Superchat:: Basic $19, Professional $29 e Advanced $69 por mês, valores líquidos, com 3, 6 e 12 contas e 1, 2 e 4 números de WhatsApp. Cada número adicional custa $49 por mês e cada acesso extra $19, com contrato mínimo de 12 meses.
- EasyCoexistence:: US$ 9 por número ligado por mês, descendo até US$ 1 à medida que adiciona números, sem contas nem acessos para contar. A Meta cobra-lhe diretamente as tarifas das mensagens.

### Como é oferecida a Coexistence

Ambos ligam através da API oficial e ambos oferecem Coexistence, para que a app do WhatsApp Business continue no telemóvel.

- Superchat:: É um de quatro caminhos de ligação, a par de um número novo, de uma migração completa e da mudança a partir de outro fornecedor. O centro de ajuda indica que o caminho Coexistence está atualmente em beta e pode ter limitações de funcionalidades.
- EasyCoexistence:: É o único caminho, concluído em autoatendimento através do Embedded Signup da Meta em cerca de dois minutos, e depois monitorizado de forma contínua, para que uma ligação interrompida seja detetada antes de o cliente reparar.

### Onde ficam as conversas

Uma caixa de entrada guarda conversas para os agentes. Uma ligação encaminha-as.

- Superchat:: Na sua caixa de entrada unificada, com templates, etiquetas, agentes de IA e gestão de avaliações a trabalhar sobre as mensagens dentro da plataforma.
- EasyCoexistence:: No endpoint que indicar, porque a Meta encaminha os webhooks diretamente para lá. As conversas nunca são guardadas do nosso lado, e a equipa mantém a app do WhatsApp Business.

### Qual escolher

Uma empresa que quer responder a vários canais a partir de uma só caixa de entrada está a comprar uma caixa de entrada multicanal, uma compra distinta de uma ligação WhatsApp.

Uma empresa que quer o seu número de WhatsApp na API oficial, mantido ativo, com as mensagens a seguir para o seu próprio CRM, aplicação ou assistente de IA, compra a EasyCoexistence: uma tarifa fixa por número e a Coexistence como núcleo do produto, em vez de uma opção beta.

- Ler um preço mensal sem ter em conta o prazo mínimo que lhe está associado.
- Contar apenas o preço do plano quando são precisos mais números. Os números adicionais têm a sua própria mensalidade.
- Iniciar a adesão à Coexistence com um número já ligado a outro fornecedor de API.

**A EasyCoexistence é mais barata do que o Superchat?** Sim, para uma ligação WhatsApp. O Superchat Basic custa $19 por mês com contrato mínimo de 12 meses. A EasyCoexistence custa US$ 9 por número ligado por mês, e uma equipa de qualquer dimensão responde a partir da app do WhatsApp Business.

**O Superchat suporta Coexistence?** Sim, como uma das suas opções de ligação, que o centro de ajuda identifica como beta.

**A EasyCoexistence abrange Instagram ou email?** Não. Liga números de WhatsApp através da Cloud API da Meta e nada mais.

**Quem paga as tarifas das mensagens da Meta?** O cliente, diretamente à Meta, na sua própria WhatsApp Business Account. A EasyCoexistence nunca aplica margem sobre elas.

---

## EasyCoexistence vs Sinch

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-sinch

A Sinch é uma plataforma de comunicações empresariais que revende WhatsApp a par de SMS, voz e outros canais, cobrando a sua própria taxa por mensagem além da da Meta, conforme o contrato de cada cliente. A EasyCoexistence liga um número da app WhatsApp Business à Cloud API da Meta através da Coexistence, em autoatendimento, por um valor fixo por número, e a Meta fatura-lhe as mensagens diretamente.

### Quanto custa cada mensagem

A diferença está em haver, ou não, uma segunda taxa em cada mensagem.

- Sinch:: Duas camadas em cada mensagem: a taxa da Meta por categoria e país, e uma taxa da Sinch pelo acesso à plataforma e pelo serviço por mensagem, definida pelo contrato com a Sinch e não por uma tabela pública.
- EasyCoexistence:: Uma só camada. A Meta fatura as suas taxas à sua própria conta WhatsApp Business e nós nunca as majoramos. O nosso preço é de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que adiciona números, seja qual for o tráfego.

### Para que números cada uma foi pensada

A maioria das pequenas empresas já responde aos clientes na app WhatsApp Business. É esse o número que importa.

- Sinch:: O guia de configuração do Sinch Engage Classic pede um número que consiga receber SMS ou chamadas internacionais e que não esteja ligado a nenhuma conta de WhatsApp. Os artigos de onboarding não descrevem um percurso de Coexistence.
- EasyCoexistence:: O número que já está na app WhatsApp Business, ligado através da Coexistence. As conversas, o histórico e a app no telemóvel mantêm-se, e a Cloud API funciona no mesmo número.

### Como se começa

Um percurso passa por um contrato comercial, o outro por uma página de registo.

- Sinch:: O Embedded Signup no painel Build da Sinch está, nas palavras da própria empresa, disponível apenas para clientes empresariais diretos neste momento, e o preço depende do contrato.
- EasyCoexistence:: Embedded Signup da Meta em autoatendimento, em cerca de dois minutos, com os primeiros 3 dias grátis. A app tem de ter a versão 2.24.17 ou posterior e atividade real recente.

### Qual escolher

Uma empresa que compra SMS, voz e WhatsApp num só contrato, com condições negociadas, está a comprar CPaaS, que é uma compra diferente de uma ligação ao WhatsApp.

Uma empresa cujos clientes já escrevem para a sua app WhatsApp Business, ou uma agência que liga esses números para clientes, precisa de Coexistence, de um preço público e de nenhuma taxa acumulada em cada mensagem. A EasyCoexistence foi feita exatamente para isso, com webhooks encaminhados pela Meta para o seu próprio sistema e um servidor MCP para assistentes de IA.

- Orçamentar apenas a tabela de preços da Meta quando o fornecedor acrescenta a sua própria taxa a cada mensagem.
- Registar um número novo para a API e deixar os clientes a escrever para o antigo, na app.
- Eliminar a conta da app WhatsApp Business para libertar um número quando a Coexistence o manteria.

**A EasyCoexistence é mais barata do que a Sinch?** Sim, na parte que controlamos. A Sinch acrescenta a sua taxa a cada mensagem, conforme o seu contrato. A EasyCoexistence não acrescenta nada por mensagem e cobra US$ 9 por número ligado por mês.

**A Sinch suporta Coexistence?** Os artigos de onboarding da Sinch analisados para esta página não abordam o tema. Pergunte diretamente à Sinch em vez de se basear nesta página.

**A Sinch publica a sua taxa de WhatsApp?** O centro de ajuda indica que as taxas da Sinch dependem do contrato e não apresenta um preço público por mensagem.

**Preciso de um contrato com a EasyCoexistence?** Não. O registo é em autoatendimento através do Embedded Signup da Meta, com os primeiros 3 dias grátis.

---

## EasyCoexistence vs Vonage

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-vonage

A Vonage é uma plataforma de comunicações para programadores cuja Messages API envia WhatsApp a par de SMS, RCS e outros canais, com uma taxa de plataforma da Vonage somada a cada mensagem, além da da Meta. A EasyCoexistence liga um número da app WhatsApp Business à Cloud API da Meta através da Coexistence, por uma taxa fixa por número, e a Meta fatura-lhe as mensagens diretamente.

### Como se constrói a fatura

Um preço por utilização e uma taxa fixa comportam-se de forma diferente à medida que o volume cresce.

- Vonage:: A taxa da Meta por mensagem entregue, mais uma taxa de plataforma da Vonage que começa em 0,0001 euros por mensagem e varia consoante o volume e a região. As chamadas têm ainda uma taxa da Vonage de $0,004 por minuto.
- EasyCoexistence:: US$ 9 por número ligado por mês, a descer até US$ 1 à medida que adiciona números. A Meta fatura as mensagens à sua própria conta WhatsApp Business e nós não acrescentamos nada por mensagem.

### Para que números cada uma foi pensada

O número em que uma pequena empresa já atende costuma ser um número da app WhatsApp Business.

- Vonage:: A sua página de preços do WhatsApp e o guia de Embedded Signup alojado para parceiros não abordam a Coexistence, a funcionalidade da Meta que mantém a app a funcionar num número com API.
- EasyCoexistence:: Especificamente números em Coexistence. A app WhatsApp Business mantém as conversas e continua a funcionar no telemóvel, enquanto a Cloud API funciona no mesmo número, com o throughput de 20 mensagens por segundo da Coexistence da Meta.

### O que fica entre si e a Meta

Ambas são produtos de API. O que difere é a API que se chama.

- Vonage:: A Vonage Messages API, uma interface única sobre o WhatsApp e os restantes canais. O seu código chama a Vonage e a Vonage chama a Meta.
- EasyCoexistence:: A Cloud API documentada da Meta, com credenciais emitidas para a sua própria conta, e webhooks encaminhados pela Meta para o seu endpoint. As conversas nunca são guardadas do nosso lado.

### Qual escolher

Um programador que quer uma só API para SMS, RCS, email e WhatsApp está a comprar CPaaS multicanal, que é um produto diferente de uma ligação ao WhatsApp.

Uma empresa ou agência que precisa de números da app WhatsApp Business na API da própria Meta, sem uma taxa por cada mensagem e sem um número novo, precisa da Coexistence. A EasyCoexistence disponibiliza-a em autoatendimento em cerca de dois minutos, monitoriza cada ligação de forma contínua e expõe o número ao Claude, ao ChatGPT ou ao Cursor através de um servidor MCP.

- Projetar o custo a partir de uma taxa de plataforma por mensagem sem lhe somar a taxa da própria Meta.
- Escrever código à medida do esquema de mensagens de um fornecedor quando a Cloud API da Meta está documentada e é portátil.
- Presumir que o processo de adesão de um CPaaS aceita um número que ainda está ativo na app.

**A EasyCoexistence é mais barata do que a Vonage?** A qualquer volume relevante, sim, porque a Vonage soma uma taxa de plataforma a cada mensagem e a EasyCoexistence não soma nenhuma. O nosso preço mantém-se em US$ 9 por número ligado por mês, qualquer que seja o número de mensagens.

**A Vonage suporta a Coexistence?** As suas páginas de preços do WhatsApp e de Embedded Signup alojado não a abordam. Pergunte à Vonage em vez de se basear nesta página.

**Posso manter o meu número de WhatsApp atual?** Sim. A Coexistence liga o número que já está na app WhatsApp Business, com as respetivas conversas.

**Quem me fatura as mensagens de WhatsApp?** A Meta, diretamente, na sua própria conta WhatsApp Business. A EasyCoexistence nunca aplica margem a essas taxas.

---

## EasyCoexistence vs Qontak

https://easycoexistence.com/pt-pt/compare/easycoexistence-vs-qontak

O Mekari Qontak é uma suite indonésia de CRM e apoio ao cliente omnicanal sobre a API oficial do WhatsApp, vendida em planos que começam nos cinco utilizadores, com a Coexistence a exigir uma subscrição própria. A EasyCoexistence é apenas a ligação: um número da app WhatsApp Business na Cloud API da Meta através de Coexistence, com preço por número ligado, e as mensagens seguem para o seu próprio sistema.

### O que a fatura mensal paga

O Qontak vende uma suite de CRM. A EasyCoexistence vende uma ligação.

- Qontak:: O Service Suite e o Sales Suite começam em Rp2.000.000 por mês no nível Plus e em Rp3.000.000 no Ultimate, e o Qontak 360 em Rp3.500.000, com todos os planos a partir de 5 utilizadores.
- EasyCoexistence:: US$ 9 por número ligado por mês, descendo até US$ 1 à medida que acrescenta números. Um número com uma equipa de qualquer dimensão a responder a partir da app custa US$ 9.

### Como se configura a Coexistence

Ambos ligam através do fluxo de Coexistence da Meta, pelo que a app WhatsApp Business continua a funcionar no telemóvel.

- Qontak:: O guia do Qontak indica, entre os requisitos antes da integração, uma subscrição ativa de META Coex, um número ativo há pelo menos 30 dias e a verificação empresarial do Facebook concluída.
- EasyCoexistence:: A Coexistence é o produto e não custa nada a mais. O registo é autónomo e demora cerca de dois minutos, com a app na versão 2.24.17 ou posterior, atividade real recente e o número não associado a outro fornecedor.

### Onde ficam as conversas

Uma suite de CRM guarda as conversas para as trabalhar. Uma ligação entrega-as a quem as vai usar.

- Qontak:: Na caixa de entrada omnicanal e no CRM do Qontak, espelhadas com a app WhatsApp Business, a par de ticketing, chatbots e difusões geridos a partir do painel do fornecedor.
- EasyCoexistence:: No endpoint que escolher, porque a Meta encaminha os webhooks diretamente para lá. As conversas nunca são guardadas do nosso lado, e um servidor MCP liga o número a assistentes de IA.

### Qual escolher

Uma empresa que quer funis de vendas, ticketing e vários canais numa só suite está a comprar um CRM, algo diferente de uma ligação ao WhatsApp.

Uma empresa que já tem o seu CRM, ou uma agência que integra números de clientes na sua própria infraestrutura, precisa do número na API oficial e mantido ligado. A EasyCoexistence faz isso por um valor fixo por número, monitoriza cada ligação e avisa antes de expirar a regra de 14 dias de atividade na app da Meta.

- Ligar um número registado na app WhatsApp de consumo. A Coexistence exige a app WhatsApp Business.
- Criar um portefólio empresarial novo só para a integração, o que o guia do Qontak desaconselha.
- Repor a app para resolver um problema da conta. Isso não repõe o histórico e pode interromper a ligação.

**A EasyCoexistence é mais barata do que o Qontak?** Sim, no que toca à ligação. Os planos do Qontak começam em Rp2.000.000 por mês, com um mínimo de 5 utilizadores, além de uma subscrição de Coexistence. A EasyCoexistence custa US$ 9 por número ligado por mês, com Coexistence incluída.

**O Qontak suporta Coexistence?** Sim. O seu centro de ajuda descreve a integração e indica uma subscrição ativa de META Coex como requisito.

**A EasyCoexistence exige um número com 30 dias?** Exige atividade real recente na app WhatsApp Business, que é a verificação de elegibilidade da própria Meta para a Coexistence.

**A EasyCoexistence inclui um CRM?** Não. As mensagens chegam ao seu CRM ou app existente através de webhooks que a Meta entrega no seu endpoint.

---

## Registar mensagens do WhatsApp no HubSpot a partir de um número Coexistence

https://easycoexistence.com/pt-pt/integrations/hubspot

O HubSpot tem um objeto Communications cujo tipo de canal pode ser WHATS_APP, pensado para registar mensagens que acontecem fora do HubSpot. Encaminhe os webhooks do número para um fluxo de trabalho do n8n, procure ou crie o contacto pelo telefone e faça POST de cada mensagem para /crm/v3/objects/communications. A conversa fica na cronologia do contacto, enquanto a equipa continua a responder a partir da app WhatsApp Business.

### Como chega uma mensagem de WhatsApp a um contacto do HubSpot?

Em três passos. A Meta entrega a mensagem ao destino do webhook definido para o número, que aqui é um nó Webhook do n8n. O fluxo de trabalho procura no HubSpot um contacto com o número de telefone do remetente e cria um se nada corresponder. Depois cria um registo de comunicação com o texto da mensagem e associa-o a esse contacto.

O HubSpot criou o objeto Communications para este caso. Representa uma mensagem de WhatsApp, LinkedIn ou SMS enviada ou recebida fora do HubSpot e aparece na cronologia do registo, tal como uma chamada ou um email registados. As propriedades obrigatórias são o tipo de canal, hs_communication_logged_from definido como CRM, o corpo, um proprietário e uma data e hora.

Nada disto exige uma app do marketplace do HubSpot. O nó HTTP Request do n8n pode reutilizar a credencial do HubSpot que já configurou para o nó HubSpot, e a chamada é um único POST por mensagem.

### As mensagens escritas no telemóvel também são registadas?

Podem ser, e é isso que um número Coexistence acrescenta. Quando alguém da equipa responde a partir da app WhatsApp Business, a Meta envia um eco dessa mensagem enviada para o mesmo destino do webhook. Um fluxo de trabalho que trate as mensagens recebidas e os ecos escreve os dois lados da conversa na cronologia, de modo que um comercial que abra o contacto no HubSpot vê o que o cliente perguntou e o que a loja respondeu.

Separe pelo campo do webhook. As mensagens recebidas chegam em messages e as respostas do telemóvel chegam em smb_message_echoes. Registe as primeiras como recebidas e as segundas como enviadas, e a cronologia fica por ordem.

As respostas que o próprio fluxo de trabalho envia através da Cloud API já são conhecidas por ele, por isso registe-as no momento do envio, em vez de esperar por um webhook.

### E o canal de caixa de entrada do WhatsApp do próprio HubSpot?

É uma integração diferente. A caixa de entrada de conversas do HubSpot liga um número de WhatsApp ao próprio HubSpot, e a sua base de conhecimento indica que o número não pode estar ligado a outra integração de WhatsApp. Está disponível no Marketing Hub ou no Service Hub Professional e Enterprise.

Um número ligado através do EasyCoexistence funciona ao contrário: a Meta encaminha os webhooks para um URL que lhe pertence e o HubSpot recebe os registos através da sua API. A conversa é respondida a partir do telemóvel ou pelo seu fluxo de trabalho, e o HubSpot é o sistema de registo que guarda o histórico associado ao contacto, ao negócio ou ao ticket.

A chamada exige uma permissão de escrita de contactos na app privada ou na credencial que a faz, que é a mesma permissão de que o fluxo de trabalho já precisa para criar o contacto.

### Como deve o fluxo de trabalho associar um remetente a um contacto?

Pelo número de telefone, normalizado antes da pesquisa. A Meta envia o remetente como dígitos com o indicativo do país e sem o sinal de mais, por exemplo 14155550188. Os contactos do HubSpot são escritos à mão, pelo que a mesma pessoa pode estar guardada como +1 415 555 0188 ou (415) 555-0188.

O padrão fiável é manter uma propriedade de contacto dedicada com o número só em dígitos, preenchê-la quando o fluxo de trabalho cria um contacto e pesquisar por essa propriedade. Pesquisar diretamente o campo de telefone em texto livre funciona para os contactos criados pelo fluxo de trabalho e falha muitos dos que foram criados por uma pessoa, o que gera duplicados.

Quando uma pesquisa não devolve nada, crie o contacto com o nome de perfil do payload do webhook como primeiro nome e o número só em dígitos nos dois campos. Uma pessoa pode fundir ou renomear mais tarde, e a conversa já fica associada.

- Registar apenas as mensagens recebidas. A cronologia mostra então perguntas sem respostas, porque as respostas escritas no telemóvel chegam como eventos smb_message_echoes.
- Deixar hs_communication_logged_from por definir. O HubSpot exige que seja CRM ao criar uma comunicação através da API.
- Pesquisar contactos pelo campo de telefone original. O formato só com dígitos da Meta raramente coincide com o que uma pessoa escreveu, e cada falha cria um contacto duplicado.

**Posso responder ao cliente a partir do HubSpot?** Não através do objeto Communications, que é um registo. As respostas saem da app WhatsApp Business ou de um fluxo de trabalho que chame a Cloud API, e ambas ficam registadas no contacto.

**Que permissões do HubSpot exige o fluxo de trabalho?** Leitura e escrita de contactos. O HubSpot indica crm.objects.contacts.read ou crm.objects.contacts.write como as permissões da Communications API, e a criação de contactos exige de qualquer forma a de escrita.

**O mesmo fluxo de trabalho também pode enviar a primeira mensagem?** Sim. Um ramo separado do n8n pode enviar um template aprovado através da Cloud API com o phone number id e o token do número e depois registá-lo no contacto como uma comunicação enviada.

**O EasyCoexistence guarda o conteúdo das mensagens pelo caminho?** Não. A Meta entrega o webhook diretamente ao seu URL do n8n. O EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Enviar conversas do WhatsApp para o Salesforce a partir de um número Coexistence

https://easycoexistence.com/pt-pt/integrations/salesforce

Encaminhe os webhooks do número para um workflow do n8n, procure o remetente no Salesforce com uma consulta SOQL ao campo phone, crie o lead se não houver correspondência e registe cada mensagem como tarefa ou nota no registo. O nó Salesforce do n8n cobre as três chamadas. A equipa continua a responder na app do WhatsApp Business, enquanto o Salesforce guarda o histórico.

### Como é o workflow do n8n?

Quatro nós em sequência, mais o ramo de verificação de que todos os webhooks da Meta precisam.

Um nó Webhook recebe o POST que a Meta envia por cada mensagem. Um nó Salesforce executa uma consulta SOQL a um Lead ou Contact cujo telefone corresponda ao do remetente. Um nó IF separa os casos consoante tenha ou não vindo algum resultado: se veio, o workflow segue com o id do registo; se não veio, um nó Salesforce cria um Lead com o nome de perfil que consta do payload. Um último nó Salesforce cria uma tarefa nesse registo, com o texto da mensagem na descrição e o assunto a indicar que foi uma mensagem de WhatsApp.

O ramo de verificação responde ao GET da Meta com o valor de hub.challenge como corpo simples. Sem ele, a Meta nunca começa a entregar mensagens e o resto do workflow fica parado.

### Tarefa ou nota: qual deve guardar a mensagem?

Uma tarefa, na maioria das equipas, porque fica na cronologia de atividades que os comerciais já consultam e pode ser usada em relatórios. Defina o estado como concluída, para não surgir como tarefa em aberto, e dê-lhe um assunto que indique o canal, de modo que filtrar a atividade de WhatsApp seja uma única condição.

A operação Add note do nó do n8n serve outro caso: um resumo em vez de todas as mensagens. Algumas equipas fazem o workflow reunir as mensagens do dia por contacto e escrever uma só nota ao fim da tarde, o que mantém a cronologia legível quando um cliente envia vinte linhas curtas.

Qualquer que seja a escolha, grave o id da mensagem do WhatsApp no registo. A Meta repete as entregas, e um workflow que verifica se o id já existe antes de escrever nunca regista a mesma mensagem duas vezes.

### A equipa continua a poder responder pelo telemóvel e o Salesforce vê essas respostas?

Sim, a ambos. A Coexistence mantém a app do WhatsApp Business a funcionar no mesmo número, pelo que as pessoas que respondiam aos clientes ontem continuam a fazê-lo. Quando respondem a partir da app, a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Acrescente ao workflow um segundo caminho para esses ecos e registe-os como tarefas de saída. Um comercial que abra o lead vê então a pergunta e a resposta dada pela loja, por ordem, sem que ninguém copie uma conversa à mão.

As respostas que o próprio workflow envia, através de um nó HTTP Request contra a Cloud API, devem ser registadas no momento do envio. O workflow já tem à mão o texto e o id do registo.

### Como evitar leads duplicados?

Faça a correspondência por um número de telefone normalizado, não pelo campo tal como foi escrito. A Meta envia o remetente como dígitos com o indicativo do país e sem o sinal de mais. Os campos de telefone do Salesforce guardam o que quem criou o registo introduziu, com espaços, parênteses e hífenes.

A abordagem fiável é um campo de texto personalizado com o número só em dígitos, preenchido pelo workflow ao criar um lead e por uma carga retroativa nos registos existentes. A consulta SOQL compara depois esse campo por igualdade, o que é rápido e exato.

Verifique também os contactos, não só os leads. Um cliente que já foi convertido é um Contact, e um workflow que procure apenas leads cria um lead novo por cada cliente existente que escreva.

- Procurar apenas no objeto Lead. Os clientes existentes são Contacts, e cada um que escreva torna-se um lead duplicado.
- Registar as mensagens como tarefas em aberto. Os comerciais recebem uma tarefa por cada linha do cliente; defina o estado como concluída ao criá-las.
- Omitir o ramo de verificação GET no workflow. A Meta nunca confirma o destino e nenhuma mensagem chega a ser entregue.

**Preciso de um pacote do Salesforce AppExchange para isto?** Não. O nó Salesforce incluído no n8n trata da pesquisa, do lead e da tarefa, e o que lhe faltar pode passar pelo nó HTTP Request com a mesma credencial.

**O Make consegue fazer o mesmo?** Sim. Um webhook personalizado do Make recebe a mensagem e os módulos do Salesforce escrevem os registos. A estrutura do cenário corresponde ao workflow do n8n passo a passo.

**O Salesforce pode enviar um template do WhatsApp a um lead?** Através do workflow, sim. Faça o Salesforce chamar um webhook do n8n, e o n8n envia o template aprovado pela Cloud API com o phone number id e o token do número.

**A EasyCoexistence guarda uma cópia das mensagens?** Não. A Meta entrega cada webhook diretamente ao seu URL do n8n, e a EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Ligar o WhatsApp ao Zoho CRM num número em Coexistência

https://easycoexistence.com/pt-pt/integrations/zoho-crm

Encaminhe os webhooks do número para um workflow do n8n, pesquise no Zoho CRM com o parâmetro phone, que verifica todos os campos de telefone de um módulo, crie um Lead quando nada corresponder e adicione cada mensagem como nota no registo. O nó Zoho CRM do n8n trata de leads e contactos; a nota é uma única chamada HTTP à API Notes do Zoho, com a mesma credencial.

### Como se transforma uma mensagem de WhatsApp num registo do Zoho CRM?

A Meta envia cada mensagem do número para o destino de webhook definido, aqui um nó Webhook do n8n. O workflow retira o número do remetente do payload e chama o endpoint de pesquisa do Zoho com phone definido para esse número, primeiro em Leads e depois em Contacts. O Zoho verifica todos os campos de telefone do módulo, pelo que uma correspondência em Mobile ou em Phone conta nos dois casos, o que evita ter de adivinhar qual o campo que um comercial usou.

Quando nada é devolvido, o nó Zoho CRM do n8n cria um Lead com o nome de perfil do WhatsApp e o número. Em qualquer dos casos, o workflow passa a ter um id de registo e escreve a mensagem como nota nesse registo através de POST /Notes. Uma nota só precisa de Note_Content e de um Parent_Id que indique o módulo e o registo.

### Que permissões do Zoho precisa a credencial do n8n?

Leitura e criação nos módulos que se pesquisam e onde se escreve, mais criação em Notes. O Zoho dá ao âmbito das notas o nome ZohoCRM.modules.notes.CREATE e exige a seu lado o âmbito de criação do módulo principal, pelo que uma credencial que consiga criar Leads, mas à qual nunca foi atribuído o âmbito de notas, falha no último passo com um erro de autorização.

O nó Zoho CRM do n8n abrange Leads, Contacts, Accounts, Deals e vários documentos de vendas, com create, upsert, get, get all, update e delete. As notas não fazem parte dos seus recursos, e por isso a nota passa por um nó HTTP Request. O n8n permite que esse nó reutilize a credencial do Zoho já ligada, pelo que há uma só autorização OAuth para gerir, em vez de duas.

Defina o domínio da API para o seu centro de dados do Zoho. Uma credencial criada na região da UE chama zohoapis.eu, não zohoapis.com.

### Quantas mensagens consegue o Zoho CRM absorver?

O Zoho mede a sua API em créditos por cada 24 horas contínuas, e o orçamento depende da edição e do número de utilizadores. A edição Free recebe 5 000. A Standard recebe 50 000 mais 250 por utilizador, a Professional 50 000 mais 500 por utilizador e a Enterprise 50 000 mais 1 000 por utilizador, cada uma com um limite máximo por edição.

Cada mensagem recebida custa uma pesquisa e a escrita de uma nota, mais a criação de um lead no caso de remetentes novos. Isso fica confortavelmente dentro do orçamento de uma edição paga para o número de uma pequena empresa. O limite que costuma pesar primeiro é a concorrência: a Free permite 5 chamadas em simultâneo e a Standard 10, pelo que um pico de mensagens, vindo de respostas a uma difusão, pode ficar em fila. Configure o workflow do n8n para processar as execuções uma de cada vez, se o Zoho devolver erros de limite.

### As respostas enviadas a partir do telemóvel chegam ao Zoho CRM?

Podem chegar. Num número em Coexistência, a app do WhatsApp Business continua a funcionar e, quando alguém responde a partir dela, a Meta envia um eco dessa mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Dê ao workflow um ramo para os ecos e escreva-os como notas com título de mensagem enviada. O comercial que abre o lead no Zoho lê assim os dois lados da conversa, e ninguém tem de colar capturas de ecrã no CRM.

As mensagens que o próprio workflow envia através da Cloud API, como um template aprovado após a mudança de fase de um negócio, convém registá-las no momento do envio, porque o workflow já tem o texto e o id do registo.

- Atribuir à credencial os âmbitos de leads, mas não ZohoCRM.modules.notes.CREATE. A pesquisa e o lead funcionam e, depois, todas as notas falham.
- Chamar zohoapis.com a partir de uma conta alojada noutro centro de dados do Zoho. Use o domínio da API da região onde a conta se encontra.
- Pesquisar apenas em Leads. Os clientes convertidos são Contacts, e cada um que escreve transforma-se num lead duplicado novo.

**Isto substitui a integração de WhatsApp do próprio Zoho?** É um caminho diferente. Aqui o número fica ligado através da EasyCoexistence e o Zoho CRM recebe os registos pela sua API, enquanto a equipa responde a partir do telemóvel ou do workflow.

**Posso usar o Make em vez do n8n?** Sim. Um webhook personalizado do Make recebe a mensagem, e os módulos do Zoho CRM ou um módulo HTTP tratam da pesquisa, do lead e da nota.

**Uma mudança de fase de um negócio pode enviar um template de WhatsApp?** Sim, através do workflow. Faça a mudança de fase chamar o URL de um webhook do n8n, e o n8n envia o template aprovado pela Cloud API, com o phone number id e o token do número.

**As mensagens ficam guardadas na EasyCoexistence?** Não. A Meta entrega o webhook diretamente no seu URL do n8n. A EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Ligar o WhatsApp ao Pipedrive num número Coexistence

https://easycoexistence.com/pt-pt/integrations/pipedrive

Encaminhe os webhooks do número para um workflow n8n, pesquise pessoas no Pipedrive pelo telefone, crie a pessoa e um lead quando não houver correspondência e registe cada mensagem como nota na pessoa ou no negócio. O nó Pipedrive do n8n faz tudo isto. A equipa continua a responder a partir da app WhatsApp Business e as suas respostas também podem ser registadas.

### Como chega uma mensagem do WhatsApp a uma pessoa do Pipedrive?

A Meta envia cada mensagem do número para o destino do webhook definido para ele, aqui um nó Webhook do n8n. O workflow pesquisa pessoas no Pipedrive com o número do remetente; a pesquisa de pessoas do Pipedrive abrange o campo do telefone e aceita um indicador de correspondência exata. Quando devolve uma pessoa, o workflow usa esse id. Quando não devolve nenhuma, cria uma pessoa com o nome de perfil do WhatsApp e o número, e depois um lead associado, de modo que a primeira mensagem de um desconhecido aparece na Leads Inbox para alguém a qualificar.

A própria mensagem passa a ser uma nota. Uma nota do Pipedrive precisa apenas do conteúdo, que aceita HTML, e de pelo menos um id de pessoa, negócio, organização ou lead. Associe-a ao negócio aberto, quando existir, e à pessoa nos restantes casos.

### Porque é que o passo de pesquisa é o primeiro a atingir os limites?

Porque o Pipedrive dá à pesquisa uma quota própria, muito mais pequena. As chamadas gerais à API são limitadas por utilizador numa janela deslizante de dois segundos, desde 20 pedidos no Lite com um token de API até 120 no Ultimate. A Search API fica limitada a 10 pedidos por dois segundos em todos os planos.

Um número com pouco movimento nunca dá por isso. Um número que envia um template a algumas centenas de clientes e recebe cinquenta respostas num minuto dá, porque cada resposta começa com uma pesquisa. O workflow passa então a receber respostas 429 e, sem repetição, perde a nota.

Duas medidas resolvem. Ative as repetições com espera no nó de pesquisa do Pipedrive e guarde em cache a correspondência entre telefone e id da pessoa, nos dados estáticos do workflow do n8n ou numa pequena tabela, para que um cliente que envia seis mensagens seguidas custe uma pesquisa e não seis.

### As respostas escritas no telemóvel também podem ser registadas?

Sim. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número e, quando alguém da equipa responde por ela, a Meta envia um eco da mensagem enviada para o mesmo destino do webhook, no campo smb_message_echoes.

Acrescente um ramo para esses ecos e registe-os como notas marcadas como enviadas, ou como atividades concluídas se a sua equipa reporta por número de atividades. Um comercial que abra o negócio vê então o que o cliente perguntou e o que a loja respondeu, por ordem.

Para as mensagens que o próprio workflow envia, como um template quando um negócio muda de fase, registe a nota no momento do envio. O workflow já tem o texto e o id do negócio, por isso não há motivo para esperar por um webhook.

### Como se deve normalizar o número de telefone?

Para dígitos com o indicativo do país e mais nada, porque é isso que a Meta envia. Um remetente chega como 14155550188, enquanto uma pessoa introduzida à mão no Pipedrive pode ter +1 (415) 555-0188.

Quando o workflow cria uma pessoa, guarde o número nessa forma só com dígitos, para que os seus próprios registos coincidam sempre. Para as pessoas criadas à mão, uma limpeza única no n8n que reescreva os telefones existentes na mesma forma compensa logo na primeira semana. Sem ela, a pesquisa de correspondência exata não encontra as pessoas que a equipa introduziu e o workflow cria um duplicado para cada uma.

Mantenha a formatação original num segundo telefone, se a equipa gostar de a ler assim. As pessoas do Pipedrive podem ter mais do que um telefone.

- Fazer uma pesquisa por mensagem sem cache. As rajadas de respostas esbarram no limite de 10 pedidos por dois segundos da Search API e perdem-se notas.
- Criar um lead por cada mensagem em vez de um por cada pessoa nova. A Leads Inbox enche-se de cópias do mesmo cliente.
- Associar as notas só à pessoa quando há um negócio aberto. O comercial que trabalha o negócio nunca vê a conversa.

**As mensagens vão aparecer na caixa de entrada de Mensagens do Pipedrive?** Não. Este caminho escreve notas e leads através da API do Pipedrive. As conversas são respondidas a partir da app WhatsApp Business ou pelo workflow e ficam registadas na pessoa ou no negócio.

**Posso usar o Make ou o Zapier em vez do n8n?** Sim. Um webhook personalizado ou catch hook recebe a mensagem, e os passos do Pipedrive ou um passo HTTP escrevem a pessoa, o lead e a nota pela mesma ordem.

**Uma mudança de fase de um negócio pode enviar um template do WhatsApp?** Sim, através do workflow. Quando a mudança de fase chama o URL de um webhook do n8n, o n8n envia o template aprovado pela Cloud API, com o phone number id e o token do número.

**A EasyCoexistence guarda as mensagens?** Não. A Meta entrega cada webhook diretamente no seu URL do n8n e a EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Ligar o WhatsApp ao CRM Bitrix24 num número Coexistence

https://easycoexistence.com/pt-pt/integrations/bitrix24

Encaminhe os webhooks do número para um workflow do n8n e faça-o chamar o Bitrix24 através do URL de um webhook de entrada. O crm.duplicate.findbycomm encontra o lead, contacto ou empresa a que pertence o telefone do remetente, o crm.lead.add cria um lead quando não existe nenhum e o crm.timeline.comment.add escreve a mensagem na cronologia do registo. A equipa continua a responder a partir da app WhatsApp Business.

### Como comunica o n8n com o Bitrix24?

Através de um webhook de entrada, que no Bitrix24 não é um recetor mas uma credencial. Cria-se nos recursos para programadores do Bitrix24, escolhem-se os âmbitos que pode usar e obtém-se um URL com o endereço do portal, o id do utilizador que o criou e um código secreto. Ao acrescentar o nome de um método a esse URL, chama-se a API REST como esse utilizador, com as permissões desse utilizador.

Assim, no n8n cada passo do Bitrix24 é um nó HTTP Request que faz um pedido POST a esse URL mais um método, como crm.lead.add.json. Não há fluxo OAuth para concluir nem app para publicar. Dê ao webhook apenas o âmbito do CRM e crie-o a partir de um utilizador cujas permissões abranjam os leads e contactos que o workflow deve ver, já que o Bitrix24 verifica o acesso como esse utilizador.

### Que métodos do Bitrix24 chama o workflow?

Três, por ordem, depois de o nó Webhook do n8n receber a mensagem da Meta.

O crm.duplicate.findbycomm com o tipo PHONE e o número do remetente devolve os ids de quaisquer leads, contactos e empresas que o tenham. É a pesquisa certa porque procura nos três ao mesmo tempo e foi concebida para correspondência por meios de comunicação, e não por um campo de texto.

Quando não devolve nada, o crm.lead.add cria um lead com o nome do perfil do WhatsApp como título e o número no campo de telefone. Depois, o crm.timeline.comment.add escreve o texto da mensagem como comentário no registo, com ENTITY_TYPE, ENTITY_ID e COMMENT. O comentário aparece na cronologia do registo ao lado das chamadas e dos emails, onde um comercial já costuma olhar.

### Como condiciona o limite de pedidos o workflow?

O Bitrix24 mede os pedidos REST com um balde com fuga. Cada pedido soma ao contador, o contador desce a um ritmo fixo por segundo e, quando ultrapassa um limite, o pedido seguinte recebe um 503 com QUERY_LIMIT_EXCEEDED. Nos planos Enterprise o contador desce 5 por segundo, com limite de 250; em todos os outros planos desce 2, com limite de 50.

Cada mensagem recebida custa dois ou três pedidos, pelo que um fluxo constante nunca se aproxima do limite. Um pico já se aproxima: cinquenta clientes a responder ao mesmo template no espaço de um minuto são até 150 pedidos. Configure os nós HTTP Request para voltar a tentar em caso de falha, com uma espera curta, e execute as execuções do workflow uma de cada vez, para que o pico seja absorvido pelo Bitrix24 em vez de ser rejeitado.

### As respostas escritas no telemóvel chegam ao Bitrix24?

Podem chegar. Num número Coexistence, a app WhatsApp Business continua a funcionar e, quando alguém responde a partir dela, a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Um segundo ramo do workflow trata esses ecos do mesmo modo que as mensagens recebidas, com o comentário marcado como enviado. O registo passa então a mostrar a conversa completa, com as falas do cliente e as respostas da loja por ordem.

As respostas que o próprio workflow envia através da Cloud API já estão nas mãos do workflow quando saem, por isso registe-as nesse momento em vez de esperar que um webhook volte.

- Colar o URL do webhook de entrada em código do lado do cliente ou num documento partilhado. O segredo que contém concede todos os âmbitos atribuídos ao webhook.
- Criar o webhook a partir de um utilizador que não vê todos os leads. As pesquisas falham registos e o workflow cria duplicados.
- Enviar um pico de pedidos sem repetições. O Bitrix24 responde 503 QUERY_LIMIT_EXCEEDED e essas mensagens nunca chegam à cronologia.

**As conversas aparecem nos Canais Abertos do Bitrix24?** Não com este workflow. Escreve leads e comentários na cronologia através da API REST do CRM, e a conversa é respondida a partir da app WhatsApp Business ou pelo workflow.

**Posso usar o Make em vez do n8n?** Sim. Um webhook personalizado do Make recebe a mensagem e módulos HTTP chamam os mesmos três métodos no URL do webhook de entrada.

**O workflow pode enviar um template do WhatsApp com dados do Bitrix24?** Sim. O n8n lê do Bitrix24 o que precisa e envia o template aprovado através da Cloud API, com o phone number id e o token do número.

**A EasyCoexistence guarda as mensagens?** Não. A Meta entrega cada webhook diretamente no seu URL do n8n. A EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Transforme contactos do WhatsApp em conversões no RD Station Marketing

https://easycoexistence.com/pt-pt/integrations/rd-station

Encaminhe os webhooks do número para um fluxo de trabalho do n8n e, por cada remetente, envie um POST com um evento de conversão para o RD Station Marketing em api.rd.services/platform/conversions, com a sua chave de API. O RD Station aceita um telefone em vez de um email, pelo que um contacto do WhatsApp sem email passa na mesma a lead, com etiquetas e pronto para os seus fluxos de automação. A equipa continua a responder a partir do telemóvel.

### Como se transforma uma mensagem do WhatsApp num lead do RD Station?

A Meta envia cada mensagem recebida no número para o destino de webhook que definir, neste caso um nó Webhook do n8n. O fluxo de trabalho lê o número do remetente e o nome de perfil no payload e envia um único POST HTTP para o endpoint de conversões do RD Station Marketing, com a chave de API na query string.

O corpo leva event_type definido como CONVERSION, event_family definido como CDP e um payload com um conversion_identifier à sua escolha, por exemplo whatsapp-inbound. Dentro do payload seguem o nome, o mobile_phone e as etiquetas que quiser. O RD Station cria o contacto se for novo e regista a conversão em qualquer caso, pelo que o histórico do contacto mostra que entrou pelo WhatsApp e quando.

A partir daí, trabalha-se no RD Station como habitualmente: segmenta-se pela conversão ou pela etiqueta e deixa-se os fluxos de automação assumir.

### Cada mensagem deve ser uma conversão?

Não, e esta é a decisão de desenho mais importante. Um cliente que envie oito linhas curtas seguidas registaria oito conversões, o que infla os relatórios e pode disparar o mesmo fluxo de automação oito vezes.

Converta na primeira mensagem de um número, ou na primeira mensagem após um intervalo que escolha, por exemplo trinta dias. O n8n pode guardar a data da última conversão por número nos dados estáticos do fluxo de trabalho ou numa pequena tabela e ignorar a chamada quando for recente.

Use um conversion_identifier distinto para tudo o que seja mais específico do que o primeiro contacto. Uma resposta a um template promocional, uma mensagem com uma palavra-chave ou o toque num botão de uma mensagem interativa podem ser, cada um, a sua própria conversão, o que dá ao RD Station segmentos limpos em vez de um fluxo indiferenciado.

### O RD Station pode disparar uma mensagem de WhatsApp de resposta?

Através do fluxo de trabalho, sim. O RD Station Marketing pode disparar um webhook quando um lead converte ou é marcado como oportunidade, e um webhook do n8n do outro lado pode enviar um template aprovado do WhatsApp através da Cloud API, com o phone number id e o token de acesso do número, obtidos no painel do EasyCoexistence.

Os templates são importantes aqui porque o lead pode não ter escrito nas últimas 24 horas. Fora dessa janela, só um template aprovado pela Meta é entregue; o texto livre falha. Dentro dela, uma resposta de texto normal funciona.

A app do WhatsApp Business no telemóvel mostra também essas mensagens enviadas, porque a Coexistence mantém a app e a API no mesmo número. Um vendedor que retome a conversa no telemóvel vê o que a automação já disse.

- Enviar uma conversão por cada mensagem. Um cliente conversador regista outras tantas conversões e repete o mesmo fluxo de automação.
- Enviar a chave de API a partir de uma página de browser que qualquer pessoa pode ler. Mantenha a chamada dentro do fluxo de trabalho do n8n, onde a chave permanece privada.
- Enviar texto livre a partir de um fluxo disparado pelo RD a um lead que não escreveu nas últimas 24 horas. Nesse caso, só um template aprovado é entregue.

**Preciso de OAuth para esta chamada ao RD Station?** Não. O endpoint de conversões autentica-se com a chave de API na query string, e enviar eventos de conversão é exatamente para o que essa chave serve.

**E se o contacto do WhatsApp não tiver email?** Envie o telefone. O RD Station só exige um email numa conversão quando não é indicado nenhum telefone.

**Posso usar o Make ou o Zapier em vez do n8n?** Sim. Qualquer ferramenta que receba o webhook e faça um POST HTTP pode enviar o mesmo corpo de conversão para o RD Station.

**O EasyCoexistence guarda as mensagens?** Não. A Meta entrega o webhook no seu URL do n8n, e o EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Ligar o WhatsApp aos contactos do GoHighLevel num número Coexistence

https://easycoexistence.com/pt-pt/integrations/gohighlevel

Encaminhe os webhooks do número para um workflow n8n, crie ou atualize o remetente como contacto HighLevel com o nó HighLevel do n8n e escreva cada mensagem como nota através de POST /contacts/{contactId}/notes. Autentique com um token Private Integration obtido nas definições da subconta. Um só workflow pode servir todos os clientes, associando cada phone number id à respetiva subconta.

### Como chega uma mensagem de WhatsApp a um contacto do HighLevel?

A Meta envia cada mensagem recebida no número para o destino de webhook definido, neste caso um nó Webhook do n8n. O workflow passa o número do remetente e o nome de perfil do WhatsApp ao nó HighLevel do n8n, cujo recurso de contactos tem uma operação de criar ou atualizar. Assim, um novo remetente passa a ser um contacto e um remetente conhecido é encontrado em vez de duplicado.

Com o id do contacto disponível, um nó HTTP Request envia o corpo da mensagem para /contacts/{contactId}/notes. A nota aparece no registo do contacto, onde quem o abrir vê o que o cliente escreveu. Quando a mensagem exige seguimento, o nó HighLevel também pode criar uma tarefa no contacto ou uma oportunidade num pipeline, duas operações que suporta diretamente.

A equipa continua a responder a partir da app do WhatsApp Business durante todo o processo.

### Que token deve usar o workflow?

Um token Private Integration. A API v2 do HighLevel é acedida com OAuth ou com um destes tokens, e as antigas chaves da API v1 chegaram ao fim de vida. O token Private Integration cria-se nas definições da subconta, com o âmbito das permissões que assinalar, e envia-se no cabeçalho Authorization como qualquer token de acesso.

Não se renova sozinho, o que convém a uma automação: continua a funcionar até alguém o rodar. Quando o rodar, o HighLevel mantém o token antigo e o novo válidos em simultâneo durante sete dias, que é o prazo para colar o novo no n8n antes de o antigo deixar de funcionar.

Assinale apenas os âmbitos de que o workflow precisa: contactos, notas e, se os usar, oportunidades e tarefas. Se não encontrar as Private Integrations nas definições, o HighLevel indica que deve ativá-las em Labs.

### Como serve um só workflow várias subcontas de clientes?

Encaminhando pelo número que recebe a mensagem. Todos os webhooks enviados pela Meta incluem o phone_number_id do número empresarial que recebeu a mensagem. Aponte o número de cada cliente para o mesmo webhook do n8n, mantenha uma pequena tabela que associe cada phone_number_id à subconta desse cliente e ao respetivo token, e consulte o token no início de cada execução.

Deste modo, há um único workflow para manter em todos os clientes, o que importa a uma agência mais do que a qualquer outro. Uma correção na lógica de correspondência ou no formato da nota chega a todos de uma só vez.

Os limites de pedidos são contados por app e por subconta, pelo que os clientes não consomem a quota uns dos outros: cada um tem os seus 100 pedidos por cada dez segundos e 200 000 por dia.

### As respostas escritas no telemóvel chegam ao HighLevel?

Podem chegar. Num número Coexistence, a app do WhatsApp Business continua em uso, e quando alguém responde a partir dela a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Acrescente um ramo para esses ecos e escreva-os como notas marcadas como enviadas. O registo do contacto fica assim com as mensagens do cliente e as respostas da empresa por ordem, que é o que um cliente espera ver ao abrir o seu CRM.

Quando o próprio workflow envia uma mensagem pela Cloud API, por exemplo um template aprovado depois de marcada uma consulta, escreva a nota no momento do envio. O workflow já tem o texto e o id do contacto.

- Usar uma chave da API v1. A API v1 do HighLevel chegou ao fim de vida; a API v2 exige um token Private Integration ou OAuth.
- Rodar o token Private Integration sem atualizar o n8n dentro dos sete dias de sobreposição. Todas as chamadas falham quando o token antigo expira.
- Escrever as mensagens de todos os clientes com o token de uma só subconta. Associe primeiro o phone_number_id à subconta certa, ou os registos vão parar ao cliente errado.

**As mensagens aparecem no separador Conversations do HighLevel?** Não com este workflow. Escreve contactos, notas, tarefas e oportunidades através da API, e a conversa é respondida a partir da app do WhatsApp Business ou pelo workflow.

**Posso usar o Make ou o Zapier em vez do n8n?** Sim. Um webhook personalizado ou catch hook recebe a mensagem e um passo HTTP chama a API v2 do HighLevel com o mesmo token.

**Uma marcação pode enviar uma confirmação por WhatsApp?** Sim, através do workflow. Quando o HighLevel chama o URL de um webhook do n8n, o n8n envia um template aprovado pela Cloud API com o phone number id e o token do número.

**A EasyCoexistence guarda as mensagens?** Não. A Meta entrega cada webhook diretamente no seu URL do n8n, e a EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Use um número Coexistence como caixa de entrada WhatsApp Cloud do Chatwoot

https://easycoexistence.com/pt-pt/integrations/chatwoot

A caixa de entrada WhatsApp Cloud do Chatwoot pede três valores: o id da WhatsApp Business Account, o phone number id e um token de acesso. Um número Coexistence disponibiliza os três. Crie a caixa de entrada com eles, defina o destino do webhook do número como o URL de webhook do Chatwoot, com o mesmo verify token, e a equipa pode responder a partir do Chatwoot e do telemóvel.

### Como se liga um número Coexistence ao Chatwoot?

Em dois locais, por esta ordem.

No Chatwoot, adicione uma caixa de entrada, escolha WhatsApp e selecione o fornecedor WhatsApp Cloud com a configuração manual. Introduza o número, o phone number id, o id da WhatsApp Business Account e o token de acesso, que o painel da EasyCoexistence mostra para a ligação, ou que get_api_credentials devolve a um assistente. O Chatwoot apresenta então um URL de webhook e um webhook verify token para a caixa de entrada.

Na EasyCoexistence, defina o destino do webhook do número como esse URL e introduza o mesmo verify token. A Meta envia o pedido de verificação ao Chatwoot, o Chatwoot responde-lhe e, a partir daí, todas as mensagens para o número chegam à caixa de entrada. Nada corre pelo meio, por isso não há nenhum workflow para manter ativo.

### As respostas enviadas do telemóvel aparecem no Chatwoot?

Sim. Num número Coexistence, uma resposta escrita na app WhatsApp Business é comunicada pela Meta como um evento smb_message_echoes, e o job de webhook do Chatwoot reconhece esse campo e regista a mensagem como enviada, na conversa certa. O código-fonte descreve o caso diretamente: empresas que respondem tanto a partir do Chatwoot como da app, com as mensagens sincronizadas no Chatwoot.

Isto faz a divisão funcionar na prática. O proprietário pode continuar a responder aos clientes habituais a partir do telemóvel, a equipa pode trabalhar a caixa de entrada partilhada numa secretária, e cada um vê o que o outro enviou sem que ninguém reencaminhe capturas de ecrã.

As mensagens enviadas do Chatwoot saem pela Cloud API no mesmo número, pelo que também aparecem no telemóvel.

### Porque é que a caixa de entrada do Chatwoot não deve ter app secret?

Porque as entregas são assinadas com um segredo que não possui. A Meta assina cada webhook com o app secret da app titular da subscrição, que é a app da EasyCoexistence, e esse segredo nunca é partilhado.

No código atual do Chatwoot, o cabeçalho X-Hub-Signature-256 só é verificado num canal WhatsApp Cloud configurado manualmente quando existe um app secret guardado nesse canal, ou quando o canal foi criado através do embedded signup do próprio Chatwoot. Uma caixa de entrada manual sem app secret aceita as entregas; uma com qualquer app secret preenchido rejeita todas como não autorizadas.

O verify token é a proteção que se aplica aqui. Escolha um valor aleatório e longo, pois é ele que permite ao Chatwoot distinguir o pedido de verificação da Meta de qualquer outro.

### O que não pode o Chatwoot fazer neste número?

Receber webhooks em dois locais ao mesmo tempo. A Meta encaminha os webhooks de um número para um único destino, pelo que, enquanto o Chatwoot o ocupa, um workflow do n8n não recebe os mesmos eventos. Se precisar dos dois, aponte o destino para um pequeno relay seu que reencaminhe cada entrega para o Chatwoot e para o workflow.

Os limites da Coexistence aplicam-se como em qualquer outro lado: a API envia até 20 mensagens por segundo, o texto livre só pode ser enviado nas 24 horas seguintes à última mensagem do cliente, e os templates cobrem tudo o que vem depois.

A app WhatsApp Business continua a precisar de ser aberta pelo menos uma vez de 14 em 14 dias, algo que a EasyCoexistence vigia.

- Preencher um app secret na caixa de entrada do Chatwoot. As entregas são assinadas com o segredo da app da EasyCoexistence, por isso o Chatwoot rejeita todas como não autorizadas.
- Usar na EasyCoexistence um verify token diferente do que o Chatwoot mostra. A verificação da Meta falha e a caixa de entrada nunca recebe nenhuma mensagem.
- Escolher o embedded signup do Chatwoot em vez do fluxo manual. Isso liga o número através da app Meta do próprio Chatwoot, que é uma ligação separada.

**Isto funciona num Chatwoot self-hosted?** Sim. O URL do webhook usa o seu próprio domínio do Chatwoot em vez de app.chatwoot.com, e o resto da configuração é igual.

**Preciso de uma app Meta própria para o Chatwoot?** Não. O número é ligado através da EasyCoexistence, que fornece as credenciais e encaminha os webhooks. O guia do Chatwoot descreve a criação de uma app Meta apenas porque parte do princípio de que não tem nenhuma.

**Podem entrar vários números no Chatwoot?** Sim. Crie uma caixa de entrada WhatsApp Cloud por número e defina o destino do webhook de cada número como o URL e o verify token da respetiva caixa de entrada.

**A EasyCoexistence vê as conversas?** Não. A Meta entrega os webhooks diretamente ao Chatwoot, e a EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Registar mensagens do WhatsApp no Airtable e enviar a partir de uma base

https://easycoexistence.com/pt-pt/integrations/airtable

O trigger de webhook de entrada do Airtable só aceita pedidos POST, por isso não consegue responder ao GET de verificação da Meta e não pode ser o destino do webhook de um número. Aponte o destino para um workflow n8n que acrescenta cada mensagem a uma tabela. O envio faz-se a partir do próprio Airtable: uma automação Run a script pode chamar a Cloud API com fetch e o token do número guardado como segredo.

### Porque é que o Airtable não consegue receber webhooks do WhatsApp diretamente?

Porque a Meta verifica um destino antes de entregar seja o que for. Envia um pedido GET com um valor de desafio e espera receber esse mesmo valor no corpo da resposta. O trigger When webhook received do Airtable só aceita pedidos POST e responde com o seu próprio JSON fixo, pelo que a verificação não passa e a Meta nunca começa a entregar.

A solução é um passo intermédio. Um nó Webhook do n8n trata da verificação e recebe cada mensagem, e o nó Airtable do n8n acrescenta uma linha: remetente, nome de perfil, texto, id da mensagem, data e hora e o phone number id que recebeu a mensagem. A mesma estrutura funciona no Make ou no Zapier.

O passo intermédio tem uma segunda vantagem. O trigger de webhook do Airtable admite cinco pedidos por segundo, e uma ferramenta de workflows consegue pôr em fila um pico que, de outro modo, seria recusado.

### Como se envia um template do WhatsApp a partir de uma base do Airtable?

Com uma automação cuja ação seja Run a script. O trigger pode ser um registo a entrar numa vista, um campo a mudar ou um botão a ser clicado. O script lê o telemóvel e os campos do registo através de input.config() e chama o endpoint de mensagens da Cloud API com fetch. Os scripts de automação do Airtable correm no servidor, por isso não há restrições de navegador pelo caminho.

Guarde o token de acesso como segredo no editor de scripts, e não no código. O Airtable oculta os segredos na saída da consola e só permite a edição a quem tenha acesso a todos os segredos de um script.

Use um template para tudo o que o cliente não tenha originado nas últimas 24 horas, já que o texto livre só é entregue dentro dessa janela. O script pode gravar no registo o id da mensagem devolvido, o que associa o envio à linha.

### Como deve ser a tabela de mensagens?

Uma linha por mensagem, com o id da mensagem do WhatsApp como campo principal. A Meta repete as entregas que considera falhadas, e um workflow que procura o id antes de acrescentar nunca grava a mesma mensagem duas vezes.

Mantenha um campo de direção com inbound e outbound. Num número Coexistence, as respostas que a equipa escreve na app do WhatsApp Business chegam ao mesmo webhook como eventos smb_message_echoes, e registá-las como linhas outbound dá à base a conversa completa, e não apenas um dos lados.

Associe cada mensagem a uma tabela Contactos, com chave no número de telemóvel só com dígitos, que é o formato que a Meta envia. Um rollup mostra então a hora da última mensagem recebida de cada contacto, e esse único campo é o que uma automação precisa para decidir entre texto livre e template.

- Definir um URL de webhook do Airtable como destino do número. Só aceita POST, o GET de verificação da Meta falha e nada é entregue.
- Colar o token de acesso no corpo do script. Guarde-o como segredo do script para que fique fora do código e dos registos.
- Enviar texto livre a partir de uma automação de registos a alguém que não escreve há mais de 24 horas. Só um template aprovado é entregue.

**A ação Run a script está disponível no plano gratuito do Airtable?** O Airtable indica a ação em todos os tipos de plano, com limitações variáveis, e refere que não está disponível numa avaliação do plano Team.

**Posso dispensar o n8n e usar o Make ou o Zapier?** Sim. Qualquer um dos três pode receber o webhook, responder à verificação e acrescentar a linha. O Airtable é a única peça que não pode ser o destino.

**Um botão do Airtable pode enviar uma mensagem de WhatsApp?** Sim. Use o trigger When a button is clicked com uma ação Run a script que chame a Cloud API, e os dados da linha preenchem o template.

**A EasyCoexistence guarda as mensagens?** Não. A Meta entrega cada webhook ao seu URL do n8n, e a única cópia é a que o seu workflow grava no Airtable.

---

## Registar mensagens WhatsApp no Google Sheets e enviar a partir de uma folha

https://easycoexistence.com/pt-pt/integrations/google-sheets

Aponte o destino do webhook do número para um workflow n8n cujo nó Google Sheets acrescenta uma linha por mensagem: remetente, nome, texto, id da mensagem e hora. Para enviar a partir de uma folha, uma função Apps Script pode percorrer as linhas e chamar a Cloud API com UrlFetchApp, usando o phone number id e o token do número. A equipa continua a responder a partir da app WhatsApp Business.

### Como se transforma cada mensagem WhatsApp numa linha?

A Meta envia cada mensagem do número para o destino do webhook que definir, aqui um nó Webhook do n8n que também responde ao pedido de verificação da Meta. O nó seguinte é o Google Sheets com a operação Append Row, que mapeia campos do payload para colunas: o número do remetente, o nome de perfil, o texto, o id da mensagem WhatsApp, a data e hora e o phone number id de receção.

Use Append or Update Row com chave no id da mensagem, em vez de um simples acrescento, se quiser que as repetições sejam inofensivas. A Meta volta a entregar uma mensagem quando considera que a entrega falhou, e a chave no id transforma a segunda entrega numa atualização da mesma linha.

Num número Coexistence, as respostas escritas na app WhatsApp Business chegam ao mesmo webhook como eventos smb_message_echoes. Registe-as com uma coluna de direção e a folha fica com os dois lados da conversa.

### Onde é que a quota do Sheets se faz sentir?

Nas escritas por utilizador. A API Sheets permite 300 pedidos de escrita por minuto por projeto e 60 por minuto por utilizador por projeto, e uma credencial n8n corresponde a um utilizador. Um workflow que acrescenta uma linha por mensagem consegue assim cerca de uma mensagem por segundo, de forma sustentada.

Isso chega para a maioria dos números de lojas. Deixa de chegar depois de um template de difusão, quando algumas centenas de clientes respondem em poucos minutos. A API responde então 429 Too Many Requests e, sem repetições, perdem-se linhas.

Há duas soluções, e qualquer uma basta. Ative as repetições com espera no nó Google Sheets, o que corresponde ao conselho da própria Google de abrandar de forma exponencial. Ou agrupe: faça o n8n recolher mensagens durante trinta segundos e acrescente-as num só pedido, o que converte muitas escritas numa.

### Como se enviam templates a partir de uma folha?

Com Apps Script, a partir do menu Extensões da folha. Uma função lê as linhas ainda não enviadas, chama o endpoint de mensagens da Cloud API com UrlFetchApp para cada uma e escreve na linha o id da mensagem devolvido e a hora. Um acionador temporal pode executá-la de poucos em poucos minutos, ou pode executá-la manualmente a partir de um menu personalizado.

Guarde o token de acesso nas propriedades do script e não no código, para que quem puder ver o script não o veja.

Tenha as quotas presentes. Uma conta Google de consumidor tem 20 000 chamadas URL Fetch por dia e uma conta Workspace 100 000, e cada execução pára ao fim de seis minutos. Processe as linhas por blocos e marque cada uma como enviada antes de avançar, para que uma execução interrompida retome onde ficou em vez de enviar duas vezes.

- Acrescentar sem chave no id da mensagem. As repetições da Meta escrevem então a mesma mensagem em duas linhas.
- Escrever uma linha por mensagem através de uma única credencial durante um pico de respostas. O limite de 60 escritas por minuto por utilizador devolve 429 e perdem-se linhas.
- Enviar texto livre a partir da folha a pessoas que não escreveram nas últimas 24 horas. Fora dessa janela, só um template aprovado é entregue.

**Posso usar o Make ou o Zapier em vez do n8n?** Sim. Um webhook personalizado do Make ou um catch hook do Zapier recebe a mensagem e o respetivo passo Google Sheets acrescenta a linha.

**Com que conta Google escreve o n8n?** Com a que autorizou a credencial Google do n8n. Essa conta precisa de acesso de edição à folha, e a sua quota de escrita por utilizador é a que o workflow consome.

**A coluna do telefone está formatada corretamente?** Guarde os números como texto simples, com os dígitos e o indicativo do país e sem o sinal de mais, que é a forma como a Meta os envia. Caso contrário, o Sheets trata-os como números, o que elimina o sinal de mais inicial e pode reformatar valores longos.

**A EasyCoexistence guarda uma cópia das mensagens?** Não. A Meta entrega cada webhook ao seu URL do n8n, e a folha é a única cópia.

---

## Receber webhooks do WhatsApp numa Edge Function do Supabase

https://easycoexistence.com/pt-pt/integrations/supabase

Uma Edge Function do Supabase pode ser diretamente o destino do webhook do número. Responde ao GET de verificação da Meta com o valor de hub.challenge, insere cada mensagem recebida por POST numa tabela Postgres e responde pela Cloud API. Faça o deploy com a verificação de JWT desativada, porque o Supabase exige por predefinição um JWT válido e a Meta não consegue enviá-lo.

### O que tem a Edge Function de fazer?

Duas coisas, em dois métodos.

Em GET, responde à verificação da Meta. Leia hub.mode, hub.verify_token e hub.challenge da query string, compare o token com o que indicou como verify token do destino e devolva o challenge como corpo em texto simples, com estado 200. Devolva 403 quando o token não coincide.

Em POST, recebe eventos. Faça o parse do corpo, extraia as mensagens de entry, changes e value, insira-as numa tabela e devolva 200. Mantenha a resposta rápida: a Meta trata uma resposta lenta ou falhada como uma entrega falhada e volta a tentar, o que significa a mesma mensagem duas vezes.

Defina o URL da função como destino do webhook do número no EasyCoexistence, com o mesmo verify token, e a Meta começa a entregar.

### Porque devolve a função 401 à Meta?

Porque a verificação de JWT está ativa. O Supabase valida um JWT no cabeçalho Authorization antes de o código da Edge Function correr, e essa é a predefinição de todas as funções. A Meta não envia esse cabeçalho, pelo que a plataforma rejeita tanto o GET de verificação como todas as entregas, e o seu código nunca as vê.

Desative-a apenas nesta função. Faça o deploy com supabase functions deploy whatsapp --no-verify-jwt, ou defina verify_jwt = false na secção da função em supabase/config.toml. A documentação do Supabase descreve exatamente este caso: um endpoint público chamado por um fornecedor externo de webhooks.

Com a verificação da plataforma desativada, a função precisa da sua própria. O cabeçalho de assinatura não está disponível, uma vez que a Meta assina com o segredo da app que detém a subscrição. Coloque um segredo longo e aleatório no URL de destino, como parâmetro de query, e rejeite os pedidos que não o tragam, como faz o exemplo em POST.

### Como deve a função guardar e responder?

Guardar primeiro, responder depois. Faça upsert pelo id da mensagem do WhatsApp com uma restrição de unicidade, para que as novas tentativas da Meta caiam na mesma linha em vez de criarem um duplicado. Guarde o phone_number_id de receção em cada linha se mais de um número apontar para a função.

Para tudo o que for lento, como chamar um modelo ou outra API antes de responder, entregue o trabalho a EdgeRuntime.waitUntil e devolva a resposta de imediato. A função continua a correr até essa promise terminar, enquanto a Meta já tem o seu 200. O Supabase deixa de esperar aos 150 segundos de inatividade e devolve 504, pelo que um código que faz todo o trabalho antes de responder é o que mais provavelmente causa novas tentativas.

As respostas seguem para o endpoint de mensagens da Cloud API com o phone number id e o token do número, guardados como segredos da função. Nas 24 horas seguintes à última mensagem do cliente, o texto livre é entregue; fora desse prazo, só um template aprovado.

### As mensagens enviadas a partir do telemóvel chegam à função?

Sim. Num número Coexistence, a app WhatsApp Business continua a funcionar e, quando alguém responde a partir dela, a Meta entrega um eco dessa mensagem enviada ao mesmo destino, no campo smb_message_echoes e num array message_echoes, e não em messages.

Amplie o parser para ler ambos e guarde uma coluna direction. A tabela passa a conter a conversa completa, as mensagens do cliente e as respostas da empresa, que é o que a maioria das pessoas quer consultar depois: tempos de resposta, conversas sem resposta, a hora da última mensagem recebida por contacto.

Esse último valor é também o dado de que todos os caminhos de envio precisam, porque decide se a resposta pode ser texto livre ou tem de ser um template. Uma view sobre a tabela pode expô-lo por contacto ao resto da sua aplicação.

- Fazer o deploy com a verificação de JWT ativa. O Supabase rejeita os pedidos da Meta com 401 antes de o código correr, e nenhuma mensagem chega.
- Devolver o challenge embrulhado em JSON. A Meta precisa do valor em bruto como corpo, ou a verificação falha em silêncio.
- Fazer trabalho lento antes de responder. A Meta repete o que vê como falhas, e a mesma mensagem é processada duas vezes.
- Desativar a verificação de JWT sem qualquer controlo próprio. Quem descobrir o URL pode enviar mensagens falsas para a tabela.

**Isto funciona no plano gratuito do Supabase?** As Edge Functions correm no plano gratuito, com um limite de 150 segundos de tempo real, contra 400 segundos nos planos pagos. Um código de webhook que responde depressa fica muito aquém de ambos.

**Devo usar a service role key na função?** Apenas do lado do servidor, como aqui, lida do ambiente da função. Ignora a row level security, pelo que nunca deve chegar a um browser.

**Uma função pode servir vários números?** Sim. Aponte o destino do webhook de cada número para ela e ramifique pelo phone_number_id de cada payload.

**O EasyCoexistence vê as mensagens?** Não. A Meta entrega cada webhook diretamente à sua função, e o EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Ligar o WhatsApp ao Activepieces num número Coexistence

https://easycoexistence.com/pt-pt/integrations/activepieces

O Activepieces tem uma piece WhatsApp Business que se liga com um access token e um id da WhatsApp Business Account, dois valores que um número Coexistence disponibiliza. O trigger New Incoming Message responde por si à verificação da Meta, pelo que o seu URL pode ser o destino do webhook do número. Deixe vazio o app secret opcional da piece e o fluxo corre a cada mensagem, enquanto a equipa continua com o telemóvel.

### Como se liga um número Coexistence ao Activepieces?

Crie a ligação WhatsApp Business no Activepieces com dois valores: o access token e o id da WhatsApp Business Account. O painel do EasyCoexistence mostra ambos para a ligação, e get_api_credentials devolve-os a um assistente. As instruções da piece falam em criar uma app Meta e um utilizador de sistema, porque partem do princípio de que não tem nenhum dos dois. Aqui o número já está ligado, por isso passe diretamente à colagem dos valores.

Depois, crie um fluxo que comece com o trigger New Incoming Message, defina nele um verify token à sua escolha e publique o fluxo. Copie o URL do webhook do trigger para o destino do webhook do número no EasyCoexistence, com o mesmo verify token. A Meta envia o pedido de verificação, o trigger responde-lhe e cada mensagem enviada ao número inicia uma execução.

### Porque é que o app secret tem de ficar vazio?

Porque o secret que assina estas entregas não lhe pertence para colar. A Meta assina cada webhook com o app secret da app que detém a subscrição e, num número ligado através do EasyCoexistence, essa é a app do EasyCoexistence, cujo secret nunca é partilhado.

A piece trata o campo como opcional. Se estiver vazio, os triggers aceitam as entregas tal como chegam. Se for preenchido com o secret de qualquer outra app, todas as entregas falham a verificação do X-Hub-Signature-256 e são ignoradas em silêncio, o que se parece exatamente com mensagens que nunca chegam.

O verify token é o que impede estranhos de participar no handshake. Escolha um valor longo e aleatório e mantenha privado o URL do trigger, pois é o endereço que inicia o seu fluxo.

### O que pode fazer um fluxo quando chega uma mensagem?

O trigger entrega ao fluxo uma mensagem simplificada: remetente, nome de perfil, id da mensagem, tipo, texto, eventual id de multimédia, respostas de botões e listas, e o id do número de telefone que recebeu a mensagem. A partir daí, é um fluxo normal do Activepieces, com as restantes pieces, como um CRM, uma folha de cálculo ou um passo de IA.

As respostas usam a mesma piece. Send Message envia texto livre, que só é entregue nas 24 horas seguintes à última mensagem do cliente. Send Template Message envia um template aprovado, a única coisa que é entregue depois dessa janela. Botões interativos, listas, multimédia, localização e reações são ações próprias.

As instruções do próprio Activepieces referem que a Meta aceita um só URL de callback por app. Com destinos por número, o limite é um URL por número, pelo que um fluxo que tenha de tratar vários tipos de evento deve ramificar-se dentro de um único fluxo.

### As respostas escritas no telemóvel chegam ao fluxo?

Chegam ao webhook, mas não a este trigger. Num número Coexistence, a Meta envia para o mesmo destino um eco de cada resposta escrita na app WhatsApp Business, no campo smb_message_echoes. O trigger New Incoming Message da piece lê apenas o campo messages e descarta tudo o resto.

Se precisar das respostas do telemóvel no fluxo, inicie-o antes com a piece genérica Webhook do Activepieces, que aceita qualquer método HTTP, e responda ao GET de verificação com um passo Return Response no seu URL síncrono. Depois, trate o payload em bruto por si, com ambos os campos incluídos.

Na maioria dos fluxos, o trigger da piece é a opção mais simples: reage aos clientes, e as respostas da equipa continuam visíveis na app do telemóvel.

- Colar um app secret na ligação WhatsApp. As entregas são assinadas com o secret da app do EasyCoexistence, pelo que todas são ignoradas.
- Definir o destino antes de publicar o fluxo. A Meta verifica de imediato e um fluxo não publicado não consegue responder.
- Esperar que o trigger New Incoming Message veja as respostas escritas no telemóvel. Lê apenas o campo messages, não o smb_message_echoes.

**Isto funciona no Activepieces self-hosted?** Sim. A piece é de código aberto e funciona na cloud do Activepieces ou em instalação própria, desde que a instância esteja acessível por HTTPS a partir da internet.

**De que número de telefone envia um fluxo?** Do número que escolher no campo de número de telefone da ação, que lista os números da WhatsApp Business Account para a qual a ligação aponta.

**Posso continuar a usar o n8n ou o Make no mesmo número?** Não em simultâneo. A Meta encaminha os webhooks de um número para um único destino, por isso escolha uma ferramenta para receber, ou reencaminhe dessa para a outra.

**O EasyCoexistence guarda as mensagens?** Não. A Meta entrega cada webhook diretamente ao trigger do Activepieces, e o EasyCoexistence nunca guarda o conteúdo das conversas.

---

## Execute um fluxo Typebot no WhatsApp com Coexistence

https://easycoexistence.com/pt-pt/integrations/typebot

O canal de WhatsApp do Typebot pede um token, um id de WhatsApp Business Account e um id do número de telefone, e devolve um callback URL e um verify token. Preencha os três primeiros com os dados do número ligado, deixe vazio o app secret opcional do Typebot e defina o callback URL e o verify token do Typebot como destino do webhook do número.

### Que campos do Typebot recebem valores do número ligado?

O assistente de WhatsApp do Typebot, no separador Share de um bot, pede quatro itens: um App Secret, um System User Token, um WhatsApp Business Account ID e um Phone number ID.

Três deles vêm diretamente da ligação. O painel mostra o id da WABA, o id do número de telefone e o token de acesso do número, e a ferramenta get_api_credentials devolve os mesmos valores se for um assistente a obtê-los por si. Cole-os nos campos correspondentes.

O App Secret é o que deve ficar em branco. O Typebot usa-o para uma única coisa no tráfego recebido: verificar o cabeçalho X-Hub-Signature-256 que a Meta acrescenta a cada entrega. Num número ligado através de um Tech Provider, a Meta assina com o app secret do fornecedor, que nunca é partilhado, pelo que qualquer valor escrito ali faz o Typebot rejeitar todas as mensagens genuínas. Com o campo vazio, o Typebot ignora essa verificação e aceita a entrega.

### Onde se colocam o callback URL e o verify token do Typebot?

No destino do webhook do número, não no painel de uma app da Meta.

O assistente do Typebot indica que se cole o Callback URL e o Verify Token nas definições de WhatsApp da sua própria app da Meta. Com a Coexistence através da EasyCoexistence, não há nenhuma app sua envolvida: a Meta encaminha os eventos do número para o destino definido na ligação. Copie por isso os dois valores do último passo do Typebot e defina-os como destino, no painel ou com set_webhook_destination.

A Meta envia então o seu GET de verificação ao Typebot, o Typebot responde com o desafio e, a partir desse momento, todas as mensagens para o número chegam ao bot. O verify token do Typebot é de utilização única: é eliminado da base de dados do Typebot assim que uma verificação tem êxito. Se voltar a definir o destino mais tarde, gere primeiro um novo token, executando de novo o assistente.

### Como trata o bot a janela de 24 horas?

O Typebot responde a pessoas que lhe escreveram, o que mantém quase todas as mensagens dentro da janela de atendimento ao cliente. A Meta abre uma janela de 24 horas sempre que um cliente escreve e, dentro dela, qualquer tipo de mensagem de serviço pode ser enviado sem template. Um bot que se limita a responder é, por isso, o caso simples.

O limite está nos fluxos que esperam. Um bloco Wait, ou uma sessão que é retomada depois de o cliente estar mais de um dia em silêncio, tentará enviar uma mensagem de texto livre fora da janela, e a Meta recusa-a com o erro 131047. O tempo limite de expiração da sessão do Typebot, de 4 horas por predefinição e configurável até 48, decide quando um cliente que regressa inicia uma nova conversa, não se a Meta aceita a mensagem.

Como se trata de Coexistence, a equipa continua a ver todas as conversas na app WhatsApp Business e pode intervir a partir do telemóvel sempre que o bot não deva responder.

- Colar no Typebot um app secret da Meta. As entregas são assinadas com o secret do Tech Provider, por isso o Typebot rejeita todas as mensagens por assinatura inválida.
- Reutilizar um verify token antigo do Typebot. É eliminado após uma verificação bem-sucedida, pelo que voltar a definir o destino exige um novo token, obtido no assistente.
- Partilhar o callback URL. Com a verificação da assinatura desativada, conhecer o URL é o que permite a entrada de um pedido, por isso trate-o como uma palavra-passe.

**Preciso de uma app própria da Meta para o Typebot?** Não. O guia do Typebot pressupõe uma, porque a maioria das pessoas liga o número por si. Com a Coexistence através de um Tech Provider, o token e os ids vêm da ligação e a Meta encaminha o webhook para o Typebot.

**A equipa continua a ver no telemóvel as mensagens do bot?** Sim. As mensagens enviadas pela Cloud API aparecem na app WhatsApp Business no mesmo número, pelo que uma pessoa pode ler a conversa e assumi-la.

**O Typebot e o n8n podem receber as mensagens do mesmo número?** Não. Um número tem um único destino de webhook. Se ambos precisarem dos eventos, aponte o destino para o n8n e faça o workflow reencaminhar o payload original para o callback URL do Typebot.

**O Typebot guarda as conversas?** O Typebot mantém os seus próprios dados de sessão e de resultados, como em qualquer canal. A EasyCoexistence nunca guarda o conteúdo das mensagens: a Meta entrega diretamente no destino que definir.

---

## Ligar um bot Botpress ao WhatsApp com Coexistence

https://easycoexistence.com/pt-pt/integrations/botpress

Use a integração WhatsApp do Botpress em Manual Configuration. Cole o access token e o phone number id do número ligado, escolha um verify token e deixe App ID e Client Secret vazios. Depois defina o URL do webhook do Botpress e esse verify token como destino do webhook do número, e a Meta entrega todas as mensagens ao bot.

### Que configuração do Botpress funciona com um número Coexistence?

Manual Configuration. As outras opções ligam um número através da app Meta do próprio Botpress, o que é uma associação separada do número e não uma forma de usar um número já ligado.

Na integração WhatsApp, abra a lista pendente Configuration e escolha Manual Configuration. Esta pede um Verify Token, um Access Token, um Default Bot Phone Number ID e, opcionalmente, um App ID, um Client Secret e um WABA ID.

O access token, o phone number id e o WABA id vêm da ligação: o painel mostra-os e get_api_credentials devolve-os a um assistente. O verify token é qualquer texto que escolher. App ID e Client Secret ficam vazios. O guia do Botpress apresenta o secret como um campo a preencher, mas a definição da integração marca-o como opcional e indica que, sem ele, a verificação da assinatura é ignorada. Isto importa, porque a Meta assina cada entrega com o app secret do Tech Provider, que nenhum cliente possui.

### Como recebe o webhook do Botpress as mensagens da Meta?

Através do destino do webhook do número. O guia do Botpress manda colar o URL do webhook e o verify token na configuração WhatsApp de uma app Meta. Aqui não existe nenhuma app Meta sua: a Meta encaminha os eventos do número para o destino que a ligação indicar. Copie, por isso, o URL do webhook que o Botpress mostra para a integração e defina-o, com o mesmo verify token, como destino no painel ou com set_webhook_destination.

A Meta envia um GET de verificação, o Botpress responde-lhe e a entrega começa. Quando o Botpress guarda uma configuração manual, verifica também o token perguntando à Graph que app o emitiu, pelo que um token inválido ou revogado falha ao guardar e não na primeira mensagem.

O handler do Botpress processa ainda smb_message_echoes, o evento que a Meta envia quando alguém responde a partir da app WhatsApp Business. Assim, uma resposta dada pelo telemóvel fica visível para o bot, em vez de lhe ser invisível.

### O que deve o bot saber sobre a Coexistence?

Que uma pessoa pode já estar a falar. A app WhatsApp Business continua a funcionar no número, pelo que um cliente pode receber uma resposta do telemóvel e outra do bot no mesmo minuto. Defina no fluxo o que acontece quando chega um eco: a maioria das equipas pausa o bot para esse contacto durante algum tempo, para que a pessoa que interveio não seja interrompida.

A segunda questão é o tempo. Um bot que responde a mensagens recebidas trabalha dentro da janela de atendimento ao cliente de 24 horas, onde o texto livre é permitido. Um fluxo que envia algo um dia depois, um seguimento ou um lembrete, precisa de um template aprovado, e o texto livre nesse caso devolve o erro 131047. O guia do Botpress subscreve os campos de estado dos templates precisamente para este tipo de mensagem proativa.

E o throughput é fixo, com 20 mensagens por segundo num número Coexistence, muito acima do que um bot conversacional envia.

- Preencher o Client Secret com o secret da sua própria app Meta. A assinatura nunca coincide e o Botpress responde a cada entrega com 401.
- Escolher a opção OAuth ou sandbox em vez de Manual Configuration. Essas ligam um número através da app do próprio Botpress, não do número já ligado.
- Ignorar os ecos. Sem uma regra para as respostas enviadas pelo telemóvel, o bot responde por cima de uma pessoa que já interveio.

**É seguro ignorar a verificação da assinatura?** A proteção passa para o URL. O Botpress gera o URL do webhook por integração, por isso mantenha-o privado. Os ficheiros multimédia continuam a ter de ser obtidos junto da Meta com o token, o que um evento falsificado não consegue simular.

**O mesmo número pode alimentar também o n8n?** Um número tem um único destino de webhook. Aponte-o para um sistema e reencaminhe a partir daí, se um segundo precisar dos eventos.

**O Botpress precisa do meu WABA id?** A definição marca-o como opcional por agora e indica que será obrigatório numa futura versão principal, pelo que convém preenchê-lo a partir da ligação.

**As mensagens passam pela EasyCoexistence?** Não. A Meta entrega diretamente no URL do webhook do Botpress e o conteúdo nunca é guardado do nosso lado.

---

## Responder a mensagens do WhatsApp com uma app Dify

https://easycoexistence.com/pt-pt/integrations/dify

Aponte o webhook do número a um pequeno recetor, como um fluxo n8n ou uma rota no seu próprio código, que passa cada mensagem à Send Chat Message API do Dify e devolve a resposta através da Cloud API. No Dify, o servidor MCP da EasyCoexistence pode ser adicionado como ferramenta, para que o agente possa atuar no próprio número.

### A Meta pode enviar mensagens do WhatsApp diretamente para o Dify?

Não de forma a concluir o handshake. Antes de entregar o que quer que seja, a Meta chama o destino com um GET e espera receber o valor de hub.challenge como corpo de resposta em bruto. O Webhook Trigger do Dify aceita um método HTTP por trigger e a sua documentação indica que um corpo de resposta que não seja JSON é convertido automaticamente em JSON, pelo que OK volta como um objeto de mensagem. O challenge nunca pode ser devolvido exatamente e a Meta nunca começa a entregar.

Por isso, coloca-se algo pequeno à frente. Um nó Webhook do n8n, uma rota em Python ou Node, ou uma função serverless responde ao GET, aceita o POST e passa o texto ao Dify. É também nesse recetor que se verifica o segredo aleatório longo presente no URL do webhook, uma vez que o cabeçalho X-Hub-Signature-256 é assinado com o segredo da app do Tech Provider e não pode ser validado pelo cliente.

### Como fala o recetor com a app Dify?

Com uma única chamada à Service API do Dify: POST /chat-messages, autenticado com a chave de API da app. O corpo leva query, o texto do cliente, e user, um identificador definido por si. Use o número de WhatsApp do remetente como user e guarde o conversation_id devolvido pelo Dify, para que a mensagem seguinte da mesma pessoa continue a mesma conversa.

O response_mode é importante. O modo blocking só devolve quando a resposta está completa e a documentação do Dify avisa que, no Dify Cloud, uma geração longa pode ser cortada pelo proxy de entrada. As apps de agente suportam apenas streaming e um pedido blocking a uma delas falha com 400. Um recetor que lê o stream e envia uma só mensagem de WhatsApp no fim é a solução mais robusta.

A resposta sai depois como mensagem de texto da Cloud API para o mesmo número, o que é gratuito dentro da janela de 24 horas aberta pela mensagem do cliente.

### O que acrescenta o servidor MCP dentro do Dify?

Permite que um agente do Dify atue no número sem que seja preciso ligar cada chamada à mão. O Dify liga-se a servidores MCP por HTTP e, por predefinição, regista-se no servidor através do registo dinâmico de clientes OAuth, que o servidor MCP da EasyCoexistence suporta. Adicione-o em Ferramentas, inicie sessão uma vez e o agente fica com as ferramentas: listar os números, verificar o estado de um número, enviar uma mensagem, enviar um template aprovado, ler o estado de um template.

É o sítio certo para o trabalho proativo: um fluxo do Dify que faz o acompanhamento no dia seguinte tem de usar send_template, porque texto livre fora da janela devolve o erro 131047, e as descrições das ferramentas dizem-no ao modelo.

O que o MCP não consegue fazer é acordar o Dify quando um cliente escreve. O protocolo funciona por pedido e resposta, por isso as mensagens recebidas continuam a chegar pelo webhook e pelo recetor que está à frente.

- Usar o URL de um Webhook Trigger do Dify como destino do webhook. O challenge volta envolvido em JSON e a Meta nunca verifica o endpoint.
- Enviar um pedido blocking a uma app Agent do Dify. As apps Agent suportam apenas streaming e a chamada falha com 400.
- Usar um valor user novo por mensagem. O Dify associa as conversas a user, pelo que cada mensagem inicia uma conversa nova, sem memória.

**O Dify tem um canal de WhatsApp?** Não na sua documentação. Uma app Dify é acessível através da Service API, pelo que o WhatsApp se liga por meio de um recetor que chama essa API.

**O n8n pode ser o recetor?** Sim. Um nó Webhook recebe, um nó HTTP Request chama o Dify e um segundo nó HTTP Request envia a resposta através da Cloud API.

**A equipa pode continuar a responder pelo telemóvel?** Sim. A Coexistence mantém a app WhatsApp Business a funcionar no número e as respostas enviadas pelo telemóvel chegam ao recetor como eventos echo.

**A EasyCoexistence vê a conversa?** Não. A Meta entrega diretamente ao seu recetor e o conteúdo das mensagens nunca é guardado do nosso lado. O servidor MCP lê o estado da conta e do número.

---

## Responder a mensagens do WhatsApp com um chatflow do Flowise

https://easycoexistence.com/pt-pt/integrations/flowise

Defina o destino do webhook do número para um pequeno recetor, como um workflow do n8n ou uma rota no seu próprio código. O recetor passa cada mensagem à Prediction API do Flowise, com o número do remetente como ID de sessão, e envia a resposta pela Cloud API com o token e o ID do número de telefone.

### Porque é que o Flowise precisa de algo à frente?

Porque o webhook da Meta e a API do Flowise falam formatos diferentes. A Meta valida um destino com um GET que tem de devolver hub.challenge como corpo simples e entrega depois cada mensagem num POST JSON aninhado. A Prediction API do Flowise espera um POST para /api/v1/prediction/ seguido do ID do fluxo, com um campo question. Nenhum dos dois se adapta ao outro, por isso um recetor faz a tradução.

O recetor pode ser um nó Webhook do n8n, uma rota em Python ou Node, ou qualquer função serverless. Responde ao GET de verificação, confere um segredo aleatório e longo colocado no URL do webhook, responde 200 à Meta de imediato e só depois faz o trabalho. O segredo no URL é a autenticação que funciona aqui: a Meta assina as entregas com o app secret do Tech Provider, que nunca é partilhado, pelo que o cabeçalho X-Hub-Signature-256 não pode ser validado do seu lado.

### Como deve o recetor chamar a Prediction API?

Com o texto do cliente como question e o número de WhatsApp do cliente como sessão. O Flowise aceita overrideConfig em cada pedido, e um sessionId lá dentro permite que os nós de memória mantenham uma conversa por pessoa, em vez de misturarem todos num único fio. O número do remetente, presente no payload do webhook, é uma chave estável e natural para isso.

Se o chatflow estiver protegido com uma chave de API, o recetor envia-a como bearer token. Defina streaming como false, a menos que o recetor esteja preparado para montar um fluxo contínuo, pois o WhatsApp entrega uma mensagem completa e não um token de cada vez.

A resposta sai como mensagem de texto da Cloud API, a partir do mesmo número. Isso é gratuito e permitido dentro da janela de 24 horas aberta pela mensagem do cliente. Tudo o que o fluxo queira enviar mais tarde, como um lembrete, tem de ser um template aprovado.

### Um agente do Flowise pode usar o servidor MCP da EasyCoexistence?

Hoje não. O Custom MCP do Flowise liga-se a um servidor Streamable HTTP com um URL e um conjunto de cabeçalhos, normalmente um bearer token estático guardado numa variável do Flowise. O servidor MCP da EasyCoexistence autentica-se com OAuth, com início de sessão no navegador e tokens emitidos por si, pelo que não existe uma chave estática para colocar num cabeçalho.

A divisão que funciona é deixar o fluxo decidir e o recetor enviar. O fluxo devolve o texto a dizer, ou o nome de um template quando o cliente esteve em silêncio mais de um dia, e o recetor faz a chamada à Cloud API com o token do número. Assim, o token nunca fica dentro do Flowise, e a regra das 24 horas é aplicada em código, verificando quando o contacto escreveu pela última vez, em vez de ficar entregue a um modelo que pode esquecê-la.

As mensagens recebidas continuam a chegar apenas pelo webhook, seja qual for a forma de envio.

- Omitir o sessionId. Todos os clientes passam a partilhar a mesma memória, e os dados de uma pessoa podem surgir na resposta a outra.
- Esperar pelo Flowise antes de responder à Meta. Um 200 lento é repetido, e a mesma mensagem é processada duas vezes.
- Deixar o fluxo enviar texto livre um dia depois. Fora da janela, a Meta recusa-o com o erro 131047.

**O Flowise tem um nó de WhatsApp?** Não na sua documentação. Chega-se a ele pela Prediction API, razão pela qual um recetor fica entre a Meta e o fluxo.

**O n8n pode ser o recetor?** Sim. Um nó Webhook recebe, um nó HTTP Request chama o Flowise e outro nó HTTP Request envia a resposta pela Cloud API.

**Como paro o bot quando uma pessoa responde pelo telemóvel?** Fique atento aos eventos de echo. Uma resposta enviada a partir da app WhatsApp Business chega ao recetor, que pode pausar o fluxo para esse contacto.

**A conversa fica guardada na EasyCoexistence?** Não. A Meta entrega diretamente ao seu recetor. O Flowise guarda o que os respetivos nós de memória estiverem configurados para guardar.

---

## Dê um número de WhatsApp a um agente LangChain

https://easycoexistence.com/pt-pt/integrations/langchain

Um agente LangChain recebe o WhatsApp em duas metades. As mensagens recebidas chegam à sua rota web através do webhook do número, e a rota invoca o agente. Para agir, o agente carrega as ferramentas MCP da EasyCoexistence através do MCPAdapter do LangChain com OAuth, ou chama diretamente a Cloud API com o token do número e o phone number id.

### Como carrega um agente LangChain as ferramentas do WhatsApp?

Através do MCPAdapter, o cliente MCP do LangChain, que entrega as ferramentas de um servidor MCP ao create_agent como ferramentas LangChain comuns. Requer langchain[mcp] na versão 1.4.0 ou posterior e está marcado como beta.

A autenticação é delegada ao FastMCP. Ao passar auth="oauth" no cliente, executa-se o fluxo OAuth 2.1 completo: descoberta, registo dinâmico de cliente, redirecionamento no navegador e troca de token. É isto que o servidor MCP da EasyCoexistence espera, por isso não há nenhuma chave para criar ou colar. Por predefinição, os tokens ficam em memória e cada execução repete o passo no navegador; um fornecedor OAuth do FastMCP com um armazenamento de tokens mantém-nos entre execuções.

Depois de carregadas, o agente vê as ferramentas com as respetivas descrições: primeiro list_numbers, porque todas as outras ferramentas recebem dela um connection_id, depois send_message, send_template, list_templates, get_number_health e as restantes.

### Como chega ao agente uma mensagem de WhatsApp recebida?

Através do webhook, porque o MCP não o consegue fazer. O protocolo é de pedido e resposta, pelo que nada nele permite a um servidor acordar um cliente quando um cliente escreve.

Defina o destino do webhook do número como uma rota da sua própria aplicação, com um segredo longo e aleatório no caminho do URL. A rota responde ao GET de verificação da Meta com o desafio em bruto, aceita cada POST, devolve 200 de imediato e coloca o trabalho em fila. Um worker retira então o remetente e o texto do payload e invoca o agente com esses dados, usando o número do remetente como identificador da conversa, para que a memória fique separada por cliente.

Verifique o segredo no URL em vez do cabeçalho X-Hub-Signature-256. A Meta assina com o segredo da app do Tech Provider, que nunca é partilhado, pelo que o cliente não consegue validar esse cabeçalho.

### O agente deve enviar através do MCP ou da Cloud API?

Ambos funcionam, e a diferença está em quem guarda as regras. As ferramentas MCP trazem as regras do WhatsApp nas suas descrições, como o send_message só funcionar dentro da janela de 24 horas e o send_template ser o caminho para contactar quem não escreveu. Um modelo que lê essas descrições escolhe a certa na maioria das vezes, e isso ajuda quando o agente decide livremente.

Uma ferramenta simples sua, que envia para o endpoint de mensagens da Cloud API com o token do número, é mais simples quando a tarefa do agente é estreita, por exemplo responder sempre a quem acabou de escrever. Nesse caso, a verificação da janela fica no seu código, que é o lugar de uma regra que nunca pode ser quebrada. Texto livre fora da janela devolve o erro 131047, e o cliente nunca vê nada.

- Esperar que o MCP entregue as mensagens recebidas. Sem uma rota de webhook, o agente nunca ouve um cliente.
- Deixar os tokens OAuth em memória num servidor. Cada reinício exige um início de sessão no navegador; guarde-os num armazenamento de tokens.
- Usar uma única conversa para todos os clientes. Associe a memória do agente ao número do remetente.

**Isto só funciona em Python?** O exemplo do MCPAdapter é em Python. O webhook e a Cloud API são HTTP simples, pelo que qualquer linguagem em que o LangChain funcione pode tratar da receção e do envio.

**O agente precisa de list_numbers sempre?** Precisa de um connection_id, e list_numbers é o único sítio de onde ele vem. Com um só número, o agente chama-a uma vez no início.

**A equipa ainda pode responder a partir do telemóvel?** Sim. A Coexistência mantém a app do WhatsApp Business a funcionar, e as respostas dadas no telemóvel chegam à sua rota como eventos echo que o agente pode ter em conta.

**A EasyCoexistence lê a conversa?** Não. A Meta entrega diretamente na sua rota e o conteúdo das mensagens nunca é guardado do nosso lado. As ferramentas MCP leem o estado da conta e do número.

---

## Coloque um agente OpenAI Agents SDK no WhatsApp

https://easycoexistence.com/pt-pt/integrations/openai-agents-sdk

Defina o destino do webhook do número para uma rota na sua aplicação Python. Por cada mensagem recebida, execute o agente com Runner.run e uma sessão identificada pelo número do remetente, e depois envie result.final_output pela Cloud API com o token e o phone number id do número. A app WhatsApp Business continua a funcionar no mesmo número.

### Como se transforma uma mensagem de WhatsApp numa execução do agente?

Através de uma rota na sua própria aplicação, chamada pela Meta. Defina-a como destino do webhook do número, com um segredo longo e aleatório no caminho. A rota responde à verificação GET da Meta devolvendo hub.challenge como texto simples, aceita cada POST, responde 200 de imediato e coloca o trabalho em fila, porque a Meta repete as respostas lentas e o agente seria executado duas vezes.

Depois, um worker lê o remetente e o texto do payload e chama Runner.run. Passe uma sessão cujo id seja o número do remetente: o SDK guarda a conversa sob esse id, pelo que a mensagem seguinte do mesmo cliente continua onde a anterior parou, e dois clientes nunca partilham o mesmo histórico. SQLiteSession chega para começar; o SDK inclui também sessões Redis e SQLAlchemy para vários workers.

O segredo no URL é aqui a autenticação. A Meta assina as entregas com o segredo da aplicação do Tech Provider, pelo que o cliente não consegue validar o cabeçalho da assinatura.

### Porque deve ser o seu código a enviar a resposta, e não o agente?

Porque a única regra que nunca pode ser quebrada é uma regra de tempo, e o código cumpre-a melhor do que um prompt. A Meta abre uma janela de atendimento de 24 horas quando um cliente escreve. Dentro dela, o texto livre passa. Fora dela, só passa um template aprovado, e o texto livre devolve o erro 131047.

Um worker que responde à mensagem que acabou de chegar está sempre dentro da janela, pelo que enviar result.final_output como texto é seguro por construção. O trabalho que acontece mais tarde, como um acompanhamento na manhã seguinte ou um lembrete, deve seguir por um caminho separado que envia um template e nunca texto livre.

O agente pode, mesmo assim, ter ferramentas. Dê-lhe ferramentas de função para consultar dados, como uma encomenda ou uma reserva, e mantenha o envio por WhatsApp no worker. Isso também mantém o token de acesso fora do alcance de qualquer coisa que o modelo possa chamar com argumentos arbitrários.

### O agente pode usar o servidor MCP da EasyCoexistence?

Pode, através de MCPServerStreamableHttp, com mais configuração do que um cabeçalho. O SDK aceita um cabeçalho Authorization ou um httpx.Auth em params["auth"]. O servidor MCP da EasyCoexistence emite os seus próprios tokens OAuth após um início de sessão no navegador, com registo dinâmico de clientes e PKCE, por isso não existe uma chave estática. O SDK Python do MCP inclui OAuthClientProvider, um gestor de autenticação HTTP que executa esse fluxo com PKCE e renovação do token, e é isso que se coloca em params["auth"].

Compensa quando o agente deve decidir por si: verificar o estado de um número, ler o estado de um template, ou escolher entre send_message e send_template segundo as regras nas descrições das ferramentas. Para um atendimento que apenas responde, o worker acima é mais curto e tem menos pontos de falha.

De qualquer forma, o webhook mantém-se. O MCP funciona por pedido e resposta, e a mensagem de um cliente só chega ao agente pela rota que a Meta chama.

- Executar o agente antes de devolver 200 à Meta. Uma resposta lenta é repetida e o cliente recebe duas respostas.
- Usar uma única sessão para todos os clientes. Identifique-a pelo número do remetente, ou os históricos misturam-se.
- Deixar um acompanhamento atrasado enviar texto livre. Passadas 24 horas falha com 131047; envie antes um template.

**Isto exige a ferramenta MCP alojada da OpenAI Responses API?** Não. O worker executa o agente localmente com Runner.run, e o lado do WhatsApp é uma simples chamada HTTPS feita pelo seu código.

**Que versão da Graph API devo usar?** Os exemplos atuais da Meta usam v25.0. Fixe uma versão num único local do código, para que uma atualização seja uma alteração de uma linha.

**Uma pessoa pode assumir a conversa a partir do telemóvel?** Sim. A Coexistência mantém a app WhatsApp Business a funcionar, e uma resposta dada no telemóvel chega à sua rota como um evento echo, que o worker pode usar para pausar o agente.

**A EasyCoexistence guarda a conversa?** Não. A Meta entrega diretamente na sua rota. Tudo o que a sessão guarda fica na sua própria base de dados.

---

## Crie um agente de WhatsApp com o Vercel AI SDK

https://easycoexistence.com/pt-pt/integrations/vercel-ai-sdk

As mensagens recebidas chegam a um route handler definido como destino do webhook do número. O handler chama generateText e envia a resposta através da Cloud API. Para as ferramentas que atuam sobre o número, o createMCPClient de @ai-sdk/mcp liga-se ao servidor MCP da EasyCoexistence por HTTP, com início de sessão por OAuth através de um authProvider.

### Como recebe o route handler as mensagens do WhatsApp?

Com dois métodos na mesma rota, definida como destino do webhook do número, com um segredo aleatório longo no caminho.

O GET responde à verificação da Meta. Leia hub.mode, hub.verify_token e hub.challenge da query, compare o token e devolva o challenge como texto simples. Devolvê-lo através de um helper de JSON é o erro clássico: o corpo chega com aspas à volta e a Meta nunca começa a entregar.

O POST recebe os eventos. Devolva 200 rapidamente e faça a chamada ao modelo depois, porque a Meta volta a tentar quando a resposta é lenta, e um arranque a frio que execute o modelo no próprio pedido pode responder duas vezes à mesma mensagem. Nas plataformas que terminam a função quando a resposta é enviada, passe o trabalho para uma fila ou para o mecanismo da plataforma para trabalho posterior à resposta.

O segredo no caminho é a autenticação. A Meta assina cada entrega com o app secret do Tech Provider, pelo que o cabeçalho X-Hub-Signature-256 não pode ser verificado do seu lado.

### Como carrega o AI SDK as ferramentas do WhatsApp?

Com o createMCPClient de @ai-sdk/mcp e o transporte HTTP, que a documentação do AI SDK recomenda para produção. O transporte recebe o URL do servidor e um authProvider, e é através do OAuth com authProvider que o servidor MCP da EasyCoexistence é autorizado: publica os metadados OAuth, suporta registo dinâmico de clientes e PKCE, e emite os seus próprios tokens após um início de sessão. Não há nenhuma chave de API para colocar num cabeçalho.

As ferramentas do cliente passam diretamente para o generateText ou o streamText. O modelo passa então a ver list_numbers, send_message, send_template, get_number_health e as restantes, com descrições que indicam a janela de 24 horas. Feche o cliente quando a chamada terminar, no callback onEnd num stream ou num bloco finally nos outros casos, como pede a documentação do AI SDK.

Use-o quando for o modelo a decidir. Para responder à mensagem que acabou de chegar, uma chamada direta à Cloud API a partir do handler é mais curta.

### O que muda por o número estar em Coexistence?

Duas coisas que o código deve ter em conta. Primeiro, pode já haver uma pessoa na conversa. A app WhatsApp Business continua a funcionar no número, e cada resposta escrita no telemóvel chega à rota como um evento echo. Um handler que, após um echo, põe o modelo em pausa para esse contacto evita que este responda por cima de uma pessoa.

Segundo, o envio está limitado a 20 mensagens por segundo, um valor fixo para o número. Um agente conversacional nunca chega perto disso, mas um ciclo de difusão escrito com Promise.all sobre uma lista de contactos chega, por isso envie em lotes.

Tudo o resto é a Cloud API normal. Nas 24 horas seguintes à última mensagem do cliente, o texto livre é permitido. Depois disso, só passa um template aprovado, e o texto livre devolve o erro 131047 sem que o cliente veja nada.

- Devolver o challenge com um helper de resposta JSON. As aspas à volta fazem falhar a verificação da Meta.
- Executar o generateText antes de responder à Meta. Num arranque a frio, a nova tentativa produz uma segunda resposta.
- Esquecer-se de fechar o cliente MCP. Cada pedido deixa uma ligação aberta até a plataforma a terminar.

**Isto só funciona na Vercel?** Não. O AI SDK é uma biblioteca TypeScript, e a rota pode correr em qualquer alojamento que sirva HTTPS e responda a um GET e a um POST.

**Preciso mesmo do cliente MCP?** Não para responder. Um fetch ao endpoint de mensagens da Cloud API com o token do número faz isso. O MCP justifica-se quando é o modelo a escolher o que fazer.

**Que fornecedor pode ser usado para o modelo?** Qualquer um que o AI SDK suporte. O lado do WhatsApp é independente do modelo, pelo que mudar de fornecedor não afeta a rota nem a chamada à Cloud API.

**A EasyCoexistence vê as mensagens?** Não. A Meta entrega diretamente na sua rota e o conteúdo das mensagens nunca é guardado do nosso lado.

---

## Enviar mensagens de encomendas do Shopify por WhatsApp

https://easycoexistence.com/pt-pt/integrations/shopify

A ação Send HTTP request do Shopify Flow pode enviar um template aprovado para a Cloud API quando uma encomenda é criada, usando o phone number id do número ligado e um token guardado como segredo do Flow. Nos planos sem essa ação, um webhook de administração do Shopify envia os dados para um recetor, como o n8n, que faz a mesma chamada.

### Como envia o Shopify Flow uma mensagem de WhatsApp?

Com a ação Send HTTP request, que envia um pedido para qualquer URL, com cabeçalhos e um corpo que pode usar variáveis Liquid do acionador.

Crie um fluxo de trabalho com o acionador de criação de encomenda e adicione Send HTTP request. O URL é o endpoint de mensagens da Cloud API para o phone number id do número ligado. Adicione um cabeçalho Authorization cujo valor é Bearer seguido do token de acesso do número, guardado como segredo do Flow e referenciado como variável secreta. Os valores secretos nunca são apresentados na interface do Flow e são ocultados nos registos de execução, que é o sítio certo para um token. O corpo é uma mensagem de template, com o número de telefone do cliente no campo to e os dados da encomenda como parâmetros do template.

O Flow considera uma resposta 2XX ou 3XX um sucesso. A Meta responde a um pedido válido com o id da mensagem, pelo que uma execução bem-sucedida significa que a Meta aceitou a mensagem.

### Porque é que uma mensagem de encomenda tem de ser um template?

Porque é a loja que escreve primeiro. A janela de atendimento ao cliente de 24 horas da Meta só abre quando o cliente escreve para o número. Uma confirmação de encomenda, uma atualização de envio ou um lembrete de carrinho abandonado são enviados antes disso, pelo que o texto livre é recusado e só passa um template pré-aprovado.

Crie o template uma só vez, na categoria utility, para atualizações de encomendas e envios, e aguarde a aprovação antes de ativar o fluxo de trabalho. O nome e o idioma no corpo do pedido têm de corresponder exatamente ao template aprovado, e o número de parâmetros tem de corresponder aos seus marcadores.

Há também o consentimento. A Meta exige opt-in antes de uma empresa enviar mensagens a alguém no WhatsApp: a pessoa forneceu o seu número e aceitou receber mensagens dessa empresa. Uma caixa de seleção no checkout que o indique é a forma habitual de o recolher, e o fluxo de trabalho deve verificá-lo antes de enviar.

### E se o plano da loja não incluir Send HTTP request?

Use antes um webhook de administração do Shopify. Em Definições, Notificações, Webhooks, o comerciante pode criar um webhook para um evento como a criação de encomenda, em JSON, para um URL. Aponte-o para um recetor: um nó Webhook do n8n, ou uma rota em PHP, Python ou Node. O recetor lê a encomenda, verifica o consentimento e faz a mesma chamada de template à Cloud API.

Seja qual for o caminho de envio, as respostas são iguais. Quando o cliente responde à mensagem da encomenda, a resposta chega à app WhatsApp Business no telemóvel da loja, porque o número está em Coexistence, e a janela de 24 horas fica aberta para texto livre. Se o destino do webhook do número estiver definido, a resposta chega também ao seu sistema. A própria mensagem da encomenda também aparece na app, para que quem responde veja aquilo a que o cliente está a responder.

- Enviar texto livre na criação da encomenda. O cliente não escreveu, por isso a Meta recusa; tem de ser um template aprovado.
- Deixar o tratamento de erros em Retry para respostas 4XX. O Flow pode repetir durante até 24 horas um pedido que a Meta nunca vai aceitar.
- Colocar o token num cabeçalho em texto simples. Guarde-o como segredo do Flow para que fique fora da interface e dos registos.

**Quem paga as mensagens de template?** A Meta fatura as mensagens diretamente à empresa, na sua própria conta WhatsApp Business. A EasyCoexistence nunca aplica qualquer margem.

**A equipa pode continuar a responder aos clientes a partir do telemóvel?** Sim. É isso que a Coexistence mantém: a app WhatsApp Business funciona no mesmo número a partir do qual a loja envia.

**Isto exige uma aplicação do Shopify?** Não. Basta o Send HTTP request do Flow, ou um webhook de administração para um recetor. A Cloud API é uma só chamada HTTPS.

**Que formato de telefone exige o campo to?** Formato internacional, com o indicativo do país e apenas dígitos. Limpe o campo de telefone do checkout antes de enviar, pois os clientes escrevem espaços e símbolos.

---

## Enviar atualizações de encomendas do WooCommerce por WhatsApp

https://easycoexistence.com/pt-pt/integrations/woocommerce

Crie um webhook do WooCommerce para eventos de encomendas que aponte para um recetor, como um fluxo n8n ou uma pequena rota PHP. O recetor verifica a assinatura do WooCommerce, confirma que o cliente aceitou receber mensagens de WhatsApp e envia um template aprovado através da Cloud API, com o phone number id e o token do número ligado.

### Como é que uma encomenda do WooCommerce desencadeia uma mensagem de WhatsApp?

Através de um webhook do WooCommerce e de um recetor. No WooCommerce, em Definições, Avançado, Webhooks, adicione um webhook com um tópico de encomenda, como encomenda criada ou encomenda atualizada, um URL de entrega e um segredo. A partir daí, o WooCommerce envia a encomenda em JSON para esse URL sempre que o evento ocorre.

O payload é fixo, por isso não pode ser dirigido diretamente à Cloud API. Entre os dois fica um recetor: um nó Webhook do n8n, uma rota no PHP da própria loja ou qualquer serviço pequeno. Lê a encomenda, escolhe o número de telefone do cliente e os dados de que a mensagem precisa, e faz um pedido HTTPS ao endpoint de mensagens da Cloud API para o número ligado, com o token de acesso do número como token bearer.

O tópico order.updated não está associado a um único estado, pelo que o recetor deve ler o campo status da encomenda e enviar uma só vez por cada transição que lhe interessa. Por predefinição, o WooCommerce faz a entrega em segundo plano através do wp-cron, pelo que a mensagem pode chegar com um pequeno atraso em relação à encomenda.

### Como sabe o recetor que o pedido veio da loja?

Pela assinatura do WooCommerce. Cada entrega traz um cabeçalho X-WC-Webhook-Signature, um HMAC-SHA256 do payload bruto codificado em base64 e calculado com o segredo que definiu no webhook. O recetor calcula o mesmo hash sobre o corpo que recebeu, compara e rejeita tudo o que não coincida.

Este é o segredo da própria loja, pelo que, ao contrário da assinatura da Meta nas mensagens de WhatsApp recebidas, pode ser validado. Compare em tempo constante e calcule o hash do corpo bruto antes de qualquer framework o processar, porque um JSON recodificado produz um hash diferente.

Responda depressa com um 2xx. O WooCommerce conta como falha qualquer resposta que não seja 2xx, 301 ou 302 e, depois de mais de cinco falhas seguidas, desativa o webhook. Um recetor parado por causa de uma atualização, ou lento por esperar pela Meta antes de responder, pode desligar as mensagens da loja sem que ninguém repare.

### O que pode a loja enviar, e quando?

Um template aprovado, sempre que a loja fala primeiro. A janela de atendimento ao cliente de 24 horas da Meta só abre quando o cliente envia mensagem ao número, por isso uma confirmação de encomenda ou uma atualização de expedição é iniciada pela empresa e o texto livre é recusado. Crie um template de utilidade para cada atualização, aguarde a aprovação e envie-o pelo nome e idioma, com o número da encomenda e outros dados como parâmetros.

A Meta exige ainda opt-in: o cliente forneceu o seu número e aceitou receber mensagens desta empresa por WhatsApp. Uma caixa de seleção no checkout, guardada na encomenda, é o registo mais simples, e o recetor deve verificá-la antes de enviar.

Quando o cliente responde, a conversa passa a ser Coexistência normal. A resposta aparece na app WhatsApp Business no telemóvel da loja, a janela fica aberta para texto livre e a equipa responde a partir da app, como sempre fez.

- Fazer a chamada à Cloud API antes de responder ao WooCommerce. Um envio lento ou falhado conta contra o webhook, que é desativado após mais de cinco falhas.
- Calcular o hash do JSON já processado em vez do corpo bruto. A assinatura nunca coincide e todas as entregas legítimas são rejeitadas.
- Enviar em cada entrega de order.updated. O tópico não está associado a um único estado, pelo que, sem registar qual a transição já notificada, os clientes recebem mensagens duplicadas.

**Preciso de um plugin do WordPress para isto?** Não. Bastam os webhooks nativos do WooCommerce e um recetor, que pode ser uma rota na mesma aplicação PHP.

**Quem paga as mensagens das encomendas?** A Meta cobra as mensagens diretamente à empresa, na sua própria conta WhatsApp Business, e a EasyCoexistence nunca aplica qualquer margem.

**A equipa pode continuar a usar o telemóvel?** Sim. A Coexistência mantém a app WhatsApp Business a funcionar no número da loja, e o template enviado pela loja aparece na conversa.

**E se um webhook tiver sido desativado?** Corrija o recetor e volte a definir o estado do webhook como ativo no WooCommerce. As encomendas criadas enquanto esteve desativado não desencadearam mensagem.

---

## Enviar e receber WhatsApp com PHP e Laravel

https://easycoexistence.com/pt-pt/integrations/php-laravel

Receber é uma rota Laravel que responde ao GET de verificação da Meta e aceita POSTs, lendo os parâmetros como hub_mode, hub_verify_token e hub_challenge, porque o PHP converte os pontos em sublinhados. Enviar é um único POST com Http::withToken() para o endpoint de mensagens da Cloud API, com o phone number id e o token do número. Não é preciso nenhum SDK.

### Como se recebem mensagens de WhatsApp no Laravel?

Com um GET e um POST no mesmo caminho em routes/api.php. Execute primeiro php artisan install:api se o ficheiro não existir. As rotas de API não têm estado e ficam fora do grupo web, pelo que o POST da Meta não é rejeitado por falta de token CSRF, o que acontece numa rota em routes/web.php.

O GET responde à verificação da Meta. A Meta envia hub.mode, hub.verify_token e hub.challenge, mas o PHP reescreve os pontos nos nomes das variáveis recebidas como sublinhados, por isso o Laravel vê hub_mode, hub_verify_token e hub_challenge. O código que lê os nomes com ponto obtém null e nunca verifica. Devolva o challenge como texto simples, não através de response()->json().

O POST entrega o payload a um job em fila e devolve 200 de imediato. Coloque uma chave longa e aleatória no caminho e valide-a nas duas rotas: a Meta assina as entregas com o app secret do Tech Provider, pelo que o cabeçalho da assinatura não pode ser validado do seu lado.

### Como se envia uma mensagem de WhatsApp a partir do Laravel?

Com o cliente HTTP do Laravel: um POST ao endpoint de mensagens do phone number id, com o token de acesso como bearer token. Os dois valores vêm da ligação, são mostrados no painel e devolvidos por get_api_credentials, e devem ficar em config/services.php, assentes em variáveis de ambiente, e não no código.

A forma do corpo depende do momento. Nas 24 horas seguintes à última mensagem do cliente, funciona um objeto text, como abaixo. Fora dessa janela, a Meta só aceita um objeto template que indique um template aprovado e o respetivo idioma, e o texto livre falha com o erro 131047. A resposta é o sítio onde se vê isso: uma chamada falhada devolve um objeto error cujo código diz o que correu mal, por isso registe-o em log em vez de o descartar.

Nada no pedido é específico da EasyCoexistence. É a chamada da documentação da própria Meta, pelo que qualquer cliente HTTP de PHP, Guzzle ou cURL simples, funciona da mesma maneira.

### O que precisa um handler Laravel em produção, além disto?

Uma fila a sério, deduplicação e uma verificação da janela.

A fila é importante porque a Meta volta a tentar quando a resposta é lenta. HandleWhatsAppEvent::dispatch() só devolve rapidamente quando a ligação da fila é real e há um worker em execução. No driver sync, o job corre dentro do pedido, e uma chamada lenta a um modelo ou uma escrita na base de dados transforma-se numa entrega duplicada.

Deduplique pelo id da mensagem, o wamid de cada mensagem, porque as novas tentativas são normais e não excecionais. Basta um índice único nessa coluna, ou um lock de cache com essa chave.

E guarde quando cada contacto escreveu pela última vez. Com essa data e hora, o envio escolhe sozinho entre texto e template, em vez de descobrir pelo erro 131047 quando o cliente já estava à espera. As respostas escritas no telemóvel, na app WhatsApp Business, chegam como eventos echo à mesma rota, pelo que o handler também consegue ver quando uma pessoa assumiu uma conversa.

- Ler hub.challenge com ponto. O PHP mudou-lhe o nome para hub_challenge, por isso o handler devolve um corpo vazio e a Meta nunca verifica.
- Colocar o webhook em routes/web.php. O POST da Meta não tem token CSRF e é rejeitado com 419.
- Despachar para a fila sync. O job corre antes do 200, o processamento lento é repetido e as mensagens são processadas duas vezes.
- Devolver o challenge com response()->json(). As aspas à volta do valor fazem falhar a verificação da Meta.

**Existe um SDK de PHP?** Não da nossa parte, e não é preciso nenhum. A API é da Meta, documentada pela Meta, e o cliente HTTP do Laravel ou o Guzzle acedem-lhe diretamente.

**Isto funciona sem Laravel?** Sim. Em PHP simples, leia $_GET['hub_challenge'], devolva-o como text/plain e envie com cURL. A regra dos sublinhados aplica-se a todas as frameworks de PHP.

**Porque é que o URL precisa de uma chave no caminho?** Porque é a autenticação que funciona. A assinatura da Meta usa o app secret do Tech Provider, que nunca é partilhado, e por isso o segredo no URL é o que impede estranhos de enviar eventos falsos.

**A equipa pode continuar a usar o telemóvel?** Sim. A Coexistence mantém a app WhatsApp Business a funcionar no número, e as mensagens enviadas a partir do telemóvel chegam à sua rota como eventos echo.

---

## WhatsApp Coexistence no Brasil: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-brazil

A Coexistence está disponível no Brasil: a documentação da Meta sobre a adesão de utilizadores da app WhatsApp Business não impõe qualquer restrição geográfica. As mensagens para números +55 são cobradas segundo a tabela de tarifas da Meta para o Brasil, que desde 1 de outubro de 2026 cobra USD 0,0625 por template de marketing e USD 0,0068 por template de utilidade ou autenticação, com as tarifas em BRL publicadas em paralelo.

### A WhatsApp Coexistence está disponível no Brasil?

Sim. A documentação atual da Meta sobre a adesão de utilizadores da app WhatsApp Business enumera os requisitos que um número tem de cumprir, e nenhum deles é um país. Um número brasileiro qualifica-se nas mesmas condições que qualquer outro: já está em uso na app WhatsApp Business, a app está na versão 2.24.17 ou mais recente, e a adesão faz-se através de um Tech Provider ou Solution Partner com Embedded Signup.

Depois de ligado, a app no telemóvel continua a funcionar e o mesmo número +55 ganha acesso à Cloud API. A Meta fixa o throughput destes números em 20 mensagens por segundo, para manter a compatibilidade com a app.

### Quanto cobra a Meta por mensagem no Brasil?

A Meta cobra por mensagem entregue, por categoria e pelo indicativo do país do destinatário. O Brasil (+55) é um mercado identificado na tabela de tarifas, pelo que as mensagens para números brasileiros são cobradas às tarifas próprias do Brasil e não a uma média regional. Estas são as tarifas de tabela em vigor desde 1 de outubro de 2026, retiradas das tabelas da Meta em USD e BRL. As tarifas de utilidade e autenticação podem descer ainda mais com escalões de volume mensal, que a Meta aplica por mercado e categoria.

### Que mensagens continuam gratuitas?

Há três coisas que não custam nada. As mensagens escritas na app WhatsApp Business no telemóvel continuam gratuitas após a adesão, porque a Meta só aplica os preços da Cloud API ao que é enviado através da API. Cada número de telefone empresarial tem 1 000 mensagens de serviço gratuitas por mês, as respostas sem template enviadas dentro da janela de atendimento ao cliente de 24 horas. E tudo o que é enviado dentro de uma janela de ponto de entrada gratuito, aberta quando um cliente chega através de um anúncio Click to WhatsApp, é gratuito durante até 7 dias.

Duas coisas mudaram a 1 de outubro de 2026: as mensagens de serviço além das primeiras 1 000 de cada mês são cobradas, e os templates de utilidade enviados dentro da janela de atendimento ao cliente também são cobrados.

### A Meta fatura em reais às empresas brasileiras?

Agora sim. A Meta iniciou a localização da faturação para o Brasil a 1 de julho de 2026. Os Solution Providers e as empresas com integração direta cujo país Sold-To no Billing Hub seja o Brasil podem criar contas Messaging em BRL, e os encargos dessas contas são faturados em BRL pela Facebook Brasil, a entidade local da Meta.

A mudança tem um prazo. Os clientes elegíveis têm de passar todas as contas Messaging do seu portefólio empresarial para BRL até 30 de junho de 2027, porque a partir de 1 de julho de 2027 a Meta deixa de entregar mensagens das contas que não estejam em BRL. A Meta disponibiliza uma Currency Migration API para essa passagem, uma vez que a moeda escolhida na criação da conta não pode ser alterada de outra forma.

1. Check the number: Confirm the +55 number is on the WhatsApp Business app, version 2.24.17 or newer, and not attached to another provider.
2. Set up billing: Add a payment method in Billing Hub, in BRL if your Sold-To country is Brazil.
3. Run Embedded Signup: Log in with Facebook, choose the portfolio and the number, and confirm the connection in the app.

- Manter uma conta Messaging em USD depois de 30 de junho de 2027 quando o país Sold-To é o Brasil. A Meta deixa de entregar as suas mensagens a partir de 1 de julho de 2027.
- Tratar todas as respostas como gratuitas. Desde 1 de outubro de 2026, as mensagens de serviço além de 1 000 por número por mês são cobradas.
- Orçamentar consoante o local onde a empresa se situa. A Meta fixa os preços pelo indicativo do destinatário, pelo que uma mensagem para um número português é cobrada às tarifas do Resto da Europa Ocidental.

**É preciso ter uma empresa brasileira para usar a Coexistence?** Não. Os requisitos da Meta dizem respeito ao número e à app, não ao local onde a empresa está registada. A localização da empresa só determina a moeda e a entidade da Meta que lhe fatura.

**A tarifa em BRL é igual à tarifa em USD?** A Meta publica uma tabela de tarifas separada por moeda. Para o Brasil, a tabela de 1 de outubro de 2026 indica BRL 0,3217 para marketing e BRL 0,035 para utilidade e autenticação.

**As mensagens que envio do telemóvel têm algum custo?** Não. A documentação da Meta indica que as mensagens enviadas através da app WhatsApp Business continuam gratuitas após a adesão. Só os envios por API seguem os preços da Cloud API.

**O que acontece se a minha conta não tiver método de pagamento?** A Meta continua a entregar mensagens de serviço dentro do escalão gratuito de 1 000, mas deixa de as entregar quando o escalão se esgota. Adicione um método no Billing Hub antes de enviar o que quer que a Meta cobre.

---

## WhatsApp Coexistence no México: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-mexico

A Coexistence está disponível no México, uma vez que a documentação da Meta para a integração de utilizadores da app WhatsApp Business não define qualquer restrição geográfica. As mensagens para números +52 são cobradas segundo a tabela de tarifas da Meta para o México: a partir de 1 de outubro de 2026, USD 0.0397 por template de marketing e USD 0.0085 por template de utilidade ou autenticação, ou MXN 0.7298 e MXN 0.1565 na tabela em pesos.

### Uma empresa mexicana pode usar a WhatsApp Coexistence?

Sim. Os requisitos na documentação da Meta para integrar utilizadores da app WhatsApp Business dizem respeito ao número e à app, não ao país: o número já está ativo na app WhatsApp Business, a app tem a versão 2.24.17 ou superior, e a ligação é feita através do Embedded Signup por um Tech Provider ou Solution Partner.

Um número +52 que cumpra estas condições continua a funcionar na app no telemóvel e ganha acesso à Cloud API no mesmo número. A Meta limita o throughput da API nestes números partilhados a 20 mensagens por segundo.

### Quanto cobra a Meta por mensagem no México?

A Meta cobra por mensagem entregue, e a tarifa depende de duas coisas: a categoria da mensagem e o indicativo do país de quem a recebe. O México (+52) tem uma linha própria na tabela de tarifas. Estas são as tarifas de lista em vigor desde 1 de outubro de 2026, data em que a Meta aumentou a tarifa de marketing para o México. Um maior volume mensal pode desbloquear tarifas mais baixas de utilidade e autenticação através dos escalões de volume da Meta.

### O que não custa nada?

Tudo o que for escrito no telemóvel na app WhatsApp Business, que segundo a documentação da Meta continua gratuito depois de o número ser integrado. Só as mensagens enviadas através da Cloud API seguem os preços da Cloud API.

Do lado da API, cada número de telefone empresarial tem 1.000 mensagens de serviço gratuitas por mês, que são respostas sem template dentro da janela de atendimento ao cliente de 24 horas, e a quota repõe-se todos os meses sem transitar. Um cliente que chega a partir de um anúncio Click to WhatsApp abre uma janela de ponto de entrada gratuito de até 7 dias, na qual a Meta não cobra mensagens de marketing, utilidade, autenticação nem serviço.

### Pode a Meta faturar uma conta mexicana em pesos?

O MXN é uma das 16 moedas que a Meta ativa na WhatsApp Business Platform, lançado a 1 de janeiro de 2026, e a Meta publica uma tabela de tarifas completa em MXN a par da de USD.

A moeda é escolhida quando a conta de mensagens é criada e não pode simplesmente ser alterada depois. A Meta disponibiliza uma Currency Migration API para mudar de moeda mais tarde. Ao contrário do Brasil e da Índia, a página de preços da Meta não descreve uma migração obrigatória de faturação local para o México, pelo que escolher MXN ou USD é decisão da empresa.

1. Check the number: Make sure the +52 number runs the WhatsApp Business app, version 2.24.17 or newer, and is not attached to another provider.
2. Pick the currency: Choose MXN or USD when the account is created, and add a payment method in Billing Hub.
3. Connect: Run Embedded Signup, select the portfolio and the number, and confirm the connection from the app.

- Criar a conta em USD quando se queriam pesos. A moeda fica fixa na criação e alterá-la exige a Currency Migration API da Meta.
- Usar valores de tarifas anteriores a 1 de outubro de 2026. A Meta aumentou nessa data a tarifa de marketing para o México.
- Assumir que uma resposta é sempre gratuita. Acima de 1.000 mensagens de serviço por número e por mês, a Meta cobra-as.

**Um número móvel +52 1 é tratado de forma diferente?** A Meta associa todo o indicativo +52 ao mercado do México, pelo que cada destinatário mexicano paga a tarifa do México para a categoria da mensagem.

**As tarifas do México mudaram recentemente?** Sim. A atualização da Meta de 1 de outubro de 2026 aumentou a tarifa de marketing do México. As tarifas de utilidade e autenticação não constavam dessa lista de alterações.

**Enviar mensagens a clientes nos Estados Unidos custa o mesmo?** Não. Os números dos EUA ficam na região da América do Norte da Meta, que tem tarifas próprias. O indicativo do destinatário decide o preço.

**Perco a app quando ligo a API?** Não. O número continua na app WhatsApp Business e o telemóvel continua a enviar e a receber como antes.

---

## WhatsApp Coexistence na Colômbia: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-colombia

A Coexistence está disponível na Colômbia: a documentação da Meta sobre o registo de utilizadores da app WhatsApp Business não contém qualquer restrição por país. As mensagens para números +57 seguem a tabela de tarifas da Meta para a Colômbia, que desde 1 de outubro de 2026 indica USD 0.0125 por template de marketing e USD 0.0008 por template de utilidade ou autenticação, ou COP 46.0227 e COP 2.9455 na tabela em pesos.

### A WhatsApp Coexistence funciona com números colombianos?

Sim. A documentação da Meta sobre o registo de utilizadores da app WhatsApp Business indica as condições que um número deve cumprir, e nenhuma é geográfica. Um número +57 qualifica-se quando já está a ser usado na app WhatsApp Business, a app tem a versão 2.24.17 ou posterior e o registo é feito através do Embedded Signup, executado por um Tech Provider ou Solution Partner.

Depois do registo, o telemóvel continua a funcionar como antes, com as conversas todas, enquanto o mesmo número responde através da Cloud API. O throughput do lado da API é fixo em 20 mensagens por segundo para números partilhados.

### Quais são as tarifas por mensagem da Meta para a Colômbia?

A Meta cobra cada mensagem entregue de acordo com a sua categoria e com o indicativo do país do destinatário. A Colômbia (+57) é um mercado identificado e, na tabela de 1 de outubro de 2026, tem as tarifas de marketing e de utilidade mais baixas de todos os mercados latino-americanos que a Meta indica, incluindo a região Resto da América Latina. Os valores abaixo são tarifas de lista; os escalões de volume podem reduzir ainda mais a utilidade e a autenticação quando o volume mensal é elevado.

### Que mensagens são gratuitas na Colômbia?

As mesmas que em qualquer outro país, porque os casos gratuitos da Meta são globais e não dependem do mercado.

As mensagens enviadas a partir da app WhatsApp Business no telemóvel continuam gratuitas depois de o número ser ligado; os preços da Cloud API aplicam-se apenas aos envios por API. Cada número de telefone empresarial recebe 1 000 mensagens de serviço gratuitas por mês, para respostas sem template dentro da janela de atendimento ao cliente de 24 horas. As conversas iniciadas a partir de um anúncio Click to WhatsApp abrem uma janela gratuita de ponto de entrada até 7 dias, sem custo em nenhuma categoria, exceto nas mensagens do Meta Business Agent.

Desde 1 de outubro de 2026, os templates de utilidade enviados dentro de uma janela de atendimento ao cliente aberta são cobrados.

### Uma empresa colombiana pode pagar à Meta em pesos?

O COP é uma das moedas que a Meta acrescentou em 2026, disponível desde 1 de abril de 2026, com tabela de tarifas própria. A tabela em COP da Meta apresenta todos os mercados em pesos, pelo que uma empresa colombiana que envie mensagens a clientes no México ou em Espanha vê esses custos também em COP.

A moeda define-se quando a conta de mensagens é criada e fica fixa. Mudar mais tarde faz-se com a Currency Migration API da Meta. A página de preços da Meta descreve migrações obrigatórias de faturação local apenas para o Brasil e a Índia, pelo que, para a Colômbia, o COP é uma opção e não uma obrigação.

1. Check the number: The +57 number must be on the WhatsApp Business app, version 2.24.17 or newer, and free of any other provider.
2. Choose COP or USD: Pick the currency at account creation and add a payment method in Billing Hub.
3. Run Embedded Signup: Log in with Facebook, select the portfolio and the number, and confirm in the app.

- Aplicar a tarifa da Colômbia a todos os clientes. Uma mensagem para um número peruano ou chileno é cobrada à tarifa desse mercado, que na tabela de outubro de 2026 é várias vezes superior.
- Escolher a moeda de faturação sem ponderar. Depois de a conta existir, mudar exige a Currency Migration API da Meta.
- Deixar a conta sem método de pagamento. As mensagens de serviço deixam de ser entregues quando as 1 000 gratuitas do mês se esgotam.

**Porque são as tarifas da Colômbia tão inferiores às dos países vizinhos?** A Meta define as tarifas por mercado e não explica cada valor. A tabela de 1 de outubro de 2026 limita-se a indicar a Colômbia abaixo dos outros mercados latino-americanos.

**A autenticação tem um preço diferente da utilidade?** Não para a Colômbia. Ambas custam USD 0.0008 na tabela de 1 de outubro de 2026, e não se aplica nenhuma tarifa de autenticação internacional.

**Pago pelas mensagens que os clientes me enviam?** Não. A Meta não cobra as mensagens de utilizadores para empresas, apenas as mensagens que uma empresa entrega.

**A app mantém o meu histórico de conversas?** Sim. A app WhatsApp Business continua a funcionar no telemóvel, com as suas conversas, depois de o número ser ligado à API.

---

## WhatsApp Coexistence na Argentina: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-argentina

A Coexistence está disponível na Argentina, porque a documentação de onboarding da Meta para utilizadores da app WhatsApp Business não impõe nenhuma restrição geográfica. As mensagens para números +54 são cobradas às tarifas próprias da Argentina: a partir de 1 de outubro de 2026, USD 0,0618 por template de marketing e USD 0,026 por template de utilidade ou autenticação, ou ARS 89,562 e ARS 37,6798 na tabela de tarifas em pesos da Meta.

### A Coexistence está disponível para números argentinos?

Sim. Nada na documentação da Meta sobre o onboarding de utilizadores da app WhatsApp Business depende do país. A Meta verifica o número e a app: um número +54 já ativo na app WhatsApp Business, com a versão 2.24.17 ou posterior, ligado através do Embedded Signup por um Tech Provider ou Solution Partner.

O resultado é um só número usado de duas formas. A equipa continua a responder a partir do telemóvel, e o software envia e recebe através da Cloud API, com um limite da Meta de 20 mensagens por segundo enquanto o número é partilhado com a app.

### Quanto cobra a Meta por mensagem na Argentina?

Cada mensagem entregue é cobrada por categoria, à tarifa do mercado a que pertence o indicativo do destinatário. A Argentina (+54) é um mercado autónomo na tabela da Meta. Estas são as tarifas de lista em vigor a partir de 1 de outubro de 2026, retiradas das tabelas da Meta em USD e ARS. Para utilidade e autenticação, os escalões de volume mensal da Meta reduzem a tarifa quando um portefólio envia mensagens suficientes para a Argentina num mês.

### O que pode uma empresa argentina enviar gratuitamente?

As respostas escritas no telemóvel não têm custo: a documentação da Meta indica que as mensagens enviadas pela app WhatsApp Business continuam gratuitas após o onboarding, e só os envios por API seguem os preços da Cloud API.

Pela API, cada número de telefone da empresa tem uma quota mensal de 1 000 mensagens de serviço gratuitas, ou seja, respostas sem template dentro da janela de atendimento ao cliente de 24 horas. A quota é reposta todos os meses e as mensagens não utilizadas não transitam. Os clientes que escrevem a partir de um anúncio Click to WhatsApp abrem uma janela de ponto de entrada gratuito com duração até 7 dias, durante a qual as mensagens de marketing, utilidade, autenticação e serviço não são cobradas.

### A Meta pode faturar uma conta argentina em pesos?

O ARS passou a estar disponível como moeda da WhatsApp Business Platform a 1 de abril de 2026, e a Meta publica uma tabela de tarifas completa em ARS ao lado da tabela em USD. A tabela em pesos indica todos os mercados em ARS, não apenas a Argentina.

A moeda é definida quando a conta de mensagens é criada e não pode ser alterada livremente depois; a Meta disponibiliza uma Currency Migration API para esse efeito. A página de preços da Meta descreve a faturação local obrigatória apenas para o Brasil e a Índia, pelo que, no caso da Argentina, a escolha entre ARS e USD fica ao critério da empresa.

1. Check the number: The +54 number must run the WhatsApp Business app at version 2.24.17 or newer and not be connected to another provider.
2. Set the currency and payment: Choose ARS or USD when the account is created and add a payment method in Billing Hub.
3. Connect the number: Complete Embedded Signup with the portfolio and number, then confirm the link in the app.

- Presumir que se aplica uma tarifa regional da América Latina. A Argentina tem uma linha própria na tabela da Meta, com valores diferentes dos de Rest of Latin America.
- Enviar templates de utilidade como respostas e esperar que sejam gratuitos. Desde 1 de outubro de 2026, a Meta cobra os templates de utilidade dentro da janela de atendimento ao cliente.
- Ler uma tabela de tarifas sem a sua data. A Meta publica as tabelas com data de entrada em vigor, e os valores aqui indicados são os de 1 de outubro de 2026.

**A Meta cobra as mensagens que os meus clientes me enviam?** Não. A Meta cobra apenas as mensagens que uma empresa entrega a utilizadores, nunca as mensagens que os utilizadores enviam à empresa.

**Os valores em ARS vão mudar com a taxa de câmbio?** A Meta publica a tabela de cada moeda com data de entrada em vigor e atualiza as tarifas no seu próprio calendário. Consulte a tabela em ARS em vigor, em vez de converter a de USD.

**A tarifa de autenticação é igual à de utilidade na Argentina?** Sim. Ambas são USD 0,026 na tabela de 1 de outubro de 2026, e a Meta não indica nenhuma tarifa de autenticação internacional para a Argentina.

**Posso continuar a usar a app depois de ligar o número?** Sim. A app WhatsApp Business continua a funcionar no telemóvel, e o mesmo número ganha acesso à API.

---

## WhatsApp Coexistence no Chile: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-chile

A Coexistence está disponível no Chile: a documentação da Meta sobre a adesão de utilizadores da app WhatsApp Business não define nenhuma condição geográfica. As mensagens para números +56 seguem a tabela de tarifas da Meta para o Chile, que a partir de 1 de outubro de 2026 cobra USD 0,0889 por template de marketing e USD 0,02 por template de utilidade ou de autenticação, ou CLP 78,4917 e CLP 17,6584 na tabela em pesos.

### As empresas chilenas podem usar a WhatsApp Coexistence?

Sim. A documentação da Meta sobre a adesão de utilizadores da app WhatsApp Business enumera condições relativas ao número, à app e ao parceiro, e nenhuma relativa ao país. Um número +56 qualifica-se desde que esteja em utilização na app WhatsApp Business, na versão 2.24.17 ou posterior, e seja ligado através do Embedded Signup por um Tech Provider ou Solution Partner.

O telemóvel continua a funcionar com as suas conversas, e o número ganha acesso à Cloud API com um limite fixo de 20 mensagens por segundo, o limite que a Meta aplica a números partilhados com a app.

### Quanto cobra a Meta por mensagem no Chile?

A Meta cobra por mensagem entregue, por categoria, à tarifa do mercado do destinatário. O Chile (+56) é um mercado com nome próprio, e a sua tarifa de marketing na tabela de 1 de outubro de 2026 é a mais alta de todas as entradas da América Latina, acima até da região Resto da América Latina. A utilidade e a autenticação ficam em USD 0,02, e os escalões de volume mensal da Meta podem reduzir estas duas para portefólios empresariais que enviem grandes volumes para o Chile.

### Que mensagens para o Chile a Meta não cobra?

Tudo o que é enviado a partir da própria app WhatsApp Business. A documentação da Meta indica que as mensagens da app continuam gratuitas após a adesão e que só os envios pela Cloud API são tarifados.

Na API, a Meta não cobra as primeiras 1.000 mensagens de serviço por número de telefone empresarial em cada mês, ou seja, as respostas sem template enviadas dentro da janela de atendimento ao cliente de 24 horas. E uma conversa iniciada a partir de um anúncio Click to WhatsApp abre uma janela de ponto de entrada gratuito de até 7 dias, na qual nenhuma categoria é cobrada, exceto as mensagens do Meta Business Agent.

Com a tarifa de marketing do Chile, a janela de ponto de entrada gratuito é o caminho mais barato para enviar mensagens promocionais nesse mercado.

### A Meta oferece faturação em pesos chilenos?

Sim, como opção. O CLP foi ativado a 1 de abril de 2026 como uma das moedas que a Meta acrescentou nesse ano, e a Meta publica uma tabela de tarifas em CLP que abrange todos os mercados, pelo que as mensagens para clientes no estrangeiro também aparecem em pesos.

A moeda de faturação escolhe-se quando a conta de mensagens é criada e fica fixa a partir daí, a menos que a empresa use a Currency Migration API da Meta. A página de preços da Meta descreve a faturação local obrigatória apenas para o Brasil e a Índia; uma empresa chilena escolhe ela própria entre CLP e USD.

1. Check the number: The +56 number must be on the WhatsApp Business app, version 2.24.17 or newer, and not connected to another provider.
2. Choose CLP or USD: Set the currency at account creation and add a payment method in Billing Hub.
3. Connect: Run Embedded Signup, pick the portfolio and the number, and confirm from the app.

- Usar por predefinição um template de marketing em todos os seguimentos. No Chile são USD 0,0889 por mensagem, contra USD 0,02 por um template de utilidade corretamente categorizado.
- Esperar que a franquia de serviço se acumule. As 1.000 mensagens de serviço gratuitas repõem-se todos os meses e as não utilizadas não transitam.
- Calcular o preço de uma campanha chilena com os valores do Resto da América Latina. O Chile é um mercado com nome próprio e tarifas próprias.

**O Chile é mais barato do que a Argentina em marketing?** Não. Na tabela de 1 de outubro de 2026, a tarifa de marketing do Chile é USD 0,0889 e a da Argentina é USD 0,0618.

**A Meta pode recategorizar o meu template?** Sim. A Meta revê as categorias dos templates e pode alterar a categoria de um template, o que muda a tarifa cobrada por ele.

**As mensagens recebidas têm algum custo?** Não. A Meta cobra apenas as mensagens que uma empresa entrega, não as mensagens que os clientes enviam.

**O número continua a funcionar na app?** Sim. A app WhatsApp Business continua ativa no telemóvel depois de o número ser ligado à API.

---

## WhatsApp Coexistence no Peru: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-peru

A Coexistence está disponível no Peru, porque a documentação de onboarding da Meta para utilizadores da app WhatsApp Business não contém qualquer restrição por país. As mensagens para números +51 seguem a tabela de tarifas do Peru: a partir de 1 de outubro de 2026, USD 0,0703 por template de marketing e USD 0,03 por template utilitário ou de autenticação, ou PEN 0,2339 e PEN 0,0998 na tabela da Meta em soles.

### A WhatsApp Coexistence está disponível no Peru?

Sim. A documentação da Meta para o onboarding de utilizadores da app WhatsApp Business impõe requisitos ao número e à app, e não ao país. Um número +51 qualifica-se quando já está ativo na app WhatsApp Business, a app tem a versão 2.24.17 ou posterior e o onboarding é feito através do Embedded Signup com um Tech Provider ou Solution Partner.

Depois de ligado, o telemóvel continua a enviar e a receber, enquanto o mesmo número passa a ficar acessível através da Cloud API. A Meta fixa o throughput da API para números partilhados com a app em 20 mensagens por segundo.

### Quanto cobra a Meta por mensagem no Peru?

A Meta cobra por mensagem entregue, com preço definido pela categoria e pelo mercado do indicativo do destinatário. O Peru (+51) tem uma linha própria. A 1 de outubro de 2026, a Meta aumentou as tarifas utilitárias e de autenticação do Peru, que ficam agora em USD 0,03, a tarifa utilitária mais alta entre os mercados da América Latina na tabela. Estas são tarifas de lista; os escalões de volume podem reduzir as tarifas utilitárias e de autenticação para grandes volumes mensais.

### O que continua gratuito para uma empresa peruana?

As mensagens enviadas a partir da app WhatsApp Business no telemóvel. A documentação da Meta indica que continuam gratuitas após o onboarding e que só as mensagens enviadas através da Cloud API são cobradas.

Pela API, a Meta oferece a cada número de telefone empresarial 1 000 mensagens de serviço gratuitas por mês, as respostas sem template enviadas enquanto a janela de atendimento ao cliente de 24 horas está aberta, com reposição mensal. Os clientes que chegam através de um anúncio Click to WhatsApp abrem uma janela de ponto de entrada gratuita de até 7 dias, durante a qual a Meta não cobra mensagens de marketing, utilitárias, de autenticação nem de serviço.

Os templates utilitários enviados dentro da janela de atendimento ao cliente são cobrados desde 1 de outubro de 2026.

### A Meta pode faturar uma conta peruana em soles?

O PEN está disponível, tendo sido lançado a 1 de abril de 2026 entre as moedas que a Meta acrescentou nesse ano, e a Meta publica uma tabela de tarifas em PEN que abrange todos os mercados em que define preços.

A moeda escolhe-se quando a conta de mensagens é criada e fica fixa a partir daí, exceto através da Currency Migration API da Meta. A página de preços da Meta descreve migrações obrigatórias de faturação local apenas para o Brasil e a Índia, pelo que uma empresa peruana decide por si entre PEN e USD.

1. Check the number: Confirm the +51 number is on the WhatsApp Business app, version 2.24.17 or newer, and not attached to another provider.
2. Choose PEN or USD: Pick the currency when the account is created and add a payment method in Billing Hub.
3. Run Embedded Signup: Log in with Facebook, select the portfolio and the number, and confirm the connection in the app.

- Orçamentar envios utilitários com valores anteriores a 1 de outubro de 2026. A Meta aumentou as tarifas utilitárias e de autenticação do Peru nessa data.
- Recorrer a templates utilitários para responder. Dentro de uma janela aberta, uma mensagem de serviço gratuita cumpre a mesma função, até 1 000 por mês e por número.
- Presumir que os mercados vizinhos custam o mesmo. A tarifa utilitária da Colômbia na mesma tabela é de USD 0,0008.

**Porque subiram os meus custos utilitários em outubro de 2026?** A Meta aumentou as tarifas utilitárias e de autenticação do Peru a 1 de outubro de 2026 e, a partir da mesma data, passou a cobrar os templates utilitários enviados dentro da janela de atendimento ao cliente.

**A Meta cobra as mensagens que os clientes me enviam?** Não. Só são cobradas as mensagens entregues pela empresa.

**Existe uma tarifa de autenticação internacional para o Peru?** Não. A tabela de 1 de outubro de 2026 não indica nenhuma para o Peru, pelo que a autenticação é cobrada a USD 0,03.

**A app do telemóvel continua a funcionar?** Sim. A app WhatsApp Business continua a funcionar no telemóvel depois de o número ser ligado à API.

---

## WhatsApp Coexistence na Costa Rica: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-costa-rica

A Coexistência está disponível na Costa Rica, já que a documentação de onboarding da Meta para utilizadores da app WhatsApp Business não define qualquer restrição geográfica. A Costa Rica não tem linha própria na tabela de tarifas da Meta: os números +506 pagam as tarifas do Resto da América Latina, que a partir de 1 de outubro de 2026 são de USD 0,074 por template de marketing e USD 0,0113 por template de utilidade ou de autenticação.

### Um número da Costa Rica pode usar a WhatsApp Coexistence?

Sim. A documentação da Meta para o onboarding de utilizadores da app WhatsApp Business impõe condições ao número e à app, e nenhuma ao país. Um número +506 cumpre os requisitos se já estiver em utilização na app WhatsApp Business, se a app estiver na versão 2.24.17 ou superior e se a ligação for feita com Embedded Signup por um Tech Provider ou Solution Partner.

O telemóvel continua a funcionar com as conversas existentes e o número passa a ter acesso à Cloud API. A Meta fixa o throughput em 20 mensagens por segundo para os números partilhados entre a app e a API.

### Porque é que a Costa Rica tem preços do Resto da América Latina?

A tabela de tarifas da Meta nomeia 39 países individuais e agrupa os restantes em 8 regiões. A Costa Rica (+506) é um dos 15 mercados da região Resto da América Latina, juntamente com países como o Panamá, a Guatemala, o Equador e o Uruguai. Qualquer mensagem entregue a um número de um desses mercados paga a tarifa da região.

A região também conta para os escalões de volume de utilidade e autenticação. Os escalões são contados por mercado e categoria, pelo que as mensagens para todos os países do Resto da América Latina contam para o mesmo escalão regional, e não para um escalão da Costa Rica.

### Que mensagens são gratuitas para uma empresa da Costa Rica?

As que são escritas na app WhatsApp Business no telemóvel. A documentação da Meta indica que as mensagens da app continuam gratuitas após o onboarding e que os preços da Cloud API abrangem apenas os envios pela API.

Na vertente da API, cada número de telefone da empresa tem 1 000 mensagens de serviço gratuitas por mês, que são respostas sem template dentro da janela de atendimento ao cliente de 24 horas, sem acumulação para o mês seguinte. Uma conversa iniciada a partir de um anúncio Click to WhatsApp abre uma janela de ponto de entrada gratuito até 7 dias, durante a qual a Meta não cobra mensagens de marketing, utilidade, autenticação nem serviço. Os templates de utilidade enviados dentro da janela de atendimento ao cliente são cobrados desde 1 de outubro de 2026.

### Em que moeda a Meta fatura uma conta da Costa Rica?

A Meta disponibiliza 16 moedas de faturação na WhatsApp Business Platform e o colón costa-riquenho não está entre elas. Uma empresa da Costa Rica escolhe uma das moedas publicadas quando a conta de mensagens é criada, por exemplo USD, e a Meta publica a tarifa do Resto da América Latina em cada uma das suas tabelas de tarifas.

Depois de a conta existir, a moeda não pode ser alterada livremente. A Meta disponibiliza uma Currency Migration API para fazer a mudança. A página de preços da Meta não indica nenhum programa de faturação local para a Costa Rica.

1. Check the number: The +506 number must be on the WhatsApp Business app, version 2.24.17 or newer, and not attached to another provider.
2. Set up billing: Choose one of Meta's supported currencies, such as USD, and add a payment method in Billing Hub.
3. Connect: Complete Embedded Signup with the portfolio and the number, and confirm the link from the app.

- Procurar na tabela de tarifas uma linha da Costa Rica. Não existe: o +506 é faturado como Resto da América Latina.
- Presumir que os vizinhos da América Central partilham a tarifa do México. O México é um mercado nomeado, com tarifas de marketing inferiores às da região.
- Gastar templates de utilidade em respostas. Uma mensagem de serviço dentro da janela aberta é gratuita até 1 000 por mês e por número.

**Enviar mensagens para a Costa Rica é mais barato do que para o México?** Não, no caso do marketing. O Resto da América Latina custa USD 0,074 por template de marketing na tabela de 1 de outubro de 2026, contra USD 0,0397 para o México.

**Posso pagar à Meta em colones?** Não. O colón não é uma das 16 moedas que a Meta disponibiliza na WhatsApp Business Platform.

**As mensagens dos clientes para mim têm algum custo?** Não. A Meta cobra apenas as mensagens que as empresas entregam.

**Ligar a API faz parar a app?** Não. A app WhatsApp Business continua a funcionar no telemóvel com as respetivas conversas.

---

## WhatsApp Coexistence em Espanha: disponibilidade e tarifas da Meta

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-spain

A Coexistence está disponível em Espanha: a documentação de onboarding da Meta para utilizadores da app WhatsApp Business não impõe qualquer restrição geográfica, incluindo a UE. As mensagens para números +34 usam a tabela de tarifas própria de Espanha, que desde 1 de outubro de 2026 indica EUR 0,0585 por template de marketing e EUR 0,0166 por template de utilidade ou de autenticação, ou USD 0,0707 e USD 0,02.

### A WhatsApp Coexistence está disponível em Espanha e na UE?

Sim. A documentação atual da Meta para o onboarding de utilizadores da app WhatsApp Business indica requisitos sobre o número, a app e o parceiro, e nenhuma restrição geográfica. Um número +34 cumpre os requisitos quando já está em uso na app WhatsApp Business, tem a versão 2.24.17 ou posterior e é ligado através do Embedded Signup por um Tech Provider ou Solution Partner.

Continuam a circular listas do início do lançamento que deixavam a UE de fora, e a documentação da Meta já não as sustenta. Depois do onboarding, o telemóvel continua a funcionar e o número responde através da Cloud API a um ritmo fixo de 20 mensagens por segundo.

### Quanto cobra a Meta por mensagem em Espanha?

A Meta cobra por mensagem entregue, por categoria e pelo mercado do indicativo do destinatário. Espanha (+34) é um mercado com nome próprio, separado da região Resto da Europa Ocidental, que abrange Portugal, a Irlanda e outros. Estas são as tarifas de tabela em vigor desde 1 de outubro de 2026; a tarifa de marketing foi aumentada pela última vez a 1 de julho de 2026. Os escalões de volume podem reduzir a tarifa de utilidade e de autenticação para portefólios com volume mensal elevado para Espanha.

### Que mensagens são gratuitas para uma empresa espanhola?

As mensagens enviadas a partir da app WhatsApp Business no telemóvel. A documentação da Meta indica que continuam gratuitas após o onboarding, e os preços da Cloud API aplicam-se apenas ao que passa pela API.

Pela API, a Meta atribui a cada número de telefone da empresa 1 000 mensagens de serviço gratuitas por mês, ou seja, as respostas sem template enviadas dentro da janela de atendimento ao cliente de 24 horas, com reposição mensal. Um cliente que chega a partir de um anúncio Click to WhatsApp abre uma janela de ponto de entrada gratuita de até 7 dias, sem custo para mensagens de marketing, utilidade, autenticação ou serviço.

Desde 1 de outubro de 2026, os templates de utilidade enviados dentro de uma janela de atendimento ao cliente aberta são cobrados.

### A Meta pode faturar uma empresa espanhola em euros?

Sim. O EUR já era uma moeda disponível na WhatsApp Business Platform antes de a Meta acrescentar mais dez em 2026, e a Meta publica uma tabela de tarifas completa em EUR, na qual todos os mercados, e não apenas Espanha, têm preços em euros.

A moeda é escolhida quando a conta de mensagens é criada e fica fixa a partir daí, exceto através da Currency Migration API da Meta. A página de preços da Meta descreve migrações obrigatórias para faturação local apenas para o Brasil e a Índia, pelo que uma empresa espanhola escolhe por si o EUR ou outra moeda suportada.

1. Check the number: The +34 number must be on the WhatsApp Business app, version 2.24.17 or newer, and not attached to another provider.
2. Choose EUR or USD: Set the currency when the account is created and add a payment method in Billing Hub.
3. Run Embedded Signup: Log in with Facebook, select the portfolio and the number, and confirm the connection in the app.

- Confiar numa lista antiga de disponibilidade que exclui a UE. A documentação atual de onboarding da Meta não tem restrição geográfica.
- Aplicar a clientes portugueses a tarifa de Espanha. Portugal (+351) pertence ao Resto da Europa Ocidental, que tem tarifas diferentes.
- Usar valores de marketing anteriores a 1 de julho de 2026. A Meta aumentou a tarifa de marketing de Espanha nessa data.

**A Coexistence já esteve indisponível na UE?** As listas do início do lançamento excluíam-na. A documentação atual de onboarding da Meta para utilizadores da app Business não indica restrição geográfica, pelo que o próprio fluxo é o teste.

**Enviar mensagens para a América Latina a partir de Espanha é cobrado à tarifa de Espanha?** Não. A Meta cobra pelo indicativo do destinatário, pelo que uma mensagem para um número mexicano é cobrada à tarifa do México.

**Pago pelas mensagens que os clientes me enviam?** Não. A Meta cobra apenas as mensagens que uma empresa entrega a utilizadores.

**A app continua a funcionar depois de ligar o número?** Sim. A app WhatsApp Business permanece no telemóvel com as suas conversas, e o número passa a ter acesso à API.

---

## WhatsApp Coexistence na Índia: disponibilidade, tarifas da Meta e faturação em INR

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-india

A Coexistence está disponível para números indianos: a documentação de onboarding da Meta para utilizadores da app WhatsApp Business não indica nenhuma restrição por país. A partir de 1 de outubro de 2026, a Meta cobra US$ 0,0118 por cada template de marketing entregue a um número +91 e US$ 0,0014 por cada template de utilidade ou de autenticação. As empresas cujo país Sold-To no Billing Hub é a Índia têm de passar todas as contas WhatsApp Business para INR até 31 de dezembro de 2026.

### A WhatsApp Coexistence está disponível na Índia?

Sim. A documentação atual da Meta para o onboarding de utilizadores da app WhatsApp Business indica os requisitos (app na versão 2.24.17 ou superior, e um Tech Provider ou Solution Partner a executar o Embedded Signup) e uma limitação, um throughput fixo de 20 mensagens por segundo. Não refere nenhuma restrição de país, região ou indicativo telefónico, pelo que um número +91 ativo na app WhatsApp Business cumpre as mesmas condições que um número de qualquer outro local.

O que impede um número indiano é o que impede qualquer número: continuar na app WhatsApp de consumidor, ter uma versão da app anterior à 2.24.17 ou já estar associado a outro fornecedor. Se o Embedded Signup não recusar o número, a Coexistence está disponível para ele.

### Quanto cobra a Meta por mensagem na Índia?

A Meta cobra por cada mensagem de template entregue, e a tarifa depende do indicativo do país do destinatário, não da localização da empresa. Um template entregue a um número +91 é cobrado à tarifa da Índia, esteja o remetente onde estiver.

Os valores indicados vêm das tabelas de tarifas da Meta em USD e INR em vigor desde 1 de outubro de 2026. As respostas que não são templates, dentro de uma janela de atendimento ao cliente de 24 horas aberta, são gratuitas, tal como os templates de utilidade enviados dentro dessa janela, e as mensagens escritas na app WhatsApp Business num número com Coexistence continuam gratuitas. Os templates de marketing são sempre cobrados. Os escalões mensais de volume da Meta podem reduzir as tarifas de utilidade e de autenticação para grandes remetentes.

### O que muda com a faturação em INR na Índia?

A Meta lançou a localização da faturação em INR a 1 de janeiro de 2026 para parceiros e empresas com integração direta cujo país Sold-To no Billing Hub é a Índia. Essas empresas têm de ter todas as contas WhatsApp Business do seu portefólio migradas para INR até 31 de dezembro de 2026. A Meta indica que, a partir de 1 de janeiro de 2027, deixará de entregar as mensagens das contas que não estejam em INR pertencentes a clientes elegíveis.

Num número com Coexistence, isto afeta os envios pagos através da API, porque o método de pagamento está na conta WhatsApp Business da própria empresa. A Índia tem também uma tarifa de autenticação internacional, que se aplica a uma empresa elegível sediada fora da Índia assim que a Meta definir a data de início, com 30 dias de aviso.

### Como se liga um número indiano à API e se mantém a app?

Através do Embedded Signup da Meta com a opção Coexistence, executado por um Tech Provider. A empresa inicia sessão com o Facebook, seleciona o seu Portefólio empresarial, introduz o número +91 já registado na app WhatsApp Business e confirma ao ler um QR code apresentado na app. O histórico de conversas da app pode então ser sincronizado, com os conteúdos multimédia disponíveis apenas relativos às últimas duas semanas.

O número continua a funcionar na app e ganha acesso à Cloud API com um débito fixo de 20 mensagens por segundo. A sequência completa, com o que cada ecrã pede, está na página sobre como ligar um número.

- Deixar uma conta WhatsApp Business em USD depois de 31 de dezembro de 2026 quando o país Sold-To é a Índia. A Meta já indicou que deixará de entregar essas mensagens.
- Calcular o custo de uma campanha com base no país do remetente. A Meta cobra pelo indicativo do destinatário, por isso os destinatários +91 custam a tarifa da Índia.
- Tratar todos os templates como de utilidade. Um template que a Meta classifica como de marketing custa mais de oito vezes a tarifa de utilidade na Índia.

**As respostas a clientes indianos são gratuitas?** As respostas que não são templates, dentro da janela de atendimento ao cliente de 24 horas, são gratuitas, tal como as mensagens escritas na app WhatsApp Business. Os templates fora da janela são cobrados.

**Em que moeda a Meta fatura as empresas indianas?** As empresas cujo país Sold-To no Billing Hub é a Índia estão a passar para INR, com todas as contas em INR até 31 de dezembro de 2026. A Meta publica uma tabela de tarifas em INR para o efeito.

**Pago a tarifa da Índia se a minha empresa estiver no estrangeiro?** Sim, no marketing e na utilidade, porque a tarifa depende do indicativo +91 do destinatário. A autenticação pode passar para a tarifa de autenticação internacional assim que a Meta definir uma data de início para a sua empresa.

**Posso continuar a usar a app no telemóvel?** Sim. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número, desde que esteja na versão 2.24.17 ou superior e seja aberta com regularidade.

---

## WhatsApp Coexistence na Indonésia: disponibilidade, tarifas da Meta e configuração

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-indonesia

Os números indonésios podem usar a Coexistence, porque a documentação de onboarding da Meta para utilizadores da app Business não define qualquer restrição por país. A partir de 1 de outubro de 2026, a Meta cobra US$ 0.0411 (IDR 586.33) por cada template de marketing entregue a um número +62 e US$ 0.025 (IDR 356.65) por cada template de utilidade ou de autenticação. As respostas dentro da janela de atendimento ao cliente continuam gratuitas.

### A WhatsApp Coexistence está disponível na Indonésia?

Sim. A página que a Meta publica sobre a migração de utilizadores da app WhatsApp Business para a Cloud API define requisitos quanto à versão da app (2.24.17 ou superior) e quanto ao parceiro (um Tech Provider ou Solution Partner que use o Embedded Signup), mas não indica nenhum país nem indicativo excluído. Um número +62 registado e ativo na app WhatsApp Business é elegível nas mesmas condições que qualquer outro.

Os obstáculos práticos são os habituais: um número ainda na app WhatsApp de consumidor, uma app desatualizada ou um número já ligado à app de outro fornecedor. A página de elegibilidade trata cada um deles e explica como se resolve.

### Quanto cobra a Meta por mensagem na Indonésia?

A Meta cobra por template entregue, à tarifa do indicativo do país do destinatário. Todos os templates que chegam a um número +62 são cobrados à tarifa da Indonésia, esteja a empresa remetente em Jacarta ou no estrangeiro.

As tarifas abaixo provêm das tabelas da Meta em USD e IDR, em vigor desde 1 de outubro de 2026. Na Indonésia, utilidade e autenticação partilham a mesma tarifa, US$ 0.025, cerca de 61% da tarifa de marketing. As respostas de texto livre dentro de uma janela de atendimento de 24 horas aberta não têm custo, um template de utilidade enviado dentro dessa janela é gratuito, e tudo o que a empresa escreve na app WhatsApp Business num número com Coexistence também é gratuito.

### O que deve uma empresa indonésia saber sobre a moeda de faturação e a autenticação?

O IDR é uma das moedas de faturação em que a Meta publica tabelas de tarifas, a par do USD e de outras catorze, pelo que uma empresa indonésia pode consultar os custos em rupias diretamente na tabela da Meta, sem fazer conversões.

A Indonésia consta também da lista de países da Meta com tarifa de autenticação internacional. Uma empresa sediada fora da Indonésia que envie códigos de utilização única para números +62 pode passar a pagar US$ 0.136 por template de autenticação, mais de cinco vezes a tarifa local. A Meta define a data de início por empresa e dá 30 dias de aviso, pelo que uma app estrangeira que verifique utilizadores indonésios deve prever esse custo antes de aumentar os registos.

### Como se liga um número indonésio sem perder a app?

Com o Embedded Signup da Meta, na opção para um número já existente na app WhatsApp Business. A empresa inicia sessão com o Facebook, escolhe o seu Portefólio empresarial, introduz o número +62 e lê o código QR apresentado pela app. Concluído este passo, o parceiro tem 24 horas para iniciar a sincronização dos contactos e do histórico de conversas, caso contrário a empresa tem de repetir o processo.

Depois do onboarding, o telemóvel continua a funcionar como antes, o número responde também pela Cloud API, e ambos partilham um limite fixo de 20 mensagens por segundo. A página sobre como ligar um número percorre cada ecrã.

- Converter manualmente um preço em USD para rupias. A Meta publica uma tabela de tarifas em IDR, e é esse o valor cobrado a uma conta em IDR.
- Orçamentar códigos de utilização única à tarifa local numa empresa sediada no estrangeiro. A Indonésia tem uma tarifa de autenticação internacional de US$ 0.136.
- Abandonar o processo depois de ler o código QR. A sincronização tem de começar nas 24 horas seguintes, ou o onboarding tem de ser repetido.

**A tarifa indonésia é a mesma para utilidade e autenticação?** Sim. Na tabela da Meta em vigor desde 1 de outubro de 2026, ambas custam US$ 0.025, ou IDR 356.65, por template entregue.

**A Meta pode faturar-me em rupias?** O IDR é uma das moedas de faturação que a Meta indica na sua página de preços, com tabela de tarifas própria, pelo que os valores em rupias se podem consultar diretamente na Meta.

**As mensagens enviadas pelo telemóvel são cobradas depois de ligar o número?** Não. A Meta indica que as mensagens enviadas a partir da app WhatsApp Business continuam gratuitas após o onboarding da Coexistence. Só os envios pela Cloud API seguem os preços da Cloud API.

**E se o meu número ainda estiver no WhatsApp normal?** Tem primeiro de passar para a app WhatsApp Business. A Coexistence só é oferecida a números que já estejam na app Business.

---

## WhatsApp Coexistence nos EAU: disponibilidade, tarifas da Meta e faturação em AED

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-uae

A Coexistence está disponível para números dos Emirados Árabes Unidos, porque a documentação de onboarding da Meta para utilizadores da app Business não indica qualquer restrição por país. A partir de 1 de outubro de 2026, a Meta cobra US$ 0,0576 (AED 0,2115) por cada template de marketing entregue a um número +971 e US$ 0,0157 (AED 0,0576) por cada template de utilidade ou de autenticação.

### A WhatsApp Coexistence está disponível nos EAU?

Sim. A documentação da Meta para ligar utilizadores da app WhatsApp Business à Cloud API indica o que a empresa e o parceiro precisam, sobretudo a versão 2.24.17 da app ou mais recente e um Tech Provider ou Solution Partner que use o Embedded Signup, e não contém qualquer exclusão por país, região ou indicativo telefónico. Um número +971 em utilização ativa na app WhatsApp Business cumpre os requisitos.

Um número dos EAU falha pelas mesmas razões que um número de qualquer outro país: está na app WhatsApp de consumo, a app está desatualizada, ou o número continua associado a outro fornecedor. O próprio Embedded Signup é o teste fiável, pois ou aceita o número ou diz porque não o aceita.

### Quanto cobra a Meta por mensagem nos EAU?

A Meta cobra por template entregue, com preço definido pelo indicativo do país do destinatário. Qualquer template entregue a um número +971 é faturado à tarifa dos EAU, independentemente de onde a empresa remetente está registada. Os EAU têm uma linha própria na tabela de tarifas da Meta, em vez de partilharem a tarifa do Resto do Médio Oriente.

Os valores abaixo provêm das tabelas da Meta em USD e AED em vigor desde 1 de outubro de 2026. As respostas em texto livre dentro de uma janela de apoio ao cliente de 24 horas aberta são gratuitas, um template de utilidade enviado dentro dessa janela é gratuito, e as mensagens enviadas a partir da app WhatsApp Business num número com Coexistence continuam gratuitas. Os templates de marketing são cobrados sempre que são entregues.

### O que mudou recentemente nos preços e na faturação dos EAU?

Duas alterações do registo de alterações de preços da Meta aplicam-se diretamente. A 1 de outubro de 2025, a Meta aumentou a tarifa das mensagens de marketing para os Emirados Árabes Unidos. A 1 de abril de 2026, acrescentou oito moedas de faturação, entre as quais o AED, pelo que uma empresa nos Emirados pode agora ser faturada em dirhams e consultar os custos numa tabela de tarifas em AED.

Os EAU constam também da lista de mercados da Meta com tarifa de autenticação internacional. Uma empresa sediada fora dos Emirados que envie códigos de utilização única para números +971 pode passar a pagar US$ 0,051 por template de autenticação, quando a Meta definir uma data de início, que anuncia com 30 dias de antecedência.

### Como se liga um número dos EAU à API mantendo a app?

Através do Embedded Signup da Meta, com a opção da app WhatsApp Business existente, executado por um Tech Provider. A empresa inicia sessão com o Facebook, escolhe o seu Portefólio empresarial, introduz o número +971 e confirma com um QR code apresentado na app. Os conteúdos multimédia do histórico de conversas sincronizado só ficam disponíveis para as últimas duas semanas.

Depois disso, a app WhatsApp Business continua a funcionar no telemóvel e o mesmo número recebe e envia através da Cloud API a um ritmo fixo de 20 mensagens por segundo. A página sobre como ligar um número enumera todos os passos e o que cada um exige.

- Presumir que os EAU têm o preço do Resto do Médio Oriente. Têm uma linha própria, mais elevada, na tabela de tarifas da Meta.
- Converter à mão as tarifas em USD para dirhams. Desde 1 de abril de 2026, a Meta publica uma tabela em AED com valores próprios.
- Enviar códigos para números +971 a partir do estrangeiro ao preço nacional. A tarifa de autenticação internacional é mais de três vezes superior.

**A Meta pode faturar uma empresa dos EAU em dirhams?** Sim. O AED passou a ser uma moeda de faturação da WhatsApp Business Platform a 1 de abril de 2026, com tabela de tarifas própria.

**Os EAU e a Arábia Saudita têm o mesmo preço?** Em marketing, sim: ambos custam US$ 0,0576 na tabela de 1 de outubro de 2026. Utilidade e autenticação diferem, com US$ 0,0157 para os EAU e US$ 0,0107 para a Arábia Saudita.

**A resposta a um cliente que escreveu primeiro é cobrada?** Não, se for uma resposta em texto livre dentro da janela de apoio ao cliente de 24 horas. Os templates enviados fora da janela são cobrados.

**A app no telemóvel deixa de funcionar?** Não. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número, e as mensagens enviadas a partir dela continuam gratuitas.

---

## WhatsApp Coexistence na Arábia Saudita: disponibilidade, tarifas da Meta e faturação em SAR

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-saudi-arabia

Os números sauditas podem usar a Coexistence: a documentação de integração da Meta para utilizadores da app Business não impõe restrições por país. A partir de 1 de outubro de 2026, a Meta cobra US$ 0,0576 (SAR 0,2159) por template de marketing entregue a um número +966 e US$ 0,0107 (SAR 0,0401) por template utilitário ou de autenticação. As respostas em texto livre dentro da janela de atendimento ao cliente não têm custo.

### O WhatsApp Coexistence está disponível na Arábia Saudita?

Sim. A documentação da Meta para levar utilizadores da app WhatsApp Business para a Cloud API impõe condições quanto à versão da app (2.24.17 ou posterior) e ao parceiro que executa o Embedded Signup, e não indica nenhum país, região ou indicativo excluído. Um número +966 registado e ativo na app WhatsApp Business é elegível.

Quando um número saudita é recusado, a causa é uma das gerais: o número está na app WhatsApp de consumidor, a app é anterior à versão 2.24.17, ou o número continua associado a outro fornecedor. A página de elegibilidade explica cada caso e a respetiva correção.

### Quanto cobra a Meta por mensagem na Arábia Saudita?

A Meta fixa o preço de cada template entregue pelo indicativo do país do destinatário. Os templates entregues a números +966 são cobrados à tarifa da Arábia Saudita, independentemente do local onde o remetente está sediado, e a Arábia Saudita tem uma linha própria na tabela de tarifas.

Os valores abaixo provêm das tabelas em USD e SAR da Meta em vigor desde 1 de outubro de 2026. As respostas em texto livre dentro de uma janela de atendimento ao cliente de 24 horas aberta são gratuitas, os templates utilitários enviados nessa janela são gratuitos, e as mensagens enviadas a partir da app WhatsApp Business num número Coexistence não custam nada. Os templates de marketing são cobrados em cada entrega, e os escalões de volume mensal podem reduzir as tarifas de utilitário e de autenticação para os grandes remetentes.

### O que mudou para as empresas sauditas em 2026?

O dia 1 de abril de 2026 trouxe duas alterações no registo de alterações de preços da Meta. A tarifa de mensagens de marketing da Arábia Saudita subiu e o SAR passou a ser uma de oito novas moedas de faturação, pelo que uma empresa saudita pode ser faturada em riais e consultar os custos numa tabela de tarifas em SAR, em vez de converter a partir de dólares.

A Arábia Saudita é também um dos mercados com tarifa de autenticação internacional. Uma empresa sediada no estrangeiro que envie códigos de utilização única para números +966 pode passar a pagar US$ 0,0598 por template de autenticação, mais de cinco vezes a tarifa nacional. A Meta atribui essa data de início a cada empresa e dá 30 dias de aviso antes de a aplicar.

### Como se liga um número saudita e se continua a usar a app?

Com o Embedded Signup da Meta, escolhendo a opção para um número que já está na app WhatsApp Business. Um Tech Provider aloja o fluxo; a empresa inicia sessão com o Facebook, seleciona o seu Portefólio empresarial, introduz o número +966 e lê o código QR que a app apresenta. O parceiro tem depois 24 horas para iniciar a sincronização, caso contrário o fluxo tem de ser repetido.

A partir daí, o telemóvel continua a funcionar como antes, e o mesmo número envia e recebe através da Cloud API a uma taxa fixa de 20 mensagens por segundo. Cada passo está descrito na página sobre como ligar um número.

- Orçamentar os envios de marketing sauditas com tarifas anteriores a 1 de abril de 2026. A Meta aumentou a tarifa de marketing nesse dia.
- Calcular o custo em SAR a partir de uma tabela em USD com um conversor de moeda. A Meta publica os seus próprios valores em SAR.
- Enviar códigos para números +966 a partir de uma empresa no estrangeiro à tarifa nacional. A tarifa de autenticação internacional é de US$ 0,0598.

**Uma empresa saudita pode ser faturada em riais?** Sim. A Meta acrescentou o SAR como moeda de faturação em 1 de abril de 2026 e publica uma tabela de tarifas em SAR.

**A Arábia Saudita tem o preço do Resto do Médio Oriente?** Não. Tem uma linha própria na tabela de tarifas da Meta, com US$ 0,0576 para marketing e US$ 0,0107 para utilitário e autenticação.

**As mensagens que escrevo na app são cobradas?** Não. A Meta indica que as mensagens enviadas a partir da app WhatsApp Business continuam gratuitas depois da integração da Coexistence.

**Que versão da app é necessária?** A app WhatsApp Business 2.24.17 ou posterior, no telemóvel que tem o número +966.

---

## WhatsApp Coexistence na Turquia: disponibilidade, tarifas da Meta e configuração

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-turkey

Os números turcos podem usar a Coexistence, uma vez que a documentação de integração da Meta para utilizadores da app Business não indica nenhuma restrição por país. A partir de 1 de outubro de 2026, a Meta cobra US$ 0,0109 por cada template de marketing entregue a um número +90 e US$ 0,0009 por cada template utilitário ou de autenticação. A Meta reduziu as tarifas utilitárias e de autenticação da Turquia a 1 de abril de 2026 e não publica tabela de tarifas em liras.

### A WhatsApp Coexistence está disponível na Turquia?

Sim. A página que a Meta mantém sobre a integração de utilizadores da app WhatsApp Business na Cloud API estabelece requisitos quanto à versão da app (2.24.17 ou posterior) e quanto ao parceiro (um Tech Provider ou Solution Partner que use o Embedded Signup com registo de sessão), e não contém qualquer exclusão por país ou indicativo telefónico. Um número +90 ativo na app WhatsApp Business é elegível.

Um número turco só é recusado pelos motivos que se aplicam a qualquer número: está na app WhatsApp de consumidor, a app precisa de ser atualizada, ou outro fornecedor ainda detém o número. Cada um destes casos resolve-se no telemóvel ou junto do fornecedor anterior, e a página de elegibilidade explica como.

### Quanto cobra a Meta por mensagem na Turquia?

A Meta cobra por template entregue, com a tarifa do indicativo do país do destinatário, pelo que todos os templates que chegam a um número +90 são cobrados à tarifa da Turquia, esteja o remetente onde estiver. A Turquia tem uma linha própria na tabela de tarifas.

Na tabela em USD da Meta em vigor a partir de 1 de outubro de 2026, os valores estão entre os mais baixos da tabela: US$ 0,0109 para marketing e US$ 0,0009 para utilitário e autenticação. A tabela em EUR indica 0,009 € e 0,0007 €. A Meta não indica nenhuma tarifa de autenticação internacional para a Turquia. As respostas de texto livre dentro de uma janela de apoio ao cliente de 24 horas aberta são gratuitas, tal como um template utilitário enviado dentro dela, e as mensagens enviadas a partir da app WhatsApp Business num número com Coexistence continuam gratuitas.

### Em que moeda fatura a Meta às empresas turcas?

A Meta publica as tabelas de tarifas da WhatsApp Business Platform em dezasseis moedas: USD, AED, ARS, AUD, BRL, CLP, COP, EUR, GBP, IDR, INR, MXN, MYR, PEN, SAR e SGD. A lira turca não é uma delas, pelo que uma empresa turca é faturada numa dessas moedas, como USD ou EUR, e os seus custos devem ser lidos nessa tabela, sem conversão.

A alteração de tarifas mais importante é recente. A 1 de abril de 2026, a Meta reduziu as tarifas utilitárias e de autenticação da Turquia, o que faz com que as atualizações de encomendas e os códigos de utilização única enviados para números +90 custem uma fração de cêntimo cada. Os orçamentos anteriores a essa data sobrestimam estes custos.

### Como se liga um número turco mantendo a app?

Através do Embedded Signup da Meta, com a opção para um número que já está na app WhatsApp Business. Um Tech Provider disponibiliza-o. A empresa inicia sessão com o Facebook, seleciona o seu Portefólio empresarial, introduz o número +90 e confirma lendo um código QR na app. A sincronização tem de começar nas 24 horas seguintes, caso contrário o processo deve ser repetido.

Depois de ligado, o telemóvel continua a funcionar e o mesmo número ganha acesso à Cloud API a um ritmo fixo de 20 mensagens por segundo. A página sobre como ligar um número explica o processo ecrã a ecrã.

- Procurar uma tabela de tarifas em liras turcas. A Meta não publica nenhuma; consulte a tabela em USD ou EUR em que a sua conta é faturada.
- Usar um orçamento elaborado antes de 1 de abril de 2026. A Meta reduziu nesse dia as tarifas utilitárias e de autenticação da Turquia.
- Classificar promoções como utilitárias para poupar. A Meta revê as categorias dos templates, e um template de marketing é cobrado à tarifa de marketing.

**Existe uma tarifa de autenticação internacional para a Turquia?** Não. A tabela de tarifas da Meta em vigor a partir de 1 de outubro de 2026 indica-a como não aplicável à Turquia.

**A Meta pode faturar-me em liras turcas?** Não. A lira não consta das dezasseis moedas de faturação em que a Meta publica tabelas de tarifas.

**As respostas a clientes na Turquia são gratuitas?** As respostas de texto livre dentro da janela de apoio ao cliente de 24 horas são gratuitas. Os templates fora da janela são cobrados por entrega.

**Ligar a API impede o funcionamento da app?** Não. Com a Coexistence, a app WhatsApp Business continua a funcionar no mesmo número, e as suas mensagens continuam gratuitas.

---

## WhatsApp Coexistence na Alemanha: disponibilidade, tarifas da Meta e configuração

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-germany

Os números alemães podem usar a Coexistence: a documentação de integração da Meta para utilizadores da app WhatsApp Business não indica nenhuma restrição de país nem da UE. A partir de 1 de outubro de 2026, a Meta cobra US$ 0,1365 (0,1131 €) por cada template de marketing entregue a um número +49 e US$ 0,055 (0,0456 €) por cada template de utilidade ou de autenticação. As respostas de texto livre dentro da janela de atendimento ao cliente são gratuitas.

### A WhatsApp Coexistence está disponível na Alemanha?

Sim. A documentação da Meta para integrar utilizadores da app WhatsApp Business na Cloud API define requisitos quanto à versão da app (2.24.17 ou posterior) e ao parceiro que executa o Embedded Signup, e não indica nenhuma restrição de país, região ou indicativo telefónico. Também não acrescenta nenhuma condição específica da União Europeia. Um número +49 registado e ativo na app WhatsApp Business é elegível.

Se o Embedded Signup recusar um número alemão, o motivo é um dos gerais: o número ainda está na app WhatsApp de consumidor, a app é anterior à versão 2.24.17 ou outro fornecedor ainda o detém. A página de elegibilidade trata cada um dos casos.

### Quanto cobra a Meta por mensagem na Alemanha?

A Meta cobra por cada template entregue, com preço definido pelo indicativo do país do destinatário. Um template entregue a um número +49 custa a tarifa da Alemanha, quer a empresa que o envia esteja em Berlim, em Viena ou noutro local.

A Alemanha tem a sua própria linha na tabela de tarifas da Meta, bastante acima da linha do Resto da Europa Ocidental: US$ 0,1365 para marketing contra US$ 0,0592, e US$ 0,055 para utilidade contra US$ 0,0171. A Meta não lista nenhuma tarifa de autenticação internacional para a Alemanha. As respostas de texto livre dentro de uma janela de atendimento ao cliente de 24 horas aberta são gratuitas, um template de utilidade enviado dentro dela é gratuito, e as mensagens escritas na app WhatsApp Business num número em Coexistence continuam gratuitas.

### O que significa a tarifa alemã para a forma como uma empresa usa a API?

Como um template de marketing para um número +49 custa mais de treze cêntimos de dólar e um template de utilidade cinco cêntimos e meio, as mensagens mais baratas na Alemanha são as que a Meta não cobra de todo.

Isso faz da janela de atendimento ao cliente a principal alavanca de custo. Um fluxo que responde a quem escreveu, dentro de 24 horas, não paga nada por mensagem. Um template de utilidade enviado enquanto essa janela está aberta também é gratuito. A fatura vem das campanhas que abrem uma conversa com um template. Num número em Coexistence, tudo o que a equipa escreve no telemóvel, na app WhatsApp Business, também é gratuito, pelo que a API pode ficar reservada para os envios automáticos.

### Como se liga um número alemão e se mantém a app?

Com o Embedded Signup da Meta, na opção para um número que já está na app WhatsApp Business. Um Tech Provider aloja o fluxo; a empresa inicia sessão com o Facebook, seleciona o seu Portefólio empresarial, introduz o número +49 e confirma com o código QR apresentado na app. A sincronização tem de começar nas 24 horas seguintes à conclusão, caso contrário o fluxo tem de ser repetido.

O telemóvel continua a funcionar depois disso, e o mesmo número envia e recebe através da Cloud API a um ritmo fixo de 20 mensagens por segundo. Cada ecrã está descrito na página sobre como ligar um número.

- Orçamentar os destinatários alemães à tarifa do Resto da Europa Ocidental. A Alemanha tem a sua própria linha, com mais do dobro para marketing.
- Abrir conversas com templates quando bastava uma resposta dentro da janela de 24 horas. Na Alemanha, a diferença entre gratuito e pago é grande.
- Classificar promoções como utilidade para pagar menos. A Meta revê as categorias dos templates e cobra o marketing à tarifa de marketing.

**A Meta pode faturar uma empresa alemã em euros?** Sim. O EUR é uma das moedas de faturação em que a Meta publica tabelas de tarifas, com a Alemanha a 0,1131 € para marketing na tabela de 1 de outubro de 2026.

**A Coexistence tem condições adicionais na UE?** A documentação de integração atual da Meta para utilizadores da app Business não indica nenhuma. Os requisitos são os mesmos em todo o lado: app 2.24.17 ou posterior e um parceiro do Embedded Signup.

**Uma resposta a um cliente alemão é cobrada?** Não, se for uma resposta de texto livre dentro da janela de atendimento ao cliente de 24 horas. Os templates fora da janela são cobrados por entrega.

**As mensagens enviadas a partir do telemóvel continuam gratuitas?** Sim. A Meta indica que as mensagens enviadas a partir da app WhatsApp Business continuam gratuitas após a integração. Só os envios pela Cloud API seguem os preços da Cloud API.

---

## WhatsApp Coexistence em Itália: disponibilidade, tarifas da Meta e configuração

https://easycoexistence.com/pt-pt/docs/whatsapp-coexistence-italy

Os números italianos podem usar a Coexistence, uma vez que a documentação de integração da Meta para utilizadores da app WhatsApp Business não menciona nenhum país nem restrição da UE. A partir de 1 de outubro de 2026, a Meta cobra US$ 0.0795 (€0.0658) por cada template de marketing entregue a um número +39 e US$ 0.03 (€0.0248) por cada template de utilidade ou autenticação. A Meta aumentou a tarifa de marketing de Itália a 1 de julho de 2026.

### A WhatsApp Coexistence está disponível em Itália?

Sim. A documentação da Meta para integrar utilizadores da app WhatsApp Business na Cloud API indica o que é necessário, sobretudo a versão 2.24.17 da app ou mais recente e um Tech Provider ou Solution Partner que use o Embedded Signup, e não contém qualquer exclusão de país, região ou indicativo telefónico. Nada nela acrescenta uma condição para números da União Europeia. Um número +39 em utilização ativa na app WhatsApp Business é elegível.

Um número italiano só é recusado pelos motivos gerais: está na app WhatsApp de consumidor, a app precisa de atualização ou outro fornecedor ainda o detém. A página de elegibilidade explica cada caso e como o resolver.

### Quanto cobra a Meta por mensagem em Itália?

A Meta cobra por template entregue, à tarifa do indicativo do país do destinatário, pelo que qualquer template que chegue a um número +39 é cobrado à tarifa de Itália, onde quer que a empresa esteja registada. Itália tem linha própria na tabela de tarifas, em vez da tarifa do Resto da Europa Ocidental.

Os valores abaixo provêm das tabelas da Meta em USD e EUR em vigor desde 1 de outubro de 2026. A Meta não indica tarifa de autenticação internacional para Itália. As respostas de texto livre numa janela de atendimento ao cliente de 24 horas aberta são gratuitas, um template de utilidade enviado dentro dessa janela é gratuito, e as mensagens enviadas a partir da app WhatsApp Business num número com Coexistence não são cobradas.

### O que mudou nos preços de Itália em 2026?

O registo de alterações de preços da Meta regista uma alteração para Itália este ano: uma tarifa mais alta para mensagens de marketing a partir de 1 de julho de 2026, na mesma atualização que alterou tarifas de Espanha, Polónia, Hungria, Roménia, Reino Unido e outros países. A utilidade e a autenticação não fizeram parte dessa alteração.

O efeito prático recai sobre as campanhas. Um orçamento para templates promocionais a números +39 elaborado antes de julho de 2026 subestima o custo, ao passo que as confirmações de encomenda, as atualizações de entrega e os códigos de utilização única têm o preço de antes. A faturação em euros não exige conversão, porque o EUR é uma das moedas em que a Meta publica tabelas de tarifas, e o valor de marketing de €0.0658 é da própria Meta.

### Como se liga um número italiano e se mantém a app?

Através do Embedded Signup da Meta, escolhendo a opção para um número já registado na app WhatsApp Business. Um Tech Provider aloja o fluxo. A empresa inicia sessão com o Facebook, seleciona o seu Portefólio empresarial, introduz o número +39 e lê o código QR apresentado na app. Os ficheiros multimédia do histórico de conversas sincronizado abrangem apenas as últimas duas semanas.

Depois da integração, o telemóvel continua a funcionar, e o mesmo número também envia e recebe pela Cloud API a um ritmo fixo de 20 mensagens por segundo. A página sobre ligar um número descreve cada passo.

- Usar um orçamento de marketing para destinatários +39 elaborado antes de 1 de julho de 2026. A Meta aumentou nesse dia a tarifa de marketing de Itália.
- Aplicar a tarifa do Resto da Europa Ocidental a números italianos. Itália tem linha própria na tabela da Meta.
- Iniciar a integração num número que ainda está na app WhatsApp de consumidor. Tem primeiro de passar para a app Business.

**A Meta pode faturar uma empresa italiana em euros?** Sim. O EUR é uma das moedas de faturação da Meta, e a sua tabela em EUR indica Itália a €0.0658 para marketing e €0.0248 para utilidade e autenticação.

**As tarifas de utilidade de Itália mudaram em 2026?** Não. A atualização de 1 de julho de 2026 aumentou apenas a tarifa de marketing de Itália.

**As respostas a clientes italianos são cobradas?** As respostas de texto livre dentro da janela de atendimento ao cliente de 24 horas são gratuitas. Os templates enviados fora dela são cobrados na entrega.

**A minha equipa continuará a usar a app?** Sim. A Coexistence mantém a app WhatsApp Business a funcionar no mesmo número, e as mensagens enviadas a partir dela continuam gratuitas.

---

## Como desligar a Coexistence e voltar a usar só a app

https://easycoexistence.com/pt-pt/docs/disconnecting-coexistence

A Coexistence desliga-se na própria app WhatsApp Business: Definições, Conta, Business Platform e depois Disconnect Account. A app continua a funcionar no número, o acesso do fornecedor termina e é enviado um webhook account_update com PARTNER_REMOVED. O endpoint Deregister da Cloud API não pode ser usado num número que funciona nos dois sítios.

### Como se desliga a Coexistence?

A partir do telemóvel que tem o número. A Meta documenta um único caminho para uma empresa sair da Cloud API quando o número é partilhado com a app WhatsApp Business, e passa pela app, não por um painel ou por um endpoint. Quem tem o telemóvel principal toma a decisão, pelo que uma agência ou um programador pede à empresa que o faça.

- Abra a app WhatsApp Business no dispositivo principal.
- Aceda a Definições, depois a Conta e a Business Platform.
- Toque em Disconnect Account e confirme.
- Conte com um webhook account_update com o evento PARTNER_REMOVED do lado da API.

### Porque é que a API Deregister recusa o número?

Porque a Meta exclui de propósito os números em Coexistence. A documentação de registo indica que o endpoint Deregister não pode anular o registo de um número de telefone empresarial que esteja em uso na Cloud API e na app WhatsApp Business ao mesmo tempo.

Anular o registo é a operação que torna um número inutilizável na Cloud API e, num número só de API, é a forma de retirar uma linha da plataforma. Num número partilhado, a app é a principal titular da linha, por isso a Meta devolve a decisão a quem a tem. O software que tenta primeiro o endpoint recebe um erro, não uma desligação, e o número continua ligado até alguém tocar no botão da app.

### O que acontece à app, ao histórico e ao número?

Desligar não é o mesmo que eliminar a conta, e essa diferença é a resposta toda.

O aviso da Meta sobre a perda do histórico de mensagens aplica-se a eliminar a conta da app WhatsApp Business e a registar o número na Cloud API. Desligar não faz nenhuma das duas coisas. A app continua instalada e registada, o número continua nela e a equipa continua a responder aos clientes a partir do mesmo telemóvel.

O que termina é o lado da API. A aplicação do fornecedor é retirada do número, pelo que o envio pela Cloud API e a entrega de webhooks deixam de funcionar. As funcionalidades que a Coexistence desativou, como as listas de difusão, estão descritas na página sobre as funcionalidades desativadas.

### É possível voltar a ligar o número mais tarde?

Sim, executando de novo o fluxo de onboarding desde o início. A própria documentação da Meta trata o offboarding e a repetição do fluxo como a forma normal de repor uma ligação, por exemplo quando a janela de 24 horas para sincronizar contactos e histórico foi perdida.

Uma nova ligação é um novo onboarding, por isso as perguntas feitas da primeira vez voltam a ser feitas, incluindo a de partilhar ou não o histórico de conversas. Tudo o que estava configurado na ligação antiga, como um override de webhook, tem de ser aplicado de novo. Um número que deva passar para outro fornecedor segue o mesmo caminho: desliga-se aqui e faz-se o onboarding com o novo.

- Chamar o endpoint Deregister num número em Coexistence. A Meta recusa-o; a desligação faz-se na app.
- Eliminar a conta da app WhatsApp Business para sair. É esse o caminho que faz perder o histórico de conversas.
- Tratar o PARTNER_REMOVED como uma falha a repetir. É uma desligação deliberada por parte da empresa.

**Perco as minhas conversas se me desligar?** Não. Desligar retira a API do número; não elimina a conta da app WhatsApp Business, que é o que a Meta avisa que faz perder o histórico.

**Posso desligar através da API?** Não. A Meta não permite o endpoint Deregister num número em uso na Cloud API e na app ao mesmo tempo.

**Como sabe o meu sistema que isso aconteceu?** A Meta envia um webhook account_update com o evento PARTNER_REMOVED quando a empresa se desliga.

**Posso voltar a ligar o mesmo número?** Sim. Execute de novo o fluxo de onboarding desde o início, como numa primeira ligação.

---

## Passar um número de Coexistence para apenas Cloud API

https://easycoexistence.com/pt-pt/docs/moving-from-coexistence-to-cloud-api

Um número em Coexistence passa a funcionar só com a API ao desligá-lo na app WhatsApp Business, eliminar a conta da app e registá-lo na Cloud API com um PIN de verificação em dois passos. A Meta avisa que o histórico de mensagens existente se perde, e o número só pode voltar à app se for removido do registo na Cloud API.

### Porque é que uma empresa deixaria a app?

Normalmente porque já ninguém responde a partir do telemóvel. Quando todas as conversas são tratadas por software ou por uma caixa de entrada construída sobre a API, a app só acrescenta obrigações: o dispositivo principal continua a ter de ser aberto com regularidade e o número mantém o throughput fixo da Coexistence.

A Meta documenta que os números usados em simultâneo com a app e a Cloud API têm um throughput fixo de 20 mensagens por segundo. Um número só com API começa por defeito com até 80 mensagens por segundo e pode ser atualizado automaticamente para 1 000 quando cumpre as condições da Meta. Para um número que envia em grande volume, esta diferença é o motivo para mudar.

### Qual é a ordem dos passos?

São quatro passos, e a ordem importa porque o endpoint Deregister recusa um número que ainda esteja partilhado com a app. A empresa executa cada passo no telemóvel, exceto o último, que é uma chamada à API feita por quem vai gerir o número daqui em diante.

- Fazer uma cópia de segurança do histórico de conversas na app WhatsApp Business, como a Meta recomenda.
- Desligar na app: Definições, Conta, Plataforma empresarial, Desligar conta.
- Eliminar a conta da app: Definições, Conta, Eliminar a minha conta, e esperar até 3 minutos.
- Registar o número na Cloud API com um PIN de verificação em dois passos de 6 dígitos.

### A que é que a empresa renuncia?

Às conversas no telemóvel e ao telemóvel como forma de responder.

A Meta afirma que eliminar a conta da app WhatsApp Business e registar o número na Cloud API faz perder o histórico de mensagens existente. É o oposto do processo de adesão à Coexistence, em que a Meta indica que o histórico é preservado e as duas aplicações funcionam ao mesmo tempo.

O número também não pode voltar a ser usado com a app WhatsApp Business sem ser primeiro removido do registo na Cloud API. Trata-se, por isso, de uma mudança deliberada e sem retorno na forma de trabalhar da empresa, e convém confirmar que ninguém na equipa ainda depende da app antes de começar.

### O que se mantém igual do lado da API?

A forma como o software comunica com o número. Continua a ser a Cloud API: aplicam-se os mesmos tipos de mensagem, templates, webhooks e preços, porque a Coexistence foi sempre apenas outra forma de adesão à mesma plataforma.

O que muda é o registo. Um número em Coexistence é registado pelo fluxo de adesão; um número só com API é registado por uma chamada de registo com o PIN de verificação em dois passos, e a Meta limita essas chamadas a 10 por número numa janela deslizante de 72 horas. Uma tentativa falhada tem, portanto, um custo, pelo que se deve confirmar o PIN antes de voltar a tentar.

- Eliminar a conta da app antes de guardar as conversas. A Meta afirma que, neste caminho, o histórico se perde.
- Chamar o Deregister enquanto o número ainda está partilhado com a app. A Meta recusa o pedido.
- Repetir o registo em ciclo. A Meta permite 10 pedidos de registo por número em 72 horas.

**Posso manter o histórico de conversas ao passar para só API?** Não na API. A Meta avisa que o histórico se perde e recomenda que se faça primeiro uma cópia de segurança a partir da app.

**O número pode voltar à app mais tarde?** Só depois de ser removido do registo na Cloud API, segundo o guia de migração da Meta.

**O throughput melhora?** Sim. Os números em Coexistence estão fixos em 20 mps; os números só com API começam com até 80 mps.

**Posso usar a API Deregister para começar?** Não enquanto o número estiver partilhado com a app. Desligue-o primeiro na app WhatsApp Business.

---

## Migrar um número de outro fornecedor de WhatsApp

https://easycoexistence.com/pt-pt/docs/migrating-a-number-from-another-provider

Depende de como o número está ligado atualmente. Um número partilhado com a app WhatsApp Business através de outro fornecedor é desligado a partir da app e depois integrado de novo com o novo fornecedor. Um número só API muda através da migração de números de telefone da Meta, que mantém o nome de exibição, a classificação de qualidade, o limite de mensagens e o estado de Official Business Account.

### Em que caso estou?

Faça uma só pergunta: alguém ainda responde a este número a partir da app WhatsApp Business num telemóvel?

Se sim, o número está em Coexistence com o fornecedor atual, e é a app que o mantém. A saída desse fornecedor faz-se na app, e a entrada num novo fornecedor é uma nova integração Coexistence.

Se não, o número está registado apenas na Cloud API, sem nenhuma app por trás. A Meta tem uma migração própria para esse caso, que passa o número da conta WhatsApp Business de um parceiro para a de outro, sem o registar de raiz. Confundir os dois casos é o motivo habitual de uma mudança ficar a meio.

### Como muda de fornecedor um número em Coexistence?

Desliga-se e volta-se a integrar. A Meta documenta que a empresa se desliga da Cloud API na app, em Definições, Conta, Plataforma empresarial, através do botão Desligar conta, e que o fornecedor recebe um webhook account_update com PARTNER_REMOVED.

Depois de desligado, o número volta a ser apenas um número da app WhatsApp Business e pode ser integrado pelo novo fornecedor através do Embedded Signup. As condições são as habituais da Coexistence: uma versão recente da app, um portefólio empresarial que o utilizador administre e nenhum outro fornecedor ainda associado. A pergunta sobre a partilha do histórico é feita de novo, e a janela de sincronização de 24 horas recomeça a contar a partir da nova integração.

### O que se mantém numa migração só API?

Mais do que a maioria espera, e é por isso que esta migração existe em vez de eliminar e registar de novo. O número conserva a reputação que construiu junto dos clientes, e só o histórico de qualidade dos templates recomeça.

- O nome de exibição, a classificação de qualidade, o limite de mensagens e o estado de Official Business Account são preservados.
- Os templates elegíveis são duplicados para a conta de destino com os mesmos estados.
- Os ficheiros multimédia já carregados no número continuam a poder ser utilizados.
- As classificações de qualidade dos templates não são transferidas: todos os templates migrados começam como UNKNOWN.

### O que tem de estar pronto antes de uma migração só API?

A Meta indica condições para os dois lados, e são as do lado do cliente que bloqueiam as mudanças.

O portefólio empresarial da Meta tem de estar verificado e a conta WhatsApp Business existente aprovada, com um método de pagamento válido associado. O número tem de ter a verificação em dois passos desativada, e a Meta não disponibiliza nenhum endpoint da API para a desativar, pelo que o fornecedor não pode fazer este passo através da API. Do lado de destino, pelo menos uma app tem de estar subscrita aos webhooks na conta de destino.

O registo na nova conta é instantâneo e sem interrupção do envio de mensagens, mas a duplicação dos templates demora algum tempo, pelo que os templates afetados não podem ser utilizados até as respetivas cópias existirem.

- Integrar com um novo fornecedor enquanto o antigo ainda está associado. O número tem de ser desligado primeiro na app.
- Iniciar uma migração só API com a verificação em dois passos ativa. A Meta exige que esteja desativada, e nenhum endpoint o faz.
- Esperar que a qualidade dos templates se mantenha. Os templates migrados recomeçam em UNKNOWN.

**Perco as minhas conversas ao mudar de fornecedor Coexistence?** A app mantém-nas durante todo o processo. A partilha do histórico com a nova ligação é oferecida de novo na integração.

**Uma migração só API altera o meu nome de exibição?** Não. A Meta preserva o nome de exibição, a classificação de qualidade, o limite de mensagens e o estado de Official Business Account.

**Porque é que os meus templates perderam a classificação de qualidade?** A Meta duplica os templates para a conta de destino, e cada cópia começa com a classificação UNKNOWN.

**Há indisponibilidade?** A Meta indica que o registo numa migração só API é instantâneo, sem interrupção do envio de mensagens. Os templates ficam utilizáveis depois de duplicados.

---

## Grupos do WhatsApp e a API num número com Coexistence

https://easycoexistence.com/pt-pt/docs/whatsapp-groups-and-the-api

A Groups API da Meta permite a um número da Cloud API criar pequenos grupos apenas por convite e enviar-lhes mensagens, mas a Meta indica que não está disponível para números de telefone da app WhatsApp Business, que é o caso de um número com Coexistence. Os grupos já existentes na app também não são sincronizados. Num número partilhado, os grupos continuam a ser uma funcionalidade exclusiva da app.

### O WhatsApp tem uma Groups API?

Sim. A Groups API da Meta permite a uma empresa criar, listar e atualizar grupos num número da Cloud API, enviar-lhes mensagens de texto, multimédia e templates, gerir a ligação de convite, aprovar ou rejeitar pedidos de adesão e remover participantes.

É deliberadamente pequena. Os grupos são apenas por convite, com adesão através de uma ligação enviada pela empresa, e os limites da Meta descrevem algo mais próximo de uma sala de projeto do que de uma comunidade.

- Até 8 participantes por grupo.
- Até 10 000 grupos por número de empresa.
- Uma empresa da Cloud API por grupo.
- Texto, multimédia, templates baseados em texto e templates baseados em multimédia.

### Um número com Coexistence pode usá-la?

Não. A página da Groups API indica que não está disponível para números de telefone da app WhatsApp Business, e essa expressão remete para o guia da própria Meta sobre o onboarding de utilizadores da app WhatsApp Business, ou seja, a Coexistence. A condição de elegibilidade é também uma Official Business Account, um estatuto que, segundo a página da Meta sobre a OBA, não é atribuído a números de telefone da app WhatsApp Business.

Portanto, a exclusão é definida pela Meta para todos os fornecedores. Um número partilhado entre a app e a API não pode criar grupos através da API, não pode enviar mensagens para eles e não recebe eventos de grupo.

### O que acontece aos grupos que já estão na app?

Ficam na app e continuam a funcionar aí. A documentação da Meta sobre a Coexistence inclui as conversas de grupo entre o que não é sincronizado quando um número é registado, pelo que nem o histórico nem as novas mensagens de grupo chegam à API.

A equipa que está ao telemóvel pode continuar a criar grupos, a publicar neles e a lê-los exatamente como antes. O software simplesmente não tem visibilidade desse tráfego. Se um fluxo de trabalho depender de um grupo, como a coordenação de entregas pelos colaboradores, continua na app, e qualquer automatização em torno dele tem de ser construída a partir de conversas individuais.

### O que devo usar em vez de grupos através da API?

Conversas individuais, que é aquilo em torno do qual a plataforma foi construída. Uma mensagem que iria para um grupo de clientes é enviada a cada um deles individualmente, dentro da janela de atendimento ao cliente de 24 horas como texto livre, ou fora dela como template aprovado.

Se uma empresa precisar mesmo de grupos geridos pela API, a Groups API exige um número registado apenas na Cloud API e com uma Official Business Account, o que significa abandonar a Coexistence nesse número. É uma decisão estrutural sobre a linha, não uma definição, e retira-lhe a app.

- Ler que existe uma Groups API e presumir que abrange um número com Coexistence. A Meta exclui os números da app Business.
- Esperar que o histórico de grupos apareça na API após o onboarding. As conversas de grupo não são sincronizadas.
- Planear um fluxo de trabalho baseado em grupos em torno de um limite de 8 participantes sem verificar se é suficiente.

**Posso enviar uma mensagem para um grupo do WhatsApp através da API?** Só a partir de um número exclusivo da API, com uma Official Business Account, através da Groups API. Não a partir de um número com Coexistence.

**Os meus grupos existentes continuam a funcionar?** Sim, na app WhatsApp Business. Não são sincronizados com a API.

**Quantas pessoas podem entrar num grupo da API?** A Meta limita os grupos criados através da Groups API a 8 participantes.

**Este limite é do meu fornecedor?** Não. A Meta define a exclusão dos números da app WhatsApp Business em todos os fornecedores.

---

## Meta Verified e o selo de conta oficial num número Coexistence

https://easycoexistence.com/pt-pt/docs/meta-verified-and-coexistence

Duas coisas diferentes são chamadas de selo azul. Uma Official Business Account é um estatuto pedido para um número da Cloud API, e a documentação da Meta indica que não é atribuído a números da app WhatsApp Business. O Meta Verified para WhatsApp Business é uma subscrição feita na app, com selo de verificação, acesso multiagente e apoio reforçado.

### O que é uma Official Business Account?

Um estatuto atribuído a um número de telefone empresarial registado na WhatsApp Business Platform. A Meta descreve-o como um número pertencente a uma empresa verificada como autêntica, apresentado com um visto azul junto ao nome na vista de contactos. É pedido no WhatsApp Manager, no perfil do número, ou através do campo official_business_account da API.

- A empresa cumpre a Política de Mensagens do WhatsApp Business.
- Está registada na plataforma há, pelo menos, 30 dias.
- O seu portefólio empresarial passou a Business Verification.
- O número tem a verificação em dois passos ativada e um nome de apresentação aprovado.

### Um número Coexistence pode obter o estatuto OBA?

A documentação da Meta sobre OBA indica que não atribui o estatuto OBA a funcionários da empresa, contas de teste e números da app WhatsApp Business. A Meta usa o mesmo termo, números da app WhatsApp Business, na página da Groups API e remete para o guia de onboarding de utilizadores da app WhatsApp Business, que é a Coexistence.

A Meta não publica uma regra separada para números partilhados entre a app e a API, pelo que a posição documentada é a acima descrita. Um pedido recusado pode ser submetido novamente após 30 dias, e o perfil da empresa continua editável entretanto.

### O que é o Meta Verified para WhatsApp Business?

Uma subscrição paga feita através da app WhatsApp Business, separada do processo OBA da plataforma. A página de recursos da Meta enumera o que inclui: um selo de verificação, uma página web personalizada, apoio reforçado, uma conta multiagente que liga vários dispositivos e atribui conversas a agentes de vendas, e selos de verificação em até 10 Canais do WhatsApp.

Como se adquire na app, pertence ao lado da app de um número Coexistence. A página da Meta pede à empresa que confirme que as informações da empresa e da conta estão atualizadas antes de subscrever, e não publica aí um preço fixo.

### Um selo mantém-se ao mudar o número?

No caso do OBA, a Meta documenta expressamente uma situação: um número migrado de um Solution Partner para outro através do Embedded Signup mantém o nome de apresentação, a classificação de qualidade, o limite de mensagens e o estatuto Official Business Account.

Não existe declaração equivalente para a mudança do próprio número, e um OBA pertence a um número de telefone empresarial específico, pelo que um número diferente é um pedido diferente. A aprovação do nome de apresentação é uma das condições do OBA, razão pela qual convém planear uma alteração de nome antes do pedido e não depois.

- Tratar o OBA e o Meta Verified como um único selo. Um é um estatuto da plataforma, o outro uma subscrição da app.
- Pedir o OBA antes de completar 30 dias na plataforma. A Meta exige esse mínimo, e uma recusa implica uma espera de 30 dias.
- Pedir o OBA com a verificação em dois passos desativada ou com o nome de apresentação pendente. Ambas são condições indicadas.

**O Meta Verified é o mesmo que uma Official Business Account?** Não. A Meta documenta-os em separado: o OBA é um estatuto pedido para um número da plataforma, o Meta Verified uma subscrição feita na app.

**Posso subscrever o Meta Verified com um número Coexistence?** O Meta Verified subscreve-se através da app WhatsApp Business, que um número Coexistence continua a usar.

**Quanto tempo tem de passar até poder pedir o OBA?** O número tem de estar registado na WhatsApp Business Platform há, pelo menos, 30 dias.

**E se o meu pedido de OBA for recusado?** A Meta pede que aguarde 30 dias antes de voltar a submeter.

---

## Vários agentes e sistemas a responder num único número Coexistence

https://easycoexistence.com/pt-pt/docs/multiple-agents-on-one-number

Um número Coexistence pode ser atendido ao mesmo tempo por pessoas e por software. A equipa usa a app WhatsApp Business e os seus dispositivos associados, até quatro além do telemóvel principal, enquanto os sistemas usam a Cloud API. Cada mensagem que uma pessoa envia da app ou de um dispositivo associado chega ao software como um webhook smb_message_echoes, pelo que ambos os lados partilham a mesma conversa.

### Como respondem várias pessoas no mesmo número?

Através de dispositivos associados. O WhatsApp permite usar uma conta em até quatro dispositivos adicionais, além do telemóvel principal, e o anúncio da funcionalidade referia diretamente o caso de utilização: os colaboradores de uma pequena empresa a responder aos clientes a partir dos seus próprios telemóveis, na mesma conta WhatsApp Business.

Num número Coexistence isto mantém-se. O telemóvel principal continua a ser o titular da conta, e os restantes colaboradores trabalham a partir de telemóveis, tablets, browsers ou aplicações de computador associados. Os clientes suportados, e o que o processo de integração lhes faz, estão explicados na página sobre dispositivos associados.

### Onde entra o software?

Do lado da API do mesmo número. Um CRM, uma ferramenta de automação ou um agente de IA envia através da Cloud API e recebe as mensagens dos clientes por webhooks, enquanto as pessoas continuam a usar a app.

O número é a mesma linha nos dois lados, por isso o cliente vê uma só conversa, independentemente de quem escreveu cada mensagem. As mensagens enviadas pela API aparecem na conversa da app, pelo que a equipa vê o que o sistema já disse. O único limite partilhado é o volume: a Meta fixa em 20 mensagens por segundo um número usado em simultâneo na app e na Cloud API.

### Como sabe o software que uma pessoa já respondeu?

Pelo echo. O webhook smb_message_echoes da Meta é disparado quando uma empresa integrada por um parceiro envia uma mensagem a partir da app WhatsApp Business ou de um dispositivo associado, e também quando uma mensagem é editada ou eliminada na app.

Isto abrange todas as pessoas que atendem o número, quer tenham escrito no telemóvel principal quer num portátil associado. Um sistema que leia os echoes pode marcar a conversa como tratada por uma pessoa e suspender a sua própria resposta, e é essa a diferença entre uma automação que apoia a equipa e uma que fala por cima dela.

- Enviada a partir da app ou de um dispositivo associado: chega um echo.
- Editada na app: chega um echo.
- Eliminada na app: chega um echo.

### O que deve cada lado ter em conta?

A equipa mantém o telemóvel principal em utilização. A Meta desliga um número Coexistence após cerca de 14 dias de inatividade no dispositivo principal, e um dispositivo associado após cerca de 30 dias de inatividade própria, pelo que uma equipa que trabalhe apenas em portáteis pode perder ambos.

O software cumpre as regras da plataforma: texto livre dentro da janela de atendimento ao cliente de 24 horas, templates fora dela. E nenhum dos lados tem conversas de grupo através da API, que a Meta exclui nos números partilhados com a app.

- Ignorar o smb_message_echoes. Sem ele, um bot não consegue saber que um humano já respondeu a partir de um portátil associado.
- Gerir toda a equipa a partir de portáteis associados enquanto o telemóvel principal fica sem uso durante semanas.
- Associar o WhatsApp para Windows depois da integração. A Meta indica-o como não suportado em números Coexistence.

**Quantas pessoas podem responder a um número?** O WhatsApp permite até quatro dispositivos associados além do telemóvel principal, e cada um pode ser usado por uma pessoa diferente.

**As mensagens de um portátil associado chegam ao meu CRM?** Sim. A Meta envia smb_message_echoes para as mensagens enviadas a partir da app ou de um dispositivo associado.

**Um chatbot e uma pessoa podem partilhar uma conversa?** Sim. Ambos escrevem na mesma conversa, e os echoes permitem ao bot ver quando uma pessoa respondeu.

**Existe um limite de lugares do lado da API?** A Meta limita o volume da API, fixando um número partilhado em 20 mensagens por segundo, e não o número de sistemas.

---

## Dispositivos associados e Coexistence: o que fica desassociado

https://easycoexistence.com/pt-pt/docs/linked-devices-and-coexistence

Ao integrar um número da app WhatsApp Business na Cloud API, todos os dispositivos associados à conta ficam desassociados. Os dispositivos suportados, como o WhatsApp Web e os telemóveis associados, podem voltar a ser ligados depois. O WhatsApp para Windows e o WhatsApp para WearOS não são suportados num número com Coexistence, e um dispositivo associado inativo durante cerca de 30 dias é desligado.

### O que acontece aos dispositivos associados durante a integração?

Todos terminam a sessão. A documentação da Meta indica que, quando uma empresa integra na Cloud API uma conta e um número existentes da app WhatsApp Business, todas as aplicações associadas ficam desassociadas da conta, e a empresa pode depois voltar a associar as aplicações suportadas.

Não se perde nada com isto: o telemóvel principal mantém a conta e as conversas. Mas uma receção que responde a partir de um navegador ou de um segundo telemóvel vai ficar sem sessão assim que a integração terminar, pelo que convém avisar a equipa antes de o QR code ser lido e não depois.

### Que dispositivos associados são suportados depois?

Todos, exceto dois. A Meta lista todos os clientes associados como suportados num número com Coexistence, à exceção do WhatsApp para Windows e do WhatsApp para WearOS. Cada um dos suportados volta a ser ligado da forma habitual, lendo um QR code com o telemóvel principal, e conta para o mesmo limite de dispositivos que antes.

- WhatsApp Web num navegador: suportado, volta a ligar-se com o QR code.
- Telemóveis adicionais associados: suportado.
- WhatsApp para Windows: não suportado.
- WhatsApp para WearOS num relógio: não suportado.

### Quantos dispositivos podem ser associados?

Até quatro, além do telemóvel principal. O anúncio do WhatsApp sobre a funcionalidade multidispositivo nos telemóveis descrevia a associação de um telemóvel como um de até quatro dispositivos adicionais, tal como os navegadores, os tablets e os computadores, e apontava como utilização o pessoal de pequenas empresas a responder a clientes a partir dos seus próprios telemóveis.

Num número com Coexistence, o limite é partilhado pelos clientes associados que continuam a ser suportados. Um escritório que usava a aplicação para Windows passa normalmente esses postos para o WhatsApp Web num navegador, que conta como um dos quatro, como qualquer outro dispositivo associado.

### O que mantém os dispositivos associados ligados?

Duas regras de inatividade, uma para cada tipo de dispositivo, e ambas surgem como motivos nos dados de desligação da Meta.

PRIMARY_INACTIVITY aplica-se ao telemóvel principal e dispara após cerca de 14 dias sem atividade. O WhatsApp também refere que, quando o dispositivo principal está inativo durante muito tempo, termina a sessão da conta em todos os dispositivos associados, pelo que um telemóvel principal sem uso arrasta consigo todos os dispositivos ligados.

COMPANION_INACTIVITY aplica-se a um dispositivo associado isoladamente, após cerca de 30 dias de inatividade. Um portátil raramente usado numa delegação é o caso típico.

- Fazer a integração sem avisar o pessoal que responde a partir do WhatsApp Web. A sessão termina quando a integração é concluída.
- Voltar a associar a aplicação WhatsApp para Windows. A Meta lista-a como não suportada em números com Coexistence.
- Deixar o telemóvel principal numa gaveta porque todos trabalham em dispositivos associados. A sua inatividade desliga também os dispositivos associados.

**A Coexistence desassocia o WhatsApp Web?** Sim, na integração todos os dispositivos associados são desassociados. O WhatsApp Web é suportado e pode voltar a ser ligado de imediato.

**Posso usar a aplicação de computador do WhatsApp no Windows?** Não num número com Coexistence. A Meta lista o WhatsApp para Windows como um dispositivo associado não suportado.

**A própria Coexistence é um dispositivo associado?** Não. É a Cloud API ligada ao número através da integração da Meta, e não ocupa nenhum lugar de dispositivo associado.

**Quantos dispositivos associados posso ligar?** Até quatro, além do telemóvel principal, entre os clientes associados que a Meta suporta.

---

## Alterar o número de telefone numa ligação Coexistence

https://easycoexistence.com/pt-pt/docs/changing-the-phone-number

Uma ligação Coexistence pertence a um único número de telefone. Quando a empresa altera o número na app WhatsApp Business, a Meta desliga a ligação com o motivo CHANGE_NUMBER. O novo número é um número de telefone comercial distinto na plataforma e tem de ser integrado através do fluxo Coexistence como uma nova ligação.

### O que acontece à ligação quando o número muda?

Termina. A Meta inclui a alteração do número de telefone entre os motivos pelos quais uma ligação Coexistence é desligada e comunica-a no campo disconnection_info do webhook account_update, com o motivo CHANGE_NUMBER.

Isto é a plataforma a ser coerente, não rígida. Tudo o que o lado da API conhece está associado a um número de telefone comercial: o respetivo ID do número de telefone, o nome a apresentar, a classificação de qualidade e as subscrições de webhook. Um número diferente é um ativo diferente, pelo que nada do que estava associado ao antigo se transfere por si só, e a ligação antiga deixa de funcionar no momento da alteração.

### Como se liga o novo número?

Como uma primeira ligação. O novo número tem de cumprir as mesmas condições de qualquer número que adira à Coexistence e depois percorrer a integração desde o início. Nada da ligação antiga é reutilizado, por isso convém tratar a mudança como um pequeno projeto com data marcada.

- Está ativo na app WhatsApp Business, na versão 2.24.17 ou posterior.
- Está num Portefólio empresarial que administra.
- Não está associado a outro fornecedor.
- O nome a apresentar é indicado no registo, como em qualquer número de telefone comercial.

### O que deve ser atualizado do lado da API?

Todos os locais onde o número antigo ou o respetivo ID está guardado. As integrações que enviam através da Cloud API endereçam um ID de número de telefone, pelo que um CRM, um fluxo de automação ou um agente de IA que continue a apontar para o ID antigo vai falhar em vez de passar para o novo.

A nova ligação repete também as suas perguntas de integração, incluindo se se partilha o histórico de conversas e a janela de 24 horas para o sincronizar. O destino de webhook definido na ligação antiga tem de ser aplicado à nova. Convém ainda verificar a capacidade do portefólio: a Meta limita um novo portefólio empresarial a dois números de telefone comerciais registados, até este ser verificado ou atingir um limite de 2 000 mensagens.

### O que acontece ao número antigo na plataforma?

Continua a ser um ativo da conta WhatsApp Business até alguém o remover. A Meta só permite que os administradores do portefólio empresarial eliminem números de telefone comerciais e recusa a eliminação de um número usado para enviar mensagens pagas nos últimos 30 dias.

Eliminar é uma tarefa de arrumação opcional e não um requisito para ligar o novo número, mas deixar números obsoletos na conta facilita que um sistema continue a endereçar o número errado. Removê-lo depois de passados os 30 dias mantém a conta legível.

- Alterar o número na app antes de planear a nova ligação. A ligação antiga termina nesse momento.
- Deixar o ID do número de telefone antigo nas integrações. Os envios falham em vez de seguirem o novo número.
- Tentar eliminar o número antigo logo após a mudança. A Meta bloqueia-o se enviou mensagens pagas nos últimos 30 dias.

**A ligação acompanha o meu novo número?** Não. A Meta desliga-a com o motivo CHANGE_NUMBER e o novo número é integrado como uma nova ligação.

**Preciso de um novo ID do número de telefone?** Sim. O novo número é um número de telefone comercial distinto na plataforma, com o seu próprio ID.

**Posso eliminar o número antigo de imediato?** Só se não tiver enviado mensagens pagas nos últimos 30 dias, e só um administrador do portefólio o pode eliminar.

**Tenho de escolher novamente um nome a apresentar?** Sim. A Meta exige informação sobre o nome a apresentar quando um número de telefone comercial é registado.

---

## Verificação empresarial da Meta e números Coexistence

https://easycoexistence.com/pt-pt/docs/business-verification

A verificação empresarial da Meta aplica-se a um portefólio empresarial da Meta, não a um número de telefone. Um portefólio pode enviar mensagens sem ela, com um limite inicial de 250 destinatários únicos por dia e dois números registados. Verificar é um dos caminhos para o limite de 2000, eleva o máximo de números para 20 e é exigido antes de pedir o visto azul.

### A verificação empresarial é necessária para ligar um número?

Não. A documentação da Meta trata a verificação como uma forma de aumentar o que um portefólio pode fazer, não como condição para enviar mensagens.

Um portefólio empresarial recém-criado começa com um limite de mensagens de 250 destinatários únicos fora da janela de atendimento ao cliente, num período deslizante de 24 horas, e com um máximo de dois números de telefone empresariais registados. Ambos se aplicam, quer o portefólio esteja verificado quer não, e a empresa pode contactar os seus clientes dentro desses limites desde o primeiro dia.

O que a verificação altera é o teto. É um dos três caminhos que a Meta indica para passar o limite de mensagens de 250 para 2000, e é um dos dois fatores que elevam o máximo de números registados para 20.

### O que desbloqueia a verificação no WhatsApp?

Três coisas distintas, muitas vezes descritas como se fossem uma só.

- Um caminho para o limite de mensagens: verificar é uma forma de se qualificar para 2000, a partir do qual passa a atuar o escalonamento automático da Meta.
- Um máximo de números superior: a Meta eleva o portefólio de dois números registados para 20 e envia um webhook business_capability_update.
- Elegibilidade para Official Business Account: o portefólio titular do número tem de estar verificado antes de se poder pedir o visto azul.
- Nenhuma das três altera o funcionamento da app do WhatsApp Business no telemóvel.

### Como se aplica a verificação a um número Coexistence?

Através do portefólio. Um número ligado por Coexistence fica numa conta WhatsApp Business que pertence a um portefólio empresarial da Meta, e a verificação é uma propriedade desse portefólio. Todos os números nele partilham o resultado, tal como o limite de mensagens do portefólio.

O visto azul é mais restrito. A página da Meta sobre Official Business Account indica que não concede esse estatuto, entre outros, a números de telefone da app do WhatsApp Business, e não descreve em separado os números usados em simultâneo com a app e a Cloud API. Os restantes critérios de elegibilidade são a verificação, pelo menos 30 dias na plataforma, a verificação em dois passos no número e um nome de apresentação aprovado.

### Que portefólio deve ser verificado?

Aquele que é titular da conta WhatsApp Business, que, no caso de uma empresa que liga o seu próprio número, deve ser o seu próprio portefólio.

Isto é relevante para agências. Se o número de um cliente for ligado dentro do portefólio da agência, aplicam-se a verificação, o limite e o máximo de números da agência, e o limite do cliente é partilhado com todos os outros números que a agência aí mantém. A Meta afirma claramente que um só número pode consumir toda a capacidade de mensagens de um portefólio num dado período.

Ligar cada empresa dentro do seu próprio portefólio mantém a verificação, os limites e a faturação com a empresa que realmente envia.

- Adiar a ligação até a verificação terminar. O envio funciona sem ela, dentro do limite inicial.
- Verificar um portefólio diferente daquele que é titular da conta WhatsApp Business. O resultado não se transfere.
- Manter os números de vários clientes num só portefólio de agência. Partilham um único limite de mensagens e um único máximo de números.

**Preciso de verificação empresarial para usar Coexistence?** Não. Um portefólio pode enviar mensagens sem ela, com um limite inicial de 250 destinatários únicos num período deslizante de 24 horas.

**A verificação dá-me o visto azul?** Não por si só. É um dos requisitos para o estatuto de Official Business Account, que é pedido em separado e analisado pela Meta.

**A verificação é feita por número?** Não. Pertence ao portefólio empresarial da Meta, e todos os números desse portefólio a partilham.

**A verificação altera a app no meu telemóvel?** Não. Altera os limites e a elegibilidade na plataforma, não o comportamento da app do WhatsApp Business.

---

## Limites de mensagens do WhatsApp: os escalões atuais por portefólio

https://easycoexistence.com/pt-pt/docs/messaging-limits-and-tiers

Um limite de mensagens define quantas pessoas distintas uma empresa pode alcançar com mensagens fora da janela de apoio ao cliente, em 24 horas deslizantes. Desde 7 de outubro de 2025, é definido por portefólio empresarial da Meta e partilhado por todos os números que nele existem. Começa em 250 e sobe para 2 000, 10 000, 100 000 e ilimitado.

### O que conta, na prática, o limite de mensagens?

Os números de telefone únicos de utilizadores do WhatsApp aos quais a sua empresa entrega mensagens fora de uma janela de apoio ao cliente, dentro de 24 horas deslizantes. Desta formulação decorrem três consequências.

As respostas dentro de uma janela de apoio ao cliente aberta não contam, pelo que um número que apenas responde a quem lhe escreveu pode funcionar muito acima do limite sem lhe tocar. O envio de vários templates à mesma pessoa conta essa pessoa uma só vez. E a janela é deslizante, não um dia de calendário, pelo que a capacidade se liberta gradualmente à medida que os envios mais antigos saem do período.

O limite diz respeito a quantas pessoas se alcança em primeiro lugar, não à rapidez nem ao volume de envio.

### O que mudou em outubro de 2025?

Antes de 7 de outubro de 2025, cada número de telefone tinha o seu próprio limite, e um número novo começava em 250, independentemente do que os restantes tinham conquistado. Desde então, o limite pertence ao portefólio empresarial e todos os números que nele existem o partilham.

- Um número recém-registado passa de imediato a partilhar o limite do portefólio.
- O primeiro passo a seguir a 250 é 2 000, quando antes era 1 000.
- Os aumentos chegam 6 horas depois de cumpridos os critérios, em vez de 24.
- Uma descida na classificação de qualidade de um número já não faz baixar o limite.
- O campo a ler é whatsapp_business_manager_messaging_limit; messaging_limit_tier está obsoleto.

### Como sobe o limite?

Em duas fases. Para sair dos 250, o portefólio conclui um percurso de escalonamento: verificar a empresa, pedir ao parceiro de onboarding que a verifique, ou entregar 2 000 mensagens fora das janelas de apoio ao cliente a destinatários únicos em 30 dias, com templates de classificação de qualidade elevada. A Meta analisa então a qualidade das mensagens e aprova ou recusa; a recusa chega através de um webhook account_alerts que indica a alternativa a seguir.

A partir de 2 000, o escalonamento é automático. A Meta sobe o portefólio um nível quando este envia mensagens de qualidade elevada em todos os seus números e templates, e utilizou pelo menos metade do limite atual nos últimos 7 dias. Não há nada a comprar nem pedido a submeter.

### Em que difere o limite de mensagens do throughput?

O limite conta pessoas por dia; o throughput conta mensagens por segundo. São definidos em separado e falham em separado.

Num número em Coexistence, a diferença é nítida. A Meta fixa o throughput em 20 mensagens por segundo para qualquer número utilizado em simultâneo na app WhatsApp Business e na Cloud API, para o manter compatível com a app. Esse valor não acompanha o nível do portefólio, pelo que um portefólio com limite de mensagens ilimitado continua a enviar a 20 por segundo a partir de um número em Coexistence.

O limite por segundo, o limite por destinatário e o limite de chamadas de gestão têm cada um a sua página e os seus códigos de erro.

- Ler messaging_limit_tier. Está obsoleto; o campo atual é whatsapp_business_manager_messaging_limit.
- Presumir que cada número novo começa em 250. Desde outubro de 2025, herda de imediato o limite do portefólio.
- Contar as respostas para o limite. As mensagens dentro de uma janela de apoio ao cliente aberta não fazem parte dele.
- Deixar a campanha de um número esgotar os restantes. Todo o portefólio consome o mesmo limite.

**O limite é por número ou por conta?** Por portefólio empresarial da Meta desde 7 de outubro de 2025. Todos os números do portefólio o partilham.

**As respostas dos clientes contam para o meu limite?** Não. Só contam as entregas fora de uma janela de apoio ao cliente, e cada destinatário único conta uma vez por cada 24 horas deslizantes.

**Uma classificação de qualidade baixa pode reduzir o meu limite?** Desde outubro de 2025, não. A Meta deixou de baixar limites por quebras de qualidade, embora a qualidade continue a decidir se o limite cresce.

**Um nível mais alto aumenta o throughput em Coexistence?** Não. O throughput num número em Coexistence está fixado em 20 mensagens por segundo, seja qual for o nível.

---

## Catálogos de produtos num número com Coexistence

https://easycoexistence.com/pt-pt/docs/catalog-and-coexistence

Ligar um número através da Coexistence mantém inalteradas, na app, as ferramentas de catálogo, encomendas e estados da app WhatsApp Business, e a Cloud API não expõe essas ferramentas da app. As mensagens de produtos através da API usam um catálogo carregado na Meta e ligado à conta WhatsApp Business, configurado por número de telefone.

### O catálogo da minha app WhatsApp Business sobrevive à Coexistence?

Sim, no telemóvel. A tabela de funcionalidades da Coexistence da Meta lista as ferramentas comerciais, com catálogo, encomendas e estados como exemplos, sem qualquer alteração ao seu funcionamento na app WhatsApp Business depois de o número ser ligado.

A mesma linha assinala-as como não suportadas na Cloud API. É esta a parte a que se deve atender no planeamento: uma integração não deve esperar ler, editar ou replicar a ferramenta de catálogo da app através da API.

Assim, uma loja que vende a partir do catálogo da app continua a fazê-lo exatamente da mesma forma depois de ligar o número. A diferença é que passa também a dispor da API, com a sua própria forma de enviar produtos.

### Como funciona um catálogo de produtos através da Cloud API?

Através de um catálogo carregado na Meta e ligado à conta WhatsApp Business. Um catálogo é um inventário estruturado de produtos ou serviços, e cada artigo inclui dados como nome, descrição, preço, imagens e disponibilidade. A Meta descreve quatro fases.

- Carregamento do inventário, através da Commerce API ou do Meta Commerce Manager.
- Configuração de comércio por número de telefone: se o carrinho está ativado e se o catálogo está visível.
- Partilha de produtos com mensagens de catálogo, de produto único, multiproduto ou carrossel.
- Respostas dos clientes, que chegam como notificações por webhook com os detalhes da encomenda e as perguntas sobre produtos.

### O que difere entre as mensagens de produtos na app e através da API?

A Meta documenta uma diferença visível: as mensagens enviadas através da Cloud API não mostram, para já, o ícone do carrinho de compras no cabeçalho da conversa, ao contrário das mensagens de produtos enviadas a partir da app WhatsApp Business.

O lado da API tem também definições que a app não expõe da mesma forma. Por predefinição, o carrinho de compras está ativado e o ícone da loja está oculto para todos os números de telefone da empresa na conta, e ambos podem ser alterados por número com o endpoint de definições de comércio. Ao desativar o catálogo, as ligações wa.me do catálogo e o botão Ver catálogo mostram um aviso de catálogo inválido quando são tocados.

Fora da janela de atendimento ao cliente, os produtos continuam a ser enviados dentro de um template aprovado, como qualquer outra mensagem iniciada pela empresa.

### Quem revê os produtos?

A Meta, de forma automática. Os artigos adicionados a um catálogo ligado a uma conta WhatsApp Business são revistos, e um artigo que viole as políticas é assinalado, sendo a empresa remetida para as Políticas de Comércio do WhatsApp. Os artigos reprovados podem ser objeto de recurso no Meta Commerce Manager.

Os clientes podem também denunciar um produto específico que tenham recebido numa mensagem, o que desencadeia uma revisão própria. As denúncias sobre a própria empresa são outra questão: são um dos sinais que a Meta usa para a classificação de qualidade de um número.

As empresas sediadas na Índia têm a obrigação adicional de cumprir as leis de venda online, que a Meta disponibiliza através da sua Business Compliance API.

- Esperar que a ferramenta de catálogo da app possa ser lida através da API. A Meta indica-a como não suportada na Cloud API.
- Desativar o catálogo num número enquanto ainda circulam ligações wa.me do catálogo. Essas ligações passam a mostrar um aviso de catálogo inválido.
- Enviar produtos fora da janela de atendimento ao cliente sem um template. As mensagens iniciadas pela empresa continuam a exigir um.

**Ligar o número apaga o meu catálogo?** Não. A Meta indica que as ferramentas comerciais da app, incluindo o catálogo, ficam inalteradas depois da ativação da Coexistence.

**A API consegue ler o catálogo da minha app?** A Meta assinala as ferramentas comerciais da app como não suportadas na Cloud API. As mensagens de produtos da API usam um catálogo ligado à conta WhatsApp Business.

**Quantos produtos cabem numa mensagem?** Até 30 numa mensagem multiproduto, organizados em secções.

**Posso desativar o carrinho?** Sim, por número de telefone, através do endpoint de definições de comércio. Está ativado por predefinição.

---

## Listas de difusão vs templates de marketing após a Coexistence

https://easycoexistence.com/pt-pt/docs/broadcast-lists-vs-templates

Depois de um número ser ligado através da Coexistence, as listas de difusão da app WhatsApp Business ficam só de leitura e não é possível criar novas. O equivalente na API é um template de marketing enviado a cada destinatário, que exige opt-in, conta para o limite de mensagens do portefólio, é cobrado pela Meta e respeita as preferências de marketing de cada pessoa.

### O que substitui uma lista de difusão na API?

Um template de marketing aprovado, enviado uma vez por destinatário através da Cloud API. Não existe um objeto de lista do lado da API: a integração guarda o público e envia o template a cada número que dele faz parte.

Isto altera três coisas em simultâneo. O conteúdo passa pela revisão de templates da Meta antes de poder ser enviado. Cada envio fora da janela de atendimento ao cliente abre uma conversa que a Meta cobra ao método de pagamento da conta WhatsApp Business da própria empresa. E cada destinatário único conta para o limite de mensagens do portefólio nas últimas 24 horas.

A desativação em si, e os motivos que a Meta indica para ela, estão descritos na página sobre as funcionalidades que a Coexistence desliga.

### Quem pode receber um template de marketing?

As pessoas que deram o seu número à empresa e aceitaram ouvir falar dela (opt-in). A Política de Mensagens Comerciais da Meta torna ambas as condições explícitas, e o opt-in tem de identificar a empresa e indicar que a pessoa concorda em receber as suas mensagens.

A Meta deixa o método ao critério da empresa, desde que cumpra esses requisitos e a lei aplicável: SMS, um formulário num site, uma chamada IVR ou um formulário em papel assinado constam dos exemplos. A prova do opt-in fica, por isso, nos registos da própria empresa, e não na lista de contactos de um telemóvel.

Enviar a pessoas que nunca deram opt-in é também a forma mais rápida de acumular bloqueios e denúncias, que são o que faz baixar a qualidade.

### Porque é que alguns templates de marketing não chegam?

Porque a API aplica controlos por destinatário que as listas de difusão nunca mostravam.

- Limites de marketing por utilizador: o WhatsApp pode reter templates de marketing dirigidos a uma pessoa com menor probabilidade de interagir, devolvendo 131049.
- Marketing interrompido: uma pessoa pode deixar de receber mensagens de marketing da empresa na definição Ofertas e anúncios, o que devolve 131050.
- Números dos Estados Unidos: atualmente, o WhatsApp não entrega templates de marketing a utilizadores com números de telefone dos EUA.
- Regiões excluídas: neste momento, os limites por utilizador não estão ativos no EEE, no Reino Unido, no Japão nem na Coreia do Sul.

### A ferramenta de mensagens de marketing da app continua a funcionar?

A tabela de funcionalidades da Coexistence da Meta reúne as ferramentas de mensagens da app numa só linha, que menciona mensagens de marketing, mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas, e não regista qualquer alteração a elas na app WhatsApp Business após a adesão. A mesma linha assinala-as como não suportadas na Cloud API.

Assim, a funcionalidade de mensagens de marketing da app e os templates de marketing da API são dois caminhos distintos no mesmo número. A Meta indica ainda que as mensagens enviadas a partir da app WhatsApp Business continuam gratuitas após a adesão, enquanto as enviadas através da Cloud API seguem os preços da Cloud API.

As listas de difusão são a exceção que muda, e por isso precisam de substituto.

- Voltar a tentar um 131049 de imediato. A Meta pede pelo menos 24 horas, e repetições antecipadas podem bloquear novas tentativas até um dia.
- Voltar a tentar um 131050. A pessoa deixou de receber mensagens de marketing da empresa, e a mensagem não será recebida.
- Importar uma lista de difusão como lista de opt-in. Ter o número guardado não é o opt-in que a política descreve.

**As minhas listas de difusão são eliminadas?** Não. As listas de difusão existentes ficam só de leitura e não é possível criar novas enquanto o número estiver ligado.

**Preciso de um template para contactar o público da minha lista de difusão?** Fora da janela de atendimento ao cliente, sim. Um template de marketing é o caminho da API para a promoção iniciada pela empresa.

**Porque é que um template falhou com 131050?** Esse destinatário escolheu deixar de receber mensagens de marketing da sua empresa. A Meta indica que não se deve voltar a tentar.

**A funcionalidade de mensagens de marketing da app desapareceu?** A Meta indica que as ferramentas de mensagens da app, incluindo as mensagens de marketing, ficam inalteradas na app após a adesão.

---

## Requisitos de opt-in do WhatsApp para mensagens iniciadas pela empresa

https://easycoexistence.com/pt-pt/docs/opt-in-requirements

Antes de uma empresa enviar mensagens a alguém no WhatsApp, a política da Meta exige duas coisas: a pessoa deu à empresa o seu número de telefone e a empresa recebeu um opt-in a confirmar que a pessoa quer receber as suas mensagens. Desde novembro de 2024, o opt-in pode ser geral, e não específico do WhatsApp, mas tem de indicar o nome da empresa e cumprir a lei local.

### O que exige a política de opt-in da Meta?

Duas condições, que têm de se verificar ambas antes de uma empresa contactar alguém no WhatsApp. A pessoa deu à empresa o número do seu telemóvel e a empresa recebeu dessa pessoa a permissão de opt-in, a confirmar que quer receber mensagens ou chamadas posteriores da empresa.

O próprio opt-in tem três requisitos. Tem de indicar claramente que a pessoa aceita receber comunicações da empresa. Tem de indicar claramente o nome da empresa. E tem de cumprir a lei aplicável, cuja verificação a Meta deixa inteiramente a cargo da empresa.

A atualização da política da Meta de novembro de 2024 flexibilizou um ponto: o opt-in pode ser geral e não precisa de mencionar o WhatsApp, desde que se cumpra a lei local.

### Que métodos de opt-in aceita a Meta?

Qualquer método que cumpra os três requisitos. A Meta indica que um método nessas condições está em conformidade com a política, deixa a escolha à empresa e dá exemplos de métodos suportados. Seja qual for o método, a Meta aconselha também a deixar claro o que a pessoa ganha ao receber as mensagens.

- SMS.
- Um formulário num website.
- Por telefone, através de um fluxo de resposta de voz interativa.
- Presencialmente ou em papel, com um documento físico assinado.
- Seja qual for o método, a empresa é responsável pelos avisos e pelas permissões que a lei aplicável exige.

### Um contacto na minha app WhatsApp Business conta como opt-in?

Não por si só. A política da Meta associa a permissão à confirmação, pela pessoa, de que quer receber mensagens da empresa, e um número de telefone numa lista de contactos cumpre, no máximo, a primeira das duas condições.

Isto é relevante num número em Coexistence, porque a ligação pode sincronizar os contactos da app, e a base de clientes existente é o público óbvio para uma primeira campanha com templates. Ter o número de alguém não é o mesmo que ter a sua confirmação.

Um cliente que escreve à empresa é um caso diferente: a sua mensagem abre uma janela de atendimento ao cliente, dentro da qual a empresa pode responder.

### O que acontece se o opt-in for fraco?

Os destinatários reagem, e a plataforma responde a essa reação. As orientações da Meta sobre opt-in referem que as pessoas podem bloquear ou denunciar uma empresa, ou deixar de receber as suas mensagens de marketing, e que os sistemas da Meta limitam o envio de uma empresa cuja qualidade se mantém baixa durante um período prolongado.

O conselho prático da Meta decorre daí. Definir expectativas, indicando as categorias de mensagens que a empresa vai enviar, ou recolher o opt-in por categoria. Dar instruções claras para sair de categorias específicas e respeitá-las. Tornar evidentes os fluxos de opt-in e de opt-out e acompanhar de perto a classificação de qualidade quando um novo método de opt-in entra em funcionamento.

A política exige ainda que se respeite todo o pedido de bloqueio, interrupção ou opt-out, no WhatsApp ou fora dele, incluindo remover essa pessoa das listas de contactos.

- Tratar os contactos sincronizados da app como uma lista de opt-in. A política pede a confirmação de cada pessoa, e não apenas o seu número.
- Recolher um opt-in que nunca indica o nome da empresa. A Meta exige que o nome da empresa seja indicado de forma clara.
- Respeitar os opt-outs apenas quando chegam pelo WhatsApp. A política abrange os pedidos feitos por qualquer canal.

**O opt-in tem de mencionar o WhatsApp?** Não. Desde a atualização da política de novembro de 2024, é permitido um opt-in geral, desde que cumpra a lei local.

**Preciso de opt-in para responder a um cliente que escreveu primeiro?** A mensagem de um cliente abre uma janela de atendimento ao cliente, dentro da qual as respostas são permitidas. O opt-in rege as mensagens que a empresa inicia.

**O opt-in pode ser recolhido offline?** Sim. A Meta inclui, entre os métodos aceites, o opt-in presencial ou em papel, com um documento assinado.

**O que deve acontecer quando alguém faz opt-out?** Deixar de lhe enviar mensagens, seja qual for o canal que usou para o pedir, e removê-lo das listas de contactos, como a política exige.

---

## Como os bloqueios e as denúncias afetam a classificação de qualidade no WhatsApp

https://easycoexistence.com/pt-pt/docs/quality-rating-blocks-and-reports

A qualidade das mensagens é avaliada pela forma como os destinatários receberam as mensagens de uma empresa nos últimos sete dias, com maior peso para as mais recentes. Os sinais são bloqueios, denúncias, silenciamentos, arquivamentos e os motivos que as pessoas indicam ao bloquear. Uma qualidade baixa prolongada leva à limitação de envios, ao erro 131048 nos envios e à suspensão de templates.

### Que feedback faz descer a classificação de qualidade do WhatsApp?

A Meta indica os sinais de forma direta: bloqueios, denúncias, silenciamentos, arquivamentos e os motivos que os utilizadores dão ao bloquear uma empresa. A qualidade baseia-se na forma como as mensagens foram recebidas nos últimos sete dias e tem em conta a recência, pelo que um mau envio de ontem pesa mais do que um de há seis dias.

Daqui resultam duas consequências. Uma única campanha mal segmentada pode alterar rapidamente a classificação, e a Meta refere que, em números com muito tráfego, a qualidade costuma mudar em poucos minutos. Além disso, como a avaliação abrange apenas os últimos sete dias, o feedback mais antigo deixa de contar.

Os templates têm a sua própria classificação, construída a partir do feedback e das taxas de leitura, além da do número.

### O que acontece quando a qualidade desce?

Várias coisas, a diferentes níveis.

- Os envios podem falhar com o erro 131048, que a Meta associa a demasiadas mensagens bloqueadas ou assinaladas como spam.
- Os templates classificados como YELLOW ou RED ainda podem ser enviados, mas correm o risco de ser suspensos ou desativados.
- A qualidade influencia o ritmo de envio dos templates, o que pode atrasar a entrega de uma campanha.
- A política permite que o WhatsApp limite o número de mensagens que uma empresa pode enviar com base em bloqueios e denúncias.
- Desde 7 de outubro de 2025, uma descida deixou de reduzir o limite de mensagens do portefólio, mas pode impedir que esse limite aumente.

### Como recuperar uma classificação de qualidade baixa?

Comece por travar a origem do feedback negativo e deixe depois a janela de sete dias avançar.

As diretrizes da Meta para mensagens de alta qualidade servem de lista de verificação. Envie apenas a pessoas que aceitaram receber mensagens da empresa. Torne as mensagens personalizadas e úteis. Evite mensagens de boas-vindas ou de apresentação demasiado genéricas. Evite enviar demasiadas mensagens por dia. Mantenha o conteúdo e a extensão concisos.

Na prática, isto significa suspender a campanha ou o template que está a gerar bloqueios, verificar a que segmento de público foi enviado e confirmar o consentimento que esse público deu. A própria orientação da Meta sobre consentimento sugere recolhê-lo por categoria de mensagem, precisamente porque as categorias inesperadas são o que as pessoas bloqueiam.

### Onde se consulta a classificação de qualidade?

No WhatsApp Manager, em Ferramentas da conta e Números de telefone, junto com o estado do número e o limite de mensagens, e no objeto do número de telefone através da Graph API, como quality_rating. As classificações dos templates estão em cada template como quality_score e, no painel Gerir templates, como High, Medium, Low ou Quality pending.

Nada disto aparece na app WhatsApp Business no telemóvel, e é por isso que um número em Coexistence pode degradar-se sem que ninguém na loja repare. A classificação não é entregue pelo webhook phone_number_quality_update, apesar do nome desse campo; esse webhook tem uma página própria que explica o que transporta.

- Enviar uma mensagem de boas-vindas genérica a uma lista acabada de importar. A Meta indica-a como algo a evitar, e gera bloqueios.
- Voltar a tentar envios que falharam com o erro 131048. A restrição está no número, e mais envios aumentam o feedback que a causa.
- Vigiar apenas a classificação do número. Os templates têm a sua própria, e um template RED pode ser suspenso enquanto o número parece estar bem.

**Um único bloqueio faz descer a minha classificação?** A Meta não publica um limiar. A qualidade reflete o feedback global sobre as mensagens dos últimos sete dias, com maior peso para as mais recentes.

**Uma classificação baixa pode reduzir o meu limite de mensagens?** Não desde 7 de outubro de 2025. Pode, ainda assim, impedir que o limite aumente e restringir envios.

**Quanto tempo demora a recuperação?** A Meta não publica um tempo de recuperação. A avaliação abrange os últimos sete dias, pelo que o feedback mais antigo deixa de contar.

**As conversas silenciadas contam?** Sim. A Meta indica os silenciamentos e os arquivamentos, a par dos bloqueios e das denúncias, como sinais de qualidade.

---

## RGPD e Coexistence: para onde vão os dados das mensagens

https://easycoexistence.com/pt-pt/docs/gdpr-and-coexistence

Depois de um número ser ligado através da Coexistence, as suas mensagens ficam espelhadas entre a app WhatsApp Business e a Cloud API. A Meta afirma que, na Cloud API, atua como subcontratante em nome da empresa, conserva as mensagens durante um máximo de 30 dias e espera que cada empresa cumpra as suas próprias obrigações do RGPD.

### O que muda nos dados das mensagens quando um número usa Coexistence?

As conversas passam a ficar visíveis para a Cloud API, além do telemóvel. A documentação da Meta sobre a Coexistence indica que as mensagens enviadas e recebidas são espelhadas entre a Cloud API e a app WhatsApp Business, que os contactos com número de WhatsApp podem ser sincronizados e que as mensagens dos últimos seis meses podem ser sincronizadas durante a integração. As conversas de grupo não são sincronizadas.

A partir desse momento, as mensagens individuais do número passam pela Cloud API, que a Meta descreve como a desencriptar uma mensagem recebida e a reencaminhá-la para a empresa, e a encriptar as mensagens enviadas com o protocolo Signal antes da entrega.

Esta página indica o que a Meta documenta e o que a EasyCoexistence faz. Não constitui aconselhamento jurídico, e cabe à empresa e aos seus consultores decidir se uma determinada configuração cumpre o RGPD.

### O que diz a Meta sobre o seu próprio papel no âmbito do RGPD?

A página da Meta sobre privacidade de dados da Cloud API expõe a sua posição nas suas próprias palavras.

- Onde a lei reconhece a figura do subcontratante, a Meta atua como tal em nome da empresa ao fornecer a Cloud API.
- A Cloud API só utiliza as mensagens que processa em nome e por instrução da empresa, salvo indicação em contrário.
- As mensagens são conservadas no máximo 30 dias; os identificadores de utilizador são eliminados no prazo de 30 dias após a última atualização de estado de uma mensagem.
- Os clientes da Cloud API têm de cumprir as suas próprias obrigações ao abrigo de leis como o RGPD.
- Os clientes na Região Europeia estão abrangidos pelo WhatsApp Business Data Transfer Addendum.

### Os dados das mensagens podem ser armazenados na UE?

A Meta oferece o armazenamento local da Cloud API, que mantém o conteúdo das mensagens em repouso num país escolhido, após um curto período de utilização. Na Cloud API, esse período de utilização é de até 60 minutos, durante os quais o conteúdo pode ser processado em centros de dados da Meta a nível internacional. As opções europeias são a Alemanha para a UE, a Suíça e o Reino Unido.

O armazenamento local define-se no momento do registo de um número, e alterá-lo num número já registado implica anular o registo e registá-lo de novo. A documentação de registo da Meta indica também que o endpoint de anulação de registo não pode ser usado num número que esteja em utilização simultânea com a Cloud API e a app WhatsApp Business, e não descreve um caminho separado para ativar o armazenamento local num número em Coexistence.

### Para onde vão as mensagens depois da Meta?

Para o endpoint que receber os webhooks da conta WhatsApp Business. A substituição de webhook da Meta permite a uma aplicação enviar os webhooks de determinada conta para um URL de callback diferente do da própria aplicação.

A EasyCoexistence usa essa substituição para apontar os eventos de mensagens para o sistema da própria empresa, de modo que a Meta entrega aí o conteúdo das conversas e não a nós, e a EasyCoexistence nunca armazena o conteúdo das conversas. Guardamos os eventos operacionais, como o estado da ligação e a qualidade, que são o que a monitorização utiliza.

A Meta documenta ainda que dispõe de relatórios SOC 2 Type II e ISO 27001 para a Cloud API, publicados através do seu Business Messaging Compliance Center.

- Presumir que o papel de subcontratante da Meta cobre as obrigações da própria empresa. A Meta afirma que os clientes têm de cumprir as suas próprias obrigações do RGPD.
- Aceitar a sincronização do histórico sem decidir onde ele vai parar. Até seis meses de conversas podem ser entregues ao sistema recetor.
- Planear ativar o armazenamento local mais tarde. Define-se no registo, e alterá-lo implica registar de novo.

**A Meta é subcontratante ou responsável pelo tratamento na Cloud API?** A Meta afirma que atua como subcontratante em nome da empresa na Cloud API, onde a lei reconhece esse conceito.

**Durante quanto tempo a Meta conserva o conteúdo das mensagens?** A Meta indica um período máximo de retenção de 30 dias para as mensagens da Cloud API, para funcionalidades como a retransmissão.

**A EasyCoexistence vê as minhas conversas?** Os eventos de mensagens são encaminhados pela Meta para o seu próprio sistema, e a EasyCoexistence nunca armazena o conteúdo das conversas.

**Esta página constitui aconselhamento jurídico?** Não. Indica o que a Meta documenta e o que a EasyCoexistence faz. A avaliação da conformidade cabe à empresa e aos seus consultores.