# EasyCoexistence: Português (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 de WhatsApp para Claude, ChatGPT e Cursor https://easycoexistence.com/pt/whatsapp-mcp-server Um servidor MCP deixa um assistente de IA usar o WhatsApp diretamente: ele lista os seus números, envia mensagens e templates, checa a saúde e aponta o webhook para o seu sistema. A EasyCoexistence roda um em cima da Cloud API oficial da Meta, então o número que os seus clientes já usam para falar com você segue oficial e nunca fica em risco. ### O que é um servidor MCP de WhatsApp? MCP, o Model Context Protocol, é como um assistente de IA alcança uma ferramenta que não pertence a ele. Você adiciona um conector uma vez e o assistente passa a poder chamar aquela ferramenta em seu nome, em linguagem comum, sem nenhum código de cola no meio. Um servidor MCP de WhatsApp expõe um número de WhatsApp como uma dessas ferramentas. Em vez de escrever um script que se autentica contra uma API, monta um payload e trata a resposta, você pede: manda uma mensagem para este cliente, cria um template para avisos de pedido, me diz se este número está saudável. O assistente faz as chamadas. O que importa é qual WhatsApp ele alcança. Existem duas coisas completamente diferentes usando o mesmo nome, e essa diferença decide se o número de um cliente sobrevive ou não. ### Por que a maioria dos servidores MCP de WhatsApp derruba números? Quase todo servidor MCP de WhatsApp que você consegue instalar hoje funciona dirigindo o WhatsApp Web. Ele entra como um dispositivo conectado, do mesmo jeito que o cliente de navegador faz, e automatiza aquela sessão. Isso é contra os termos do WhatsApp, que proíbem uso automatizado e em massa do cliente de consumidor, e um dispositivo conectado é o cliente de consumidor. Um número que faz isso pode ser banido, e uma promessa de anti-ban descreve algo que o fornecedor não controla. Para um número pessoal isso é um aborrecimento. Para o número que os clientes de um negócio já usam para falar com ele, isso é o negócio inteiro. O conector da EasyCoexistence não faz nada disso. Ele chama a Cloud API oficial da Meta, num número conectado pelo recurso de Coexistência da própria Meta. Não há dispositivo conectado nenhum e não há sessão para perder. ### O que a IA consegue de fato fazer com ele? Dezesseis ferramentas, que mapeiam para as coisas que alguém realmente pede no dia a dia. Leitura: listar os números da sua conta, checar a saúde de um número, que é a classificação de qualidade dele, o nível de mensageria e o estado da conexão, e ler as credenciais de API dele quando você precisar delas em outro lugar. Envio: mandar uma mensagem dentro da sessão de 24 horas; listar os templates do número, criar um novo, checar se a Meta aprovou, e enviar um template aprovado para abrir uma conversa fora da janela. Ligação: definir o destino do webhook, para que as mensagens recebidas sejam roteadas da Meta direto para o seu próprio servidor. E iniciar uma conexão, que devolve o link que um cliente abre para anexar o número dele. Há também uma ferramenta de documentação, então o assistente consulta como algo funciona em vez de chutar. Esse último par é o que faz disso mais do que um brinquedo de conversa. Um agente consegue conectar um número e apontá-lo para o seu sistema sem nenhum humano abrir um painel. Partner API: mais cinco ferramentas configuram links de conexão hospedados, para quando o seu próprio software deixa os clientes dele conectarem os próprios números. Elas mostram o status da configuração, criam ou revogam a chave de API, definem a URL que recebe os eventos de status e criam um link de conexão para um cliente. ### O negócio continua usando o app no celular? Sim, e é exatamente essa a razão pela qual isso funciona num número do qual um negócio já depende todos os dias. Coexistência é o modo oficial da Meta para rodar o app do WhatsApp Business e a Cloud API num número só ao mesmo tempo. O time continua respondendo pelo celular exatamente como antes, com as mesmas conversas, o mesmo histórico e o mesmo aparelho, enquanto a API envia e recebe naquele mesmo número. O que a API manda aparece no app, e o que o time digita no app fica visível para a API. Então o agente não está substituindo ninguém. Ele responde quando consegue, e o humano pega o mesmo fio da conversa no celular quando quiser. Nenhum dos dois lados precisa 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 da janela só passa um template aprovado, então um agente que só conhece send_message vai emudecer na hora 25. - Esperar conversas em grupo. Números em Coexistência ficam de fora da API de grupos, em todo e qualquer provedor. - Apontar o webhook para uma URL que não responde ao handshake GET da Meta. A Meta verifica o endpoint antes de entregar qualquer coisa, e um 404 silencioso parece exatamente uma configuração funcionando até a primeira mensagem nunca chegar. **O número do meu cliente pode ser banido por causa disso?** Não. Esta é a Cloud API oficial da Meta, alcançada pelo recurso de Coexistência da própria Meta. O risco de ban de que as pessoas falam vem de gateways não oficiais que entram como dispositivo conectado, que é um mecanismo completamente diferente. **Com quais assistentes o conector funciona?** Qualquer um que fale MCP por HTTP com OAuth: Claude, ChatGPT, Cursor, Claude Code e Codex hoje. É um endpoint remoto só, então nada roda na sua máquina. **As minhas conversas passam pelos servidores de vocês?** Não. As mensagens recebidas são roteadas da Meta direto para o webhook que você indicar, e nós nunca guardamos conteúdo de conversa. Guardamos o status da conta e do número de telefone necessário para monitorar a conexão, nada além disso. **Posso usar um conector só para vários clientes?** Pode. Uma conta comporta quantos números você precisar, cada um cobrado como a própria conexão dele, e o conector lista todos eles. Não há restrição nenhuma para usá-lo com negócios que você atende. --- ## Coexistência do WhatsApp: o app e a API em um número https://easycoexistence.com/pt/whatsapp-coexistence A Coexistência é o modo oficial da Meta para rodar o app do WhatsApp Business e a Cloud API em um número ao mesmo tempo. A equipe continua atendendo pelo celular, com as mesmas conversas e o mesmo histórico, enquanto o software envia e recebe nessa mesma linha. Nada migra e nenhum número muda. ### What problem does Coexistence actually solve? Before it existed, putting a business number on the WhatsApp API meant giving up the app. The number was migrated, the phone stopped working as a WhatsApp client, and whoever had been answering customers all day suddenly had to do it through whatever software had been bought. Most small teams would not accept that trade, so they never automated anything. Coexistence removes the trade. The app keeps working exactly as it did. The same person answers from the same phone, sees the same conversations, and needs to learn nothing. Meanwhile the API is attached to that same number and can send, receive and be wired into other systems. So the question stops being whether to give up the phone. It becomes what you want software to handle, with a human picking up the same thread whenever they want to. ### What changes on the phone after connecting? Almost nothing, and that is the point. The app opens the same way, the contact list is the same, and old conversations are all still there. Nobody has to sign in anywhere new. What changes is invisible from the phone. Messages the API sends appear in the app's conversation thread, so the person answering sees the full picture rather than half of it. Messages typed in the app are visible to the API, so software does not reply on top of a human who already answered. Meta syncs roughly six months of history when a number first connects, which means the API does not start blind. Two limits are worth knowing up front: group chats are excluded from the API on Coexistence numbers, on every provider, and the number cannot be on WhatsApp's consumer app, only the Business app. ### Who is Coexistence for? Two groups, and they want opposite things from it. A business with one number and a small team wants the phone to keep working while something automates the repetitive part: confirmations, reminders, the first reply outside business hours. They are not buying software to replace anyone. They are buying back the evenings. An agency, consultancy or developer wants the opposite view. They serve many businesses, each with a number they cannot touch or migrate, and they need those numbers reachable by the systems they build. Coexistence is the only official way to get an API onto a number that a client's staff still answers by hand. Both need the same thing underneath: the connection has to stay alive, and somebody has to notice when it does not. ### Why does a Coexistence connection need monitoring? Because it can stop working without anyone being told. A number carries a quality rating and a messaging tier that Meta adjusts based on how recipients react. Ratings drop. Tiers change. Access tokens expire. A webhook destination that stops answering is simply not retried forever. None of this produces an alert on the phone, and the app keeps working normally throughout, so the first sign is usually a customer saying they never got the message. Meta also applies a rule where a connection that sees no API activity for fourteen days needs attention. Nothing about that is hidden or unfair, but it is easy to walk past. This is what EasyCoexistence watches. The connection is checked continuously, and if something changes you hear it from us rather than from a customer. 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. - Trying to connect a number that is on WhatsApp's consumer app. Coexistence needs the Business app, and the number has to be moved there first. - Assuming group chats will come through. They are excluded from the API on Coexistence numbers, on every provider, so anything built around groups will not work. - Replying with free text more than 24 hours after the customer's last message. Outside that window only an approved template goes through. - Leaving the webhook pointed at a URL that cannot answer Meta's verification request. Meta checks the endpoint before delivering anything, and a silent failure looks identical to a working setup. **Minha equipe precisa parar de usar o celular?** Não. Esse é exatamente o ponto da Coexistência. O app do WhatsApp Business continua funcionando no mesmo número, com as mesmas conversas, e a API roda ao lado dele. **Vou perder minhas conversas atuais?** Não. Elas ficam no app, e a Meta sincroniza cerca de seis meses de histórico com a API quando o número conecta, então o software começa com contexto em vez de vazio. **Dá para desfazer?** Sim. Um número pode ser desconectado, e o app segue como sempre foi. Nada no número em si é alterado permanentemente por conectá-lo. **Isso é igual às APIs não oficiais de WhatsApp?** Não, e a diferença decide se o número sobrevive. A Coexistência é o recurso oficial da Meta na Cloud API. Gateways não oficiais controlam o WhatsApp Web como dispositivo vinculado, o que viola os termos e faz números serem banidos. --- ## APIs não oficiais do WhatsApp: o que de fato derruba números https://easycoexistence.com/pt/unofficial-whatsapp-api-risks APIs não oficiais do WhatsApp funcionam entrando como dispositivo vinculado e automatizando a sessão do WhatsApp Web. Isso quebra os termos do WhatsApp, a Meta detecta o padrão, e o número é banido. A Cloud API oficial faz o mesmo trabalho por uma interface que a Meta sustenta, no número que o negócio já usa. ### Como funcionam as APIs não oficiais do WhatsApp? Todas elas, diga o marketing o que disser, fazem a mesma coisa por baixo. Abrem o protocolo que o WhatsApp Web usa, se pareiam a uma conta como dispositivo vinculado, e então dirigem aquela sessão por programa. A biblioteca lê as mensagens que entram pelo socket e empurra as que saem de volta por ele. É por isso que são baratas, que instalam em minutos, e que alcançam recursos que a API oficial não expõe. Não há conta para solicitar nem revisão para passar. Você lê um código e já está enviando. É também por isso que o número fica em risco. Nada naquela sessão é autorizado. Os termos do WhatsApp proíbem uso automatizado ou em massa do cliente comum, e um dispositivo vinculado é o cliente comum. A conveniência e a exposição são o mesmo fato visto de dois lados. ### Como a Meta detecta isso na prática? Não procurando o nome de uma biblioteca, que é o que as pessoas supõem e por que acham que reescrever vai salvar. A detecção é comportamental, e observa o formato do tráfego. Os sinais são os que a automação produz naturalmente. A proporção entre mensagens enviadas e respostas recebidas, já que conversas reais são mais ou menos equilibradas e disparos não são. Distância no grafo de contatos, porque escrever para gente que nunca escreveu para você e não compartilha contato nenhum não se parece com uso normal. Regularidade de horário, já que humanos não enviam em intervalos constantes. E denúncias de destinatário, que pesam muito e chegam mais rápido. É por isso que um gateway que roda há um ano não é prova de segurança. É prova de que o tráfego ainda não cruzou um limiar. O limiar não depende de qual biblioteca envia a mensagem. ### Quanto custa um banimento de verdade? Mais do que a automação jamais valeu, e é essa a parte que se subestima. O número para de funcionar. Não a automação, o número. Toda conversa nele fica inalcançável, e os clientes daquelas conversas não fazem ideia de que algo aconteceu. Simplesmente param de receber resposta. Para um negócio cujo número está impresso num veículo, numa fachada, num cartão ou em milhares de notas antigas, o número está mais perto de uma linha telefônica do que de um software. O histórico vai junto. A lista de contatos construída dentro daquelas conversas também. Recursos de apelação existem e às vezes funcionam, mas são lentos e ninguém consegue prometer resultado. Para uma agência a conta é pior, porque o número que para de funcionar é de um cliente que nunca foi avisado de que esse era o mecanismo. ### Como é o caminho oficial no lugar disso? A objeção à API oficial já foi real. Significava migrar o número, o que matava o app do WhatsApp Business no celular, e nenhuma equipe pequena aceitava isso. A Coexistência eliminou essa objeção. É o modo da própria Meta para rodar o app do Business e a Cloud API no mesmo número ao mesmo tempo. A equipe continua atendendo pelo celular, as conversas e o histórico ficam onde estão, e a API fica presa àquela mesma linha. Não há dispositivo vinculado, não há sessão guardada num servidor, e não há credencial que valha a pena roubar. O custo é real e pequeno. Texto livre só funciona dentro de 24 horas da última mensagem do cliente, templates precisam de aprovação, e grupos não estão disponíveis. Em troca, o número não pode ser banido pelo mecanismo em si. - Acreditar que uma biblioteca que anuncia proteção antiban resolveu isso. A detecção observa comportamento de tráfego, não qual código envia, então a promessa descreve algo que o fornecedor não controla. - Tratar meses no ar como prova de segurança. Significa que o tráfego ainda não cruzou um limiar, que é outra afirmação. - Testar num número pessoal primeiro. Um banimento ali é chato, mas não ensina nada sobre o número do negócio, que carrega muito mais tráfego. - Guardar uma sessão não oficial num servidor compartilhado. Aquelas credenciais dão acesso total à conta e são alvo conhecido. **Meu número já está em risco se eu uso um desses?** A exposição existe enquanto a sessão estiver rodando. Nada dispara numa data fixa, e é por isso que um bom tempo no ar não tranquiliza. Migrar para a API oficial no mesmo número é possível sem perder o app. **Posso ir para a API oficial sem trocar de número?** Pode. A Coexistência conecta o número que você já usa, e o app do WhatsApp Business continua funcionando no celular o tempo todo. Nada migra. **O que a API oficial não faz?** Grupos ficam de fora em números em Coexistência. Texto livre só funciona dentro de 24 horas da última mensagem do cliente, e fora dessa janela as mensagens precisam usar um template aprovado pela Meta. **O caminho oficial custa mais?** A Meta cobra as taxas de mensagem dela de qualquer jeito, faturadas direto para você. A diferença é um valor fixo mensal por número em vez do risco de perder o número. --- ## n8n | Conectar o WhatsApp ao n8n pela Cloud API oficial https://easycoexistence.com/pt/integrations/n8n Aponte o destino do webhook para um nó Webhook do n8n e toda mensagem enviada ao número chega como disparo do fluxo. As respostas voltam pela Cloud API, ou pelo nosso servidor MCP, que o n8n consegue alcançar porque o MCP Client Tool dele suporta OAuth2. O celular continua funcionando durante todo o processo. ### Como uma mensagem do WhatsApp chega até um fluxo do n8n? A Meta entrega toda mensagem enviada ao número para uma única URL que você indica, como um HTTP POST. Essa URL é a integração inteira. Coloque um nó Webhook do n8n numa URL de produção, defina essa URL como destino do webhook do número, e o fluxo roda a cada mensagem recebida. O payload leva o remetente, o texto ou a referência da mídia, um timestamp e o id da mensagem. Daí em diante é um fluxo comum do n8n: ramifique pelo conteúdo, busque o cliente, chame o que mais você tiver rodando, e decida se vai responder. Como isso é Coexistência, a mesma mensagem também está no app do WhatsApp Business no celular. Uma pessoa pode responder. O fluxo vê o que a pessoa enviou, e a pessoa vê o que o fluxo enviou, então nenhum dos dois responde por cima do outro. ### Como o fluxo envia uma resposta? Com um nó HTTP Request contra a Cloud API, usando o phone number id e o token de acesso do número. Os dois são visíveis no painel, ou pelo conector MCP, se você preferir que um assistente busque. O que enviar depende do tempo, e é justamente aqui que as pessoas escorregam. Dentro de 24 horas da última mensagem do cliente, texto livre funciona e a resposta é o que o fluxo montou. Fora dessa janela, só passa um template que a Meta já aprovou. Um fluxo que só envia texto livre parece perfeito nos testes, porque os testes sempre acontecem segundos depois de uma mensagem, e depois emudece no primeiro caso real que atravessa a noite. O formato robusto é uma ramificação: verifique há quanto tempo chegou a última mensagem recebida e escolha texto livre ou template de acordo. ### O n8n também pode usar o conector MCP? Sim, e o n8n é incomum nisso. O nó MCP Client Tool dele conecta a um servidor MCP remoto e suporta OAuth2, que é do que o nosso precisa, então um nó AI Agent dentro de um fluxo pode chamar nossas ferramentas direto. Vale saber disso porque a maioria das plataformas de automação não consegue. Make e Zapier rodam servidores MCP próprios e nenhum dos dois age como cliente, então nenhum dos dois alcança um servidor de terceiros. O n8n alcança. Ele é bom para a metade de agir: um nó de agente que decide enviar uma mensagem, verificar a saúde de um número ou ler o status de aprovação de um template enquanto o fluxo está rodando. O que ele não faz é substituir o webhook, porque o MCP não tem como ser acordado por uma mensagem que chega. ### Qual dos dois um fluxo deve usar? Os dois, para metades diferentes, e a divisão não é questão de gosto. O webhook é como qualquer coisa começa. Um cliente escreve, a Meta entrega no seu nó Webhook, o fluxo roda. Não existe equivalente em MCP para isso em ferramenta nenhuma, porque o protocolo é requisição e resposta, e não algo que possa ser chamado de fora para dentro. O MCP Client Tool serve para um agente dentro desse fluxo agir sem que você escreva a chamada na mão. Se o fluxo já sabe exatamente o que enviar, um nó HTTP Request contra a Cloud API é mais simples e tem menos o que dar errado. Se um agente está decidindo, o conector entrega a ele as dezesseis ferramentas e as regras que vêm nas descrições delas, incluindo a janela de 24 horas. ### O que diferencia isso dos nós de WhatsApp do n8n que as pessoas já usam? A maioria das montagens de WhatsApp no n8n que você encontra por aí é construída sobre um gateway não oficial que entra como aparelho vinculado. São fáceis de começar e colocam o número em risco, porque esse mecanismo viola os termos do WhatsApp e a Meta detecta o padrão de tráfego, não a biblioteca. O outro caminho comum é a API oficial sem Coexistência, que funciona mas migra o número. O app do WhatsApp Business para de funcionar nele, e a equipe que atendia o dia inteiro tem que se mudar para uma ferramenta nova. Para a maioria das pequenas empresas isso é inviável, e é exatamente por isso que tantas delas foram parar num gateway não oficial. Coexistência é a combinação que faltava. API oficial, e o celular continua funcionando. - Usar uma Test URL do n8n como destino do webhook. Ela para de escutar quando o editor fecha, então as mensagens são entregues para o nada. - Não responder à requisição de verificação da Meta. A Meta manda um GET com um desafio antes de entregar qualquer coisa, e um nó que não devolve esse desafio nunca recebe mensagem. - Responder com texto livre fora da janela de 24 horas. Falha em silêncio do ponto de vista do fluxo, e só um template aprovado passa. **Preciso de um nó específico do n8n para isso?** Não. Um nó Webhook recebe e um nó HTTP Request envia. Não há nada para instalar, porque a integração é uma URL e uma chamada REST. **A equipe ainda pode responder pelo celular?** Sim. É isso que Coexistência significa. O app do WhatsApp Business continua funcionando no mesmo número, e o fluxo e a pessoa veem as mensagens um do outro. **Um fluxo só pode atender os números de vários clientes?** Sim. Aponte todos os números para o mesmo webhook e ramifique pelo phone number id que está recebendo, dentro do payload. Uma conta guarda quantos números você precisar. **O que acontece se a minha instância do n8n cair?** A Meta repete a entrega por um período e depois para. As mensagens continuam chegando no app do WhatsApp Business no celular, então nada se perde para a empresa, só para o fluxo. --- ## claude | Conectar o WhatsApp ao Claude com um conector personalizado https://easycoexistence.com/pt/integrations/claude Adicione https://easycoexistence.com/api/mcp como conector personalizado no Claude e faça login. A partir daí o Claude consegue listar seus números, verificar a saúde de cada um, enviar mensagens e templates, e apontar webhooks para os seus próprios sistemas, tudo pela Cloud API oficial da Meta, e não por uma sessão de aparelho vinculado. ### Como adicionar isso ao Claude? No Claude, abra as configurações e adicione um conector personalizado apontando para o endpoint MCP da EasyCoexistence. O Claude abre uma página de login, você autoriza, e as ferramentas aparecem. Não há chave para gerar nem nada para colar em arquivo de configuração, porque o conector usa OAuth. O Claude Desktop usa o mesmo conector, adicionado em Configurações, na parte de Conectores. O arquivo de configuração dele só descreve servidores locais que ele mesmo inicia, então um endpoint remoto como este não é escrito lá. De um jeito ou de outro, o servidor em si é remoto. Nada é instalado, nada roda em segundo plano no seu computador, e fechar o aplicativo não quebra coisa alguma. Um número segue conectado esteja o Claude aberto ou não. ### O que o Claude consegue fazer depois de conectado? Peça em linguagem comum e o Claude escolhe a ferramenta. Qual dos meus números está com problema. Manda a confirmação do agendamento para este cliente. Cria um template para avisos de pedido e me avisa quando a Meta aprovar. Aponta o webhook deste número para o meu servidor. As ferramentas de leitura são as que as pessoas usam todo dia sem perceber: listar números, verificar a classificação de qualidade, o nível de mensagens e o estado da conexão de um número, e puxar as credenciais quando outra coisa precisa delas. As ferramentas de envio cobrem texto livre dentro da janela de atendimento e templates aprovados fora dela. O par que mais importa para quem atende clientes é iniciar uma conexão e definir o destino do webhook. Juntos, eles significam que o Claude pode fazer o onboarding do número de um cliente e ligá-lo ao seu sistema sem ninguém abrir um painel. ### O número fica a salvo de banimento fazendo isso? Fica, e por causa do que está por baixo, não por algo específico do Claude. Os servidores MCP de WhatsApp que as pessoas costumam encontrar dirigem o WhatsApp Web como aparelho vinculado. Isso viola os termos do WhatsApp, e a Meta detecta pelo comportamento do tráfego, então o número é banido independentemente de qual assistente estava dando as instruções. Usar um assistente cuidadoso não ajuda, porque o que é proibido é o mecanismo. Este conector chama a Cloud API oficial da Meta num número que passou pelo onboarding do próprio recurso de Coexistência da Meta. Não há aparelho vinculado, nenhuma sessão guardada em lugar nenhum, e nada nisso contraria os termos. Valem os limites de sempre: texto livre só dentro de 24 horas da última mensagem do cliente, templates aprovados fora disso, e nada de conversas em grupo. **Isso funciona no Claude Code e nos aplicativos do Claude?** Sim. É um servidor MCP remoto por HTTP com OAuth, então qualquer coisa que aceite conectores personalizados pode usar, incluindo Claude Code, ChatGPT e Cursor. **O Claude enxerga as conversas dos meus clientes?** Só o que você pedir. As mensagens recebidas vão da Meta para o destino de webhook que você indicar, e nós nunca guardamos o conteúdo das conversas. **O Claude consegue conectar um número novo sozinho?** Ele consegue começar o processo. O conector devolve um link que o dono da empresa abre para autorizar o próprio número pelo fluxo da Meta, que é um passo que só ele pode concluir. **O que acontece se o Claude tentar enviar fora da janela?** A Cloud API recusa e o Claude vê o erro, então ele pode recorrer a um template aprovado. Nada é descartado em silêncio. --- ## Cloud API do WhatsApp ou Coexistência: qual o número precisa https://easycoexistence.com/pt/whatsapp-cloud-api-vs-coexistence A Coexistência não é alternativa à Cloud API, é um jeito de entrar nela. Um número de Cloud API comum pertence inteiramente ao software. Um número em Coexistência roda a API e o app do WhatsApp Business ao mesmo tempo, então a equipe continua atendendo pelo celular. ### Cloud API e Coexistência são coisas diferentes mesmo? Não, e esse enquadramento confunde as pessoas. A Cloud API é a WhatsApp Business Platform hospedada pela Meta. A Coexistência é um modo de conectar um número àquela mesma API, um modo que deixa o app do WhatsApp Business funcionando no número depois. Então os endpoints são os mesmos, o formato de mensagem é o mesmo, templates funcionam igual e a janela de 24 horas se aplica do mesmo jeito. Qualquer coisa escrita contra uma funciona contra a outra. O que muda é o que acontece com o celular. Conecte um número do jeito comum e o app do Business para de funcionar nele: o número agora pertence ao software, e quem atendia passa a atender pelo que foi construído. Conecte por Coexistência e as duas pontas ficam vivas, cada uma vendo o que a outra manda. ### Quando a Cloud API comum é a melhor escolha? Quando ninguém precisa responder à mão naquele número, o que é mais comum do que parece. Um número de notificações que só envia atualização de pedido não tem lado humano a preservar. Um número novo comprado especificamente para uma integração nunca esteve no app de ninguém. Uma linha de suporte de alto volume já rodando por um helpdesk tem o fluxo humano em outro lugar, e colocar o app do WhatsApp Business no meio fragmentaria isso. Nesses casos a Coexistência acrescenta restrição sem contrapartida: o throughput num número em Coexistência é fixado pela Meta em vez de crescer com qualidade e nível de mensageria, e a exigência de atividade periódica no aparelho é uma obrigação de manutenção que você assumiria sem ganho nenhum. ### Quando a Coexistência é a única opção que funciona? Quando o número já carrega um negócio e já tem alguém atendendo nele. Isso cobre a maioria das empresas pequenas, e praticamente todo número que uma agência herda. O número está impresso num veículo, numa fachada, em notas fiscais e num site. Alguém atende pelo celular durante o dia e conhece cada cliente pelo nome. Dizer a essa pessoa que o app vai parar de funcionar encerra a conversa, e é por isso que tantos negócios acabaram em gateways não oficiais em vez da API oficial. A Coexistência foi o que eliminou esse custo. O app continua funcionando, a equipe não aprende nada novo, e o software ganha a mesma API que ganharia de qualquer forma. ### Um número pode mudar entre as duas depois? Um número pode ser desconectado e reconectado, então a decisão não é permanente do jeito que as pessoas temem. O que é permanente é a escolha do histórico de conversas. Quando um número conecta pela primeira vez por Coexistência, a Meta pergunta se deve compartilhar as conversas existentes com a API. Essa é uma decisão única de onboarding e não pode ser revista depois. Se você recusar e mais tarde quiser o contexto, o único caminho é desconectar e conectar de novo. Então a escolha que merece cuidado não é em que modo conectar. É dizer sim ao histórico no dia, porque essa é a que não volta a aparecer. - Tratar a Coexistência como API menor. É a mesma Cloud API, por um onboarding diferente, com os mesmos endpoints e as mesmas regras. - Escolher Coexistência para um número que ninguém atende à mão. Acrescenta obrigação de atividade no aparelho e teto fixo de throughput em troca de um fluxo de celular que não existe. - Recusar o histórico no onboarding esperando acrescentar depois. Essa escolha é feita uma vez e não muda. **A Coexistência é mais lenta que a Cloud API comum?** O throughput num número em Coexistência é fixado pela Meta em vez de crescer com classificação de qualidade e nível de mensageria. Para uso conversacional esse teto raramente é o limite, mas para envio de alto volume pode ser. **Templates funcionam igual nas duas?** Sim. Templates são submetidos à Meta para revisão e enviados pela API de forma idêntica. Num número em Coexistência o app do celular não consegue enviá-los, então tudo fora da janela de 24 horas passa pela API. **Posso colocar um número novo em Coexistência?** Ele precisa estar registrado no app do WhatsApp Business antes, já que a Coexistência conecta um número que o app já usa. Para um número que ninguém vai atender à mão, o onboarding comum de Cloud API encaixa melhor. **Qual as agências usam para números de cliente?** Coexistência, quase sempre. O número do cliente é um que a equipe dele já atende, e migrar tiraria o app do WhatsApp Business das mãos deles, o que nenhum cliente aceita. --- ## Erro 131047 do WhatsApp: mensagem de reengajamento https://easycoexistence.com/pt/docs/whatsapp-error-131047 O erro 131047 significa que passaram mais de 24 horas desde a última mensagem daquele cliente, então a janela de atendimento fechou e texto livre não vai entregar. Só um template já aprovado pela Meta reabre a conversa. ### O que causa o erro 131047? Uma mensagem de texto livre enviada para alguém cuja última mensagem para você tem mais de 24 horas. A WhatsApp Business Platform só permite que um negócio escreva livremente dentro de uma janela de atendimento, e essa janela abre quando o cliente manda mensagem e dura 24 horas. Dentro dela você envia o que quiser. Fora dela, a API rejeita texto livre com 131047 em vez de entregar algo que o destinatário não pediu. O motivo de isso aparecer em produção e não em teste é o tempo. Quem testa uma integração envia uma mensagem e responde segundos depois, o que está sempre dentro da janela. O primeiro caso de um dia para o outro, ou o primeiro cliente que some por um dia, é quando o erro aparece. ### Como corrigir? Envie um template aprovado no lugar do texto livre. Templates são mensagens que você submete à Meta antes e que a Meta revisa. Uma vez aprovado, um template pode ser enviado a qualquer momento, inclusive para quem nunca escreveu para você. Enviar um reabre a conversa, e no instante em que o cliente responde você tem 24 horas novas de texto livre. Então a correção duradoura não é repetir. É uma ramificação: antes de enviar, verifique há quanto tempo aquele contato mandou mensagem. Dentro de 24 horas, texto livre. Fora, o template que couber na situação. Uma integração que só sabe enviar texto livre vai bater nisso sempre, e para quem acompanha a conversa vai parecer silêncio, não erro. ### Isso vale num número em Coexistência? Vale, e com uma consequência extra que merece atenção. A janela funciona igual, tenha o número entrado por Coexistência ou não, porque é regra da plataforma e não do modo de onboarding. O que muda é quem pode agir. Num número em Coexistência o app do WhatsApp Business não envia templates, então tudo que estiver fora da janela precisa passar pela API. Isso significa que uma equipe atendendo pelo celular responde livremente numa conversa viva, mas não consegue reiniciar uma conversa fria pelo app. Reiniciar é trabalho de API, e essa é uma das razões práticas para um negócio conectar o número. - Repetir a mesma mensagem de texto livre. A janela não reabre sozinha, então a repetição falha igual. - Medir a janela a partir da sua última mensagem em vez da dele. É a mensagem dele que abre. - Achar que dá para escrever e enviar um template no mesmo momento. A Meta revisa antes, normalmente em minutos, às vezes em um dia. **Dá para estender a janela de 24 horas?** Não. Ela é fixada pela Meta e nenhum provedor consegue aumentar. A única coisa que reabre é o cliente escrever de novo. **O cliente responder a um template reabre?** Sim. Qualquer mensagem do cliente começa 24 horas novas, inclusive uma resposta a um template que você mandou. **Qual categoria de template usar?** Utility para transacional, marketing para promocional. Envios de marketing exigem um meio de pagamento na sua própria conta do WhatsApp Business. **O erro 131047 é o mesmo que o 131049?** Não. O 131047 é a janela fechada. O 131049 é a Meta limitando entrega para proteger a saúde do ecossistema, que é outra condição. --- ## Erro 131049 do WhatsApp: mensagem bloqueada pela saúde do ecossistema https://easycoexistence.com/pt/docs/whatsapp-error-131049 O erro 131049 significa que a Meta escolheu não entregar esta mensagem para manter o engajamento saudável no ecossistema. Não é a janela de 24 horas e não é problema de template. A orientação da Meta é esperar pelo menos 24 horas antes de tentar aquele destinatário de novo. ### O que engajamento de ecossistema quer dizer aqui? É o termo da Meta para se as pessoas do lado que recebe acolhem bem o que os negócios mandam, medido na plataforma inteira e não só na sua conta. Quando a plataforma julga que um envio específico não seria bem-vindo, ela bloqueia aquela mensagem e devolve 131049. É um julgamento sobre a mensagem e o destinatário, não uma regra fixa que você quebrou, e é por isso que aparece em conta cuja classificação de qualidade parece boa. Surge mais em envios de marketing para quem não engajou, e em volumes altos de mensagens parecidas saindo juntas. É um sinal sobre o padrão, não uma punição aplicada ao número. ### Por que enviar um template não resolve? Porque o template nunca foi o problema. O instinto depois de ver um envio bloqueado é recorrer a um template, já que essa é a solução da outra falha comum, o 131047. Mas o 131047 é uma regra sobre tempo: a janela fechou, e um template aprovado é o jeito autorizado de reabrir. O 131049 é uma decisão sobre esta mensagem específica para esta pessoa específica, e a rota do template é o mesmo caminho de entrega. Repetir na hora, com template ou sem, tende a reforçar o padrão que disparou aquilo. A orientação da própria Meta é esperar pelo menos 24 horas antes de tentar aquele destinatário de novo, e olhar se a mensagem era algo que ele provavelmente queria. ### Como evitar que aconteça de novo? Mudando o que é enviado, não como é enviado. Envie para quem engajou recentemente em vez de para a lista inteira. Varie o conteúdo, já que mensagens quase idênticas saindo em volume é o padrão que isso observa. Prefira mensagens utilitárias ligadas a algo que o cliente fez, como um pedido ou um agendamento, no lugar de promoção em massa. Vale também acompanhar classificação de qualidade e nível de mensageria juntos, porque eles se movem pelo mesmo motivo de fundo: destinatários reagindo mal. Um número escorregando em qualidade normalmente vê mais disso antes de ver algo mais sério. Pegar essa queda cedo é a diferença entre ajustar e ser limitado. - Tratar como a janela de 24 horas e trocar por template. Condição diferente, mesmo resultado. - Repetir na hora. A orientação da Meta é esperar pelo menos 24 horas para aquele destinatário. - Ler como banimento. O número está funcionando; foi esta mensagem que não foi entregue. **Meu número foi banido?** Não. O 131049 bloqueia uma mensagem. O número segue funcionando e outros envios podem dar certo. **Quanto tempo devo esperar?** A orientação da Meta é pelo menos 24 horas antes de reenviar para aquele destinatário. Não há número exato publicado. **Isso afeta minha classificação de qualidade?** É um sinal da mesma medida de fundo, então ver isso com frequência vale ser tratado como aviso precoce sobre qualidade, e não como erro isolado. **Um provedor consegue contornar?** Não. É aplicado pela Meta na entrega, então todo provedor na API oficial vê o mesmo comportamento. --- ## Erro 131048 do WhatsApp: limite de spam atingido https://easycoexistence.com/pt/docs/whatsapp-error-131048 O erro 131048 significa que a Meta está restringindo envios deste número porque a qualidade dele caiu, normalmente depois de destinatários bloquearem ou denunciarem mensagens. O número continua funcionando. O que mudou é quanto ele pode enviar enquanto a qualidade se recupera. ### O que faz a qualidade de um número cair? Destinatários reagindo mal, o que a Meta mede em vez de deduzir do seu código. Os sinais são bloqueios, denúncias e, mais discretamente, pessoas simplesmente não respondendo a mensagens que esperavam resposta. Um número que envia muito e recebe pouco de volta parece diferente de um que mantém conversas, e a diferença se acumula na classificação de qualidade. A classificação passa por verde, amarelo e vermelho. Vermelho é onde os envios começam a falhar com este erro. Nada desse movimento é anunciado no celular, e o app do WhatsApp Business continua funcionando normalmente o tempo todo, e é por isso que o primeiro sinal para a maioria dos negócios é um envio falhando, não um aviso. ### Como um número se recupera? Sozinho, se o envio que causou a queda parar. Qualidade é uma medida móvel. Conforme os envios recentes recebem reações melhores, a classificação sobe de volta, e o limite se afrouxa junto. Não há recurso a protocolar nem interruptor que um provedor possa acionar, o que também significa que ninguém consegue te vender uma solução para isso. O que ajuda de fato é estreitar para quem se manda. Envie para quem engajou recentemente. Prefira mensagens utilitárias ligadas a algo que o cliente fez a promoção em massa. Corte tudo que vai para uma lista em vez de para uma pessoa. O padrão que derrubou a classificação é o mesmo que a mantém baixa, então a recuperação começa quando esse padrão muda. ### Como saber antes de falhar? Só acompanhando a própria classificação, e é por isso que este é o argumento mais claro para vigiar uma conexão em vez de só conectá-la. A Meta expõe classificação de qualidade e nível de mensageria no número de telefone, e isso muda antes de te custar algo. Um número indo de verde para amarelo é um aviso com tempo ainda sobrando. Um número que chega a vermelho e começa a devolver este erro já perdeu envios, e a essa altura as mensagens afetadas se foram em vez de ficarem em fila. Nada da queda aparece no app do WhatsApp Business, então uma equipe atendendo pelo celular vê tudo normal até o instante em que os envios param. - Ler como bug no código de envio. A requisição está bem; o número é que está limitado. - Trocar de provedor para escapar. A classificação pertence ao número e vai junto. - Esperar uma notificação. Nada anuncia uma queda de qualidade no celular. **Ainda consigo receber mensagens?** Sim. Receber não é afetado, e o app do WhatsApp Business segue funcionando normalmente no número. **Quanto tempo leva a recuperação?** A Meta não publica um número. É uma medida móvel, então melhora conforme o envio recente melhora, e não depois de um período fixo. **Mudar de provedor zera isso?** Não. A qualidade está ligada ao número de telefone, não a quem envia por ele. **É a mesma coisa que ser banido?** Não. Um banimento tira o número. Isto limita quanto um número em funcionamento pode enviar até a qualidade se recuperar. --- ## Erro 132001 do WhatsApp: o template não existe https://easycoexistence.com/pt/docs/whatsapp-error-132001 O erro 132001 significa que o template que você tentou enviar não existe no idioma que você pediu, ou existe mas não está aprovado. Os templates são identificados por nome e idioma juntos, então o mesmo nome em outro locale é outro template. ### Por que um template que existe ainda devolve 132001? Quase sempre por causa do código de idioma. Um template é identificado pelo seu nome e pelo seu idioma juntos. Um template criado como order_update em en_US não existe como order_update em en, nem em pt, nem em pt_BR. Enviar o nome certo com o locale errado produz exatamente esse erro, e a mensagem é irritantemente genérica sobre qual das duas metades estava errada. A segunda causa é o estado de aprovação. Um template que foi criado mas ainda está em revisão não envia, e um que foi rejeitado também não. Os dois devolvem o mesmo código de um template que nunca foi criado, então vale conferir o estado antes de concluir que o nome está errado. ### Como descobrir o nome e o idioma certos? Liste os templates do número e leia o que voltou, em vez de confiar no que foi configurado. A listagem entrega o nome exato, o código de idioma exato e o status de revisão de cada um, o que resolve as três causas desse erro de uma vez. Ela também é a única fonte confiável, porque um template pode ser editado ou rejeitado depois que alguém ou algo anotou o nome dele. Pelo conector MCP isso é uma pergunta, e não uma chamada de API: pergunte quais templates estão aprovados em um número e o assistente lê para você. Do seu próprio código é uma única requisição ao Graph contra a WhatsApp Business Account, usando o phone number id e o token daquela conexão. ### Quanto tempo leva a aprovação? Normalmente minutos, às vezes até um dia. A Meta revisa todo template antes que ele possa ser enviado. A maioria passa rápido, mas o prazo não é garantido e não é algo que um provedor consiga acelerar. Isso importa para qualquer coisa construída para criar um template e enviá-lo em seguida, porque o envio vai falhar com esse erro enquanto a revisão ainda estiver pendente. O formato robusto é criar os templates com antecedência, como parte da montagem da integração, e conferir o status antes de depender de um deles. Um assistente com o conector faz as duas coisas: envia o template e depois informa se ele foi aprovado, rejeitado ou se ainda está em revisão. - Enviar en quando o template foi criado como en_US. Para a API eles são templates diferentes. - Criar um template e enviá-lo na mesma execução. A Meta revisa ele primeiro. - Achar que um template rejeitado ainda funciona. Ele devolve esse erro exatamente como um que não existe. **Onde eu vejo o código de idioma exato?** Na listagem de templates daquele número. Ela mostra nome, idioma e status juntos, e é a única fonte confiável. **Posso enviar um template pendente?** Não. Só templates aprovados entregam, e um pendente devolve esse mesmo erro. **Um template rejeitado precisa ser recriado?** Ele pode ser editado e reenviado para revisão. O que ele não consegue é enviar enquanto estiver no estado de rejeitado. **O app do WhatsApp Business envia templates?** Não em um número em Coexistência. Os templates passam pela API, que é uma das razões práticas para conectar um número. --- ## Erro 132000 do WhatsApp: número de parâmetros divergente https://easycoexistence.com/pt/docs/whatsapp-error-132000 O erro 132000 significa que as variáveis que você forneceu não batem com o que o template espera. Um template com dois marcadores precisa de exatamente dois valores, na ordem. Ele costuma aparecer depois que alguém edita um template e o código de envio não é atualizado junto. ### Como as variáveis de um template são contadas? Por componente, na ordem, usando os marcadores numerados no texto do template. Um corpo de template que diz Olá {{1}}, seu pedido {{2}} foi enviado define duas variáveis, e um envio precisa fornecer exatamente dois valores para o componente de corpo. Fornecer um, ou três, devolve esse erro. Fornecer dois, mas no componente errado, também devolve, porque os parâmetros de cabeçalho, de corpo e de botão são contados separadamente, e não juntos numa lista só. É por isso que o erro parece equivocado à primeira vista: o total de valores pode estar certo enquanto a distribuição entre os componentes está errada. ### Por que ele aparece num template que funcionava ontem? Porque alguém editou o template e o código de envio não mudou junto. Templates podem ser editados depois de aprovados, e adicionar ou remover um marcador muda o contrato silenciosamente do ponto de vista de quem envia. Nada avisa a integração, e o envio seguinte falha. Num time em que o marketing edita templates no WhatsApp Manager e a engenharia é dona do código de envio, essa é a forma mais comum de esse erro aparecer. A defesa é ler o template de volta, em vez de confiar em um valor anotado quando ele foi construído pela primeira vez. Listar os templates devolve a definição atual, que é a única versão que importa na hora do envio. ### Como fornecer os valores corretamente? Montando o array de componentes para bater com a estrutura do próprio template. Cada componente nomeia o seu tipo e carrega os seus próprios parâmetros na ordem em que os marcadores aparecem. Um corpo com duas variáveis recebe um componente de corpo com dois parâmetros de texto. Um template que também tem uma variável no cabeçalho recebe igualmente um componente de cabeçalho, com o parâmetro dele, em vez de o valor do cabeçalho ser jogado na lista do corpo. Pelo conector MCP isso fica um passo distante de você: um assistente lê o template, vê quantos marcadores cada componente tem e preenche a partir do que você pediu. No seu próprio código, vale ler a definição do template na inicialização, em vez de fixar no código um formato que pode mudar. - Juntar as variáveis de cabeçalho e de corpo numa lista só. Elas são contadas por componente. - Fixar no código uma quantidade de variáveis. Uma edição do template muda isso sem avisar quem envia. - Mandar uma string vazia para um marcador que não se usa. O template continua definindo ele, então a contagem tem de bater. **Posso enviar um template sem variáveis?** Pode. Se o template não define nenhuma, não envie parâmetros. Mandar mesmo assim devolve esse erro. **A ordem dos valores importa?** Sim. Os marcadores são numerados e preenchidos na ordem, então trocar dois valores produz uma mensagem errada em vez de um erro. **Por que o mesmo envio funciona num idioma e no outro não?** Cada versão de idioma é um template separado e pode ter uma quantidade diferente de marcadores depois de uma edição. **Isso é o mesmo que o 132001?** Não. O 132001 quer dizer que o template não foi encontrado ou não está aprovado. O 132000 quer dizer que ele foi encontrado e as variáveis não bateram. --- ## Erro 2593107 do WhatsApp: limite de sincronização excedido https://easycoexistence.com/pt/docs/whatsapp-error-2593107 O erro 2593107 significa que esse número já usou a sua única sincronização de contatos e histórico de conversas. A sincronização roda uma vez por onboarding e não pode ser repetida, então a única forma de rodar de novo é desconectar o número e conectar outra vez. ### Que sincronização é essa? É a etapa que leva os contatos existentes e o histórico de conversas de um número em Coexistência para o lado da API, para que o software não comece cego em um número que a empresa usa há anos. Isso só existe por causa da Coexistência. Um número integrado da forma comum não tem histórico anterior no app para trazer, e não há nada para sincronizar. Um número em Coexistência tem as duas coisas, e a Meta oferece uma transferência única delas no momento em que o número conecta. É também por isso que o erro é desconhecido até para quem trabalha com a Cloud API há muito tempo. Ele pertence a um modo de onboarding que essas pessoas nunca usaram. ### Por que ela só pode rodar uma vez? Porque faz parte do onboarding e não é um recurso contínuo, e a Meta trata isso como uma decisão única tomada no momento da conexão. O dono do negócio é perguntado durante o Embedded Signup se quer compartilhar o histórico de conversas existente. Responder que sim é o que permite a sincronização rodar. Não existe uma configuração para religar isso depois nem um endpoint que repita a operação, e é por isso que uma segunda chamada devolve esse erro, em vez de um limite de taxa que passa. A consequência prática é que a escolha pesa mais do que parece na hora. Quem clica rápido pelo onboarding e recusa o histórico porque recusar parece mais seguro tomou uma decisão que só uma desconexão e reconexão completas conseguem rever. ### E se você realmente precisar dela de novo? O número tem de ser desconectado e conectado outra vez, o que é uma operação de verdade e não uma configuração. Reconectar roda o Embedded Signup do começo, incluindo a leitura do código no celular, e dá uma nova oportunidade de aceitar o histórico. O app do WhatsApp Business não é afetado em nenhum momento, então a empresa não perde nada, mas também não é uma ação silenciosa de bastidor: alguém precisa estar com o celular na mão. Há uma consequência que vale planejar. Uma desconexão remove o destino do webhook, porque esse destino vive como um override em uma assinatura de app e não no número. Reconectar restaura o envio e o monitoramento, mas não a entrega no seu próprio servidor, a menos que algo recoloque isso. - Repetir a chamada de sincronização. É um evento único, então a repetição devolve o mesmo erro em vez de acabar dando certo. - Recusar o histórico de conversas durante o onboarding por precaução. Essa escolha só pode ser revista reconectando o número. - Reconectar sem planejar restaurar o destino do webhook, que é desinstalado junto com o app. **Isso acontece em um número comum da Cloud API?** Não. A sincronização existe só para números em Coexistência, porque só eles têm histórico anterior no app para trazer. **Quanto histórico é sincronizado?** A Meta sincroniza uma janela de histórico recente de conversas no onboarding. O tamanho exato é definido pela Meta, e não por um provedor. **Reconectar vai perder minhas conversas no celular?** Não. O app do WhatsApp Business e as conversas dele não são tocados ao desconectar e reconectar o lado da API. **O 2593108 é o mesmo problema?** Não. Aquele significa que a sincronização foi tentada mais de 24 horas depois do onboarding, e não que ela já rodou. --- ## Erro 2593108 do WhatsApp: sincronização fora da janela de 24 horas https://easycoexistence.com/pt/docs/whatsapp-error-2593108 O erro 2593108 significa que a sincronização de contatos e histórico de conversas foi iniciada mais de 24 horas depois de o número ter passado pelo onboarding. Essa janela é fixada pela Meta, e depois que ela passa a única forma de sincronizar é conectar o número de novo. ### De que janela de 24 horas estamos falando? Não é a de mensagens, e é daí que vem quase toda a confusão em torno desse erro. A WhatsApp Business Platform tem uma janela de atendimento de 24 horas bastante conhecida, contada a partir da última mensagem do cliente, que determina se é possível enviar texto livre. Este é um relógio completamente diferente. Ele conta a partir do momento em que um número em Coexistência concluiu o onboarding, e determina apenas se os contatos e o histórico de conversas ainda podem ser trazidos. Os dois não têm nada a ver um com o outro além do número, e uma mensagem enviada com sucesso não é indício nenhum de que a janela de sincronização continua aberta. ### Por que ela passa despercebida? Porque o onboarding e a integração costumam acontecer em dias diferentes, e muitas vezes com pessoas diferentes. Uma sequência típica é o dono do negócio conectar o número à tarde e uma agência ou um desenvolvedor ligar isso aos sistemas dele mais adiante na mesma semana. Quando alguém enfim pensa no histórico, a janela já fechou, e a falha chega como um código de erro desconhecido em vez de como um aviso. Vale tratar a sincronização como parte do onboarding, e não como parte da integração. Se o histórico importa de alguma forma, ele tem de ser puxado no mesmo dia em que o número conecta, antes de qualquer outra coisa ser construída. ### Quais são as opções depois que ela fecha? Desconectar e conectar o número de novo, ou aceitar começar sem histórico. Reconectar reinicia o Embedded Signup, incluindo a leitura no celular, e abre uma janela nova. Nada no app do WhatsApp Business é afetado, então a empresa mantém as conversas dela de qualquer jeito. O que isso custa é alguém estar de novo com o celular na mão. Começar sem histórico costuma ser tranquilo. A API recebe tudo a partir do momento em que é conectada, e a maioria das integrações se importa com conversas novas, não com as antigas. O histórico importa mais quando algo precisa consultar o contexto passado de um cliente na hora, o que é um caso mais restrito do que parece à primeira vista. - Confundir isso com a janela de mensagens. São relógios separados medindo coisas diferentes. - Deixar o histórico para quando o trabalho de integração começar. A essa altura a janela já costuma estar fechada. - Reconectar sem restaurar o destino do webhook, que não sobrevive a uma desconexão. **Essas 24 horas são as mesmas da janela de mensagens?** Não. Estas contam a partir do onboarding e governam a sincronização. A janela de mensagens conta a partir da última mensagem do cliente e governa o texto livre. **A janela pode ser estendida?** Não. Ela é definida pela Meta e nenhum provedor consegue alongar. **Reconectar custa alguma coisa?** Nada é cobrado pela reconexão. O custo é alguém estar presente junto ao celular para ler o código de novo. **E se eu nunca sincronizar o histórico?** A API continua recebendo tudo a partir do momento em que o número conecta. O histórico só importa se algo precisa do contexto passado na hora. --- ## Erro 131026 do WhatsApp: mensagem não entregável https://easycoexistence.com/pt/docs/whatsapp-error-131026 O erro 131026 significa que a Meta não conseguiu entregar àquele destinatário. A causa comum é o número não estar registrado no WhatsApp, embora um cliente desatualizado ou termos que o usuário não aceitou produzam o mesmo código. ### Por que um número aparentemente válido não entrega? Porque ter um número de telefone não é a mesma coisa que ter WhatsApp nele. A causa mais comum de longe é o destinatário nunca ter registrado aquele número no WhatsApp, ou ter removido desde então. Nada no formato do número revela isso, e é por isso que uma lista importada de um CRM produz esses erros em volume: ela contém números de telefone, e só alguns deles são números de WhatsApp. Duas causas menos comuns produzem o mesmo código. O destinatário pode estar num cliente de WhatsApp velho demais para receber o tipo de mensagem enviado, e pode não ter aceitado termos que um recurso mais novo exige. As duas estão fora do que quem envia controla. ### O que deve acontecer quando você recebe esse erro? Registre no contato e pare de enviar para aquele número, em vez de repetir. A condição mora do lado do destinatário, então uma repetição imediata produz o mesmo resultado e uma repetição agendada normalmente também. Tratar como transitório é como uma integração acaba queimando throughput em números que nunca vão receber nada. A resposta mais útil é marcar o contato como inalcançável no WhatsApp e encaminhar a pessoa para outro canal, o que também é o que impede uma lista de contatos de se degradar em silêncio ao longo do tempo. Se o número realmente estiver no WhatsApp, a correção pertence ao destinatário, não a você. - Repetir em agenda. A condição está do lado do destinatário e não some porque o tempo passou. - Ler como problema de formatação. O número chegou à Meta e foi recusado na entrega, não na validação. - Enviar para uma lista de CRM sem filtrar. Um número de telefone não é necessariamente um número de WhatsApp. **Dá para checar antes se um número está no WhatsApp?** Não de forma confiável, e a Meta não oferece consulta para isso. Na prática o primeiro envio é a checagem. **Isso afeta minha classificação de qualidade?** Destinatários inalcançáveis não são o mesmo que destinatários que bloqueiam ou denunciam, mas enviar pesado para uma lista cheia deles é o tipo de padrão que acaba aparecendo em outro lugar. **O formato do número é o problema?** Normalmente não. Números malformados devolvem erro de parâmetro. Este código significa que o número foi entendido e não pôde ser alcançado. **Devo remover o contato?** Marque como inalcançável no WhatsApp em vez de apagar. A pessoa pode registrar aquele número depois. --- ## Erro 131042 do WhatsApp: problema de pagamento na conta https://easycoexistence.com/pt/docs/whatsapp-error-131042 O erro 131042 significa que a Meta não consegue cobrar pelas mensagens porque a conta do WhatsApp Business não tem meio de pagamento funcionando. Essas cobranças são faturadas pela Meta direto para você, então a correção está no WhatsApp Manager e não com quem fornece seu acesso à API. ### Quem está cobrando de quem, afinal? Duas empresas, e só uma das contas tem a ver com o seu provedor. A Meta cobra pelas conversas na WhatsApp Business Platform, e cobra no meio de pagamento anexado à sua própria conta do WhatsApp Business. Essa relação é entre você e a Meta. Um provedor fica ao lado, cobrando pelo acesso e pelas ferramentas, e nunca vê aquelas cobranças de conversa. É por isso que o erro não se resolve entrando em contato com o provedor, e por que ninguém nessa posição consegue cadastrar um cartão em seu nome. Significa também que o custo da conversa não pode receber margem de um provedor que nunca o recebe. ### Onde o meio de pagamento é definido? No WhatsApp Manager, na conta do WhatsApp Business dona do número. Você adiciona ou atualiza um meio de pagamento lá, e a conta precisa ter um antes de certos envios funcionarem. Envios de template de marketing em particular exigem, e é por isso que o erro costuma aparecer na primeira vez que alguém tenta um envio promocional numa conta que só respondeu clientes até então. A API deliberadamente não faz isso. Não existe endpoint para anexar cartão, por desenho, porque é uma relação comercial de nível de conta e não uma operação de mensageria. - Pedir ao provedor para resolver. A relação de cobrança é entre você e a Meta, e nenhuma API anexa cartão. - Achar que a taxa do provedor cobre os custos de mensagem. São contas separadas de empresas separadas. - Tentar templates de marketing numa conta sem meio de pagamento. A Meta exige um para esses envios. **A EasyCoexistence pode pagar a Meta por mim?** Não. As cobranças vão para o meio de pagamento da sua própria conta do WhatsApp Business, e não existe API para anexar um. **Por que isso apareceu só agora?** Muitas vezes porque o primeiro envio de template de marketing foi tentado. A Meta exige meio de pagamento especificamente para esses. **Isso para as mensagens que chegam?** Receber não é afetado. O que falha é o envio pelo qual a Meta precisa cobrar. **Tem como evitar as cobranças da Meta por completo?** Respostas dentro da janela de atendimento de 24 horas são gratuitas. O que a Meta cobra são as conversas abertas fora dela. --- ## Erro 133010 do WhatsApp: número de telefone não registrado https://easycoexistence.com/pt/docs/whatsapp-error-133010 O erro 133010 significa que o número de telefone não concluiu o registro na WhatsApp Business Platform. Ele pode estar vinculado à conta e visível no painel, mas enquanto o registro não terminar ele não consegue enviar nada. ### O que é o registro, exatamente, aqui? É a etapa final que torna um número utilizável para envio, separada do fato de o número existir na WhatsApp Business Account. O onboarding vincula um número a uma conta e entrega os identificadores dele. O registro é o que avisa a plataforma que o número está pronto para operar, e é a etapa que as pessoas pulam sem perceber, porque a essa altura o painel já mostra o número. Tudo parece conectado, e o primeiro envio falha. Num número em Coexistência isso passa batido por outro motivo: o app do WhatsApp Business no celular continua funcionando perfeitamente o tempo todo, então nada no dia a dia da empresa sugere que exista algo incompleto. ### Como o onboarding acaba ficando incompleto? Quase sempre porque alguém fechou a janela. O Embedded Signup da Meta roda como um popup e tem várias etapas, incluindo a leitura de um código no celular. Fechar depois que o número aparece mas antes de o fluxo terminar deixa exatamente esse estado. Perder o celular no meio do caminho também deixa, assim como uma sessão que expira enquanto alguém vai buscar o aparelho. A correção é rodar o fluxo de novo, e não repetir o envio. Reconectar retoma desde o começo e conclui o registro, e nada no número ou no app do WhatsApp Business é prejudicado por passar por isso duas vezes. - Repetir o envio. O registro não se conclui porque uma mensagem foi tentada. - Achar que um número visível é um número funcionando. Ele pode estar vinculado à conta e ainda assim não registrado. - Diagnosticar pelo celular. O app do WhatsApp Business funciona normalmente tendo o registro terminado ou não. **O número foi perdido?** Não. Rodar o fluxo de onboarding da Meta de novo conclui o registro, e o app do WhatsApp Business não é afetado em nenhum momento. **Dá para registrar pela API?** O registro faz parte do fluxo de onboarding da Meta, que precisa de um navegador e do celular. Não existe atalho de API que contorne a leitura do código. **Por que eu ainda consigo receber mensagens?** Receber e enviar não dependem da mesma etapa, então um número parcialmente integrado pode parecer vivo visto do celular. **Isso é o mesmo que o 133006?** Não. O 133006 quer dizer que o número precisa de verificação antes de o registro poder acontecer. Este quer dizer que o próprio registro nunca foi concluído. --- ## Erro 190 do WhatsApp: token de acesso expirado https://easycoexistence.com/pt/docs/whatsapp-error-190 O erro 190 significa que o token de acesso usado na requisição expirou ou foi invalidado. Todas as chamadas falham igual, o que dá a impressão de que o número desapareceu. Ele não desapareceu: a credencial quebrou, e o número costuma estar bem. ### Por que um token expirado parece um número perdido? Porque todas as requisições falham, e todas falham da mesma maneira. Ler o número, checar a saúde dele, listar templates e enviar uma mensagem param de funcionar ao mesmo tempo. De fora, isso é indistinguível de o número ter sido removido da conta, e uma integração com uma credencial só não tem como separar as duas situações. Muita gente conclui que foi desconectada quando nada disso aconteceu. A diferença importa porque as respostas são opostas. Uma credencial quebrada é substituída. Um número removido precisa ser reconectado, o que exige o dono do negócio e o celular. ### Como saber qual dos dois é? Tendo uma segunda credencial capaz de ler a mesma conta. A EasyCoexistence guarda o token do cliente e o próprio token de System User dela em cada conexão. Quando um é recusado, o outro lê a WhatsApp Business Account e resolve qual dos dois realmente quebrou. Um token do cliente recusado com uma segunda leitura funcionando significa que a credencial expirou e que o número está saudável. Os dois falhando significa que algo aconteceu com o próprio número. Sem esse segundo leitor, a única forma de distinguir é pedir ao dono do negócio que verifique, que é exatamente o tipo de interrupção que o monitoramento deveria evitar. ### Como os tokens são invalidados? De várias formas, e a maioria delas não é deliberada. Tokens têm tempo de vida e expiram sozinhos. Uma troca de senha na conta Meta invalida eles. Alguém removendo o acesso de um app nas Configurações do Negócio faz o mesmo, assim como a Meta revogando um token que ela considera comprometido. Nenhuma dessas coisas dá um aviso antes, e nenhuma delas é visível pelo app do WhatsApp Business no celular. É por isso que a validade do token pertence ao monitoramento, e não a um tratador de erros. Quando um tratador de erros vê isso, envios já falharam. - Reconectar o número. Se o problema é o token, reconectar pede ao dono do negócio um trabalho que nunca foi necessário. - Tratar como intermitente e repetir. Um token invalidado não se recupera sozinho. - Depender de uma credencial só. Com um token único não há como separar uma falha de credencial de um número perdido. **O número ainda funciona?** Em geral sim. O app do WhatsApp Business não é afetado e o número em si está intacto. O que parou foi o acesso pela API. **O erro 0 é a mesma coisa?** Na prática sim. A Meta reporta essa condição sob os dois códigos, dependendo do endpoint. **Reconectar resolve?** Resolveria, mas é a resposta pesada para um problema leve, e exige o dono do negócio e o celular para algo que uma credencial nova resolve. **Dá para fazer um token não expirar?** Tokens de System User podem ser de vida longa, o que é parte do motivo de guardar um segundo token ser útil. --- ## Erro 130429 do WhatsApp: limite de throughput atingido https://easycoexistence.com/pt/docs/whatsapp-error-130429 O erro 130429 significa que o limite de throughput da Cloud API para esse número foi atingido. É um problema de ritmo, e não de volume: as mesmas mensagens enviadas mais devagar passam. Em um número em Coexistência o teto é fixado pela Meta. ### O que está sendo limitado, na prática? A velocidade com que as mensagens saem, e não quantas você pode enviar em um dia. A plataforma aceita um certo número de mensagens por segundo para um número, e as requisições acima disso são recusadas em vez de enfileiradas. Então um envio de dez mil mensagens não é problema em si; enviar todas elas no mesmo segundo é. Espalhado por alguns minutos, o mesmo lote passa sem ser tocado. Isso é diferente do tier de mensagens, que governa com quantos clientes únicos você pode iniciar conversas em um dia, e diferente da limitação por qualidade, que restringe um número cujos destinatários reagem mal. Três tetos diferentes, três códigos diferentes, comumente confundidos entre si. ### O limite pode ser aumentado? Em um número em Coexistência, não. Ele é fixado pela Meta em uma taxa determinada e nenhum provedor consegue elevar, o que vale saber antes de desenhar algo em cima de um número maior. Em um número integrado da forma comum, o throughput cresce com a classificação de qualidade e com o tier de mensagens ao longo do tempo. Essa diferença é uma das poucas trocas reais da Coexistência, e é a razão pela qual um número de disparo em alto volume costuma ficar melhor integrado sem ela. Para uso conversacional o teto raramente é a restrição. Ele vira restrição quando algo percorre uma lista e envia na velocidade máxima que o código permite, um formato que vale evitar por si só. ### O que quem envia deve fazer no lugar? Dosar o ritmo do envio e repetir com um backoff, em vez de repetir imediatamente. Uma fila com taxa fixa é a resposta durável, porque transforma o limite em uma propriedade do sistema, e não em algo descoberto em produção. Onde isso for demais, um backoff exponencial nesse código específico já entrega a maior parte do benefício. O que não funciona é repetir em laço apertado. Um laço que repete instantaneamente a cada recusa gera mais requisições exatamente no momento em que o número já está acima da taxa dele, o que prolonga a condição em vez de encerrar ela. - Repetir imediatamente. Mais requisições no momento da recusa mantêm o número acima da taxa dele. - Confundir com o tier de mensagens. Aquele governa conversas únicas por dia, não mensagens por segundo. - Desenhar um número em Coexistência contando com throughput que cresce. Ele não cresce; o teto é fixo. **Isso quer dizer que meu número está restrito?** Não. É um limite de taxa comum. O número está saudável e as mesmas mensagens passam quando enviadas mais devagar. **Com que velocidade um número em Coexistência envia?** A Meta define uma taxa fixa para números em Coexistência, em vez de escalar com qualidade e tier. **O 80007 é a mesma coisa?** Não. Aquele é um limite de taxa da WhatsApp Business Account, e não do throughput de mensagens de um número. **Outro provedor envia mais rápido?** Não. O limite pertence ao número e à Meta, não a quem está chamando a API. --- ## make | Conectar o WhatsApp ao Make pela Cloud API oficial https://easycoexistence.com/pt/integrations/make Aponte o destino do webhook do número para um webhook personalizado do Make e toda mensagem recebida inicia um cenário. As respostas voltam pela Cloud API com um módulo HTTP. O Make não consegue usar o nosso servidor MCP, porque o Make é ele mesmo um servidor MCP, e não um cliente. ### Como uma mensagem do WhatsApp inicia um cenário do Make? Crie um módulo de webhook personalizado no Make, copie a URL que ele devolve e defina essa URL como destino do webhook do número. Dali em diante a Meta entrega toda mensagem enviada ao número direto nessa URL, como um HTTP POST, e o cenário roda. O payload leva o remetente, o corpo da mensagem ou uma referência de mídia, um timestamp e o id da mensagem. A partir daí é um cenário comum: encaminhe pelo conteúdo, busque o cliente, chame o que mais você tiver rodando. Como isso é Coexistência, a mesma mensagem também está no app do WhatsApp Business no celular. Uma pessoa pode responder, o cenário vê o que ela enviou, e nenhum dos dois acaba respondendo por cima do outro. ### Por que o Make não consegue usar o conector MCP? Porque o Make é um servidor MCP, não um cliente MCP. Ele expõe os próprios cenários para assistentes como Claude e ChatGPT, que se conectam para dentro do Make. Ele não se conecta para fora, até o servidor MCP de outra pessoa. Essa direção é a história inteira. O nosso conector é um servidor esperando ser chamado, e o Make não tem nada que chame um, então os dois nunca se encontram. Isso é diferente do n8n, que tem um nó MCP Client Tool e consegue consumir um servidor remoto por OAuth. Na prática não custa nada. O caminho do webhook faz tudo o que um cenário precisa, e é justamente o caminho que reage a mensagens recebidas, coisa que o MCP não faz em ferramenta nenhuma. ### Como um cenário envia uma resposta? Com um módulo HTTP contra a Cloud API, usando o phone number id e o token de acesso do número. Os dois são visíveis no painel, ou pelo conector MCP, se você preferir que um assistente busque para você. O que enviar depende do tempo. Dentro de 24 horas da última mensagem do cliente, texto livre funciona. Fora disso, só um template que a Meta aprovou é entregue, e um cenário que só envia texto livre vai emudecer no primeiro caso que atravessa a noite. O formato durável é um roteador: verifique há quanto tempo chegou a última mensagem recebida e siga pelo ramo de texto livre ou pelo ramo de template, conforme o caso. - Deixar o webhook apontado para uma URL do Make de um cenário que está desligado. A Meta entrega nela e nada roda. - Não responder à requisição de verificação da Meta. A Meta manda um GET com um desafio antes de entregar qualquer coisa. - Responder com texto livre fora da janela de 24 horas. Falha, e do ponto de vista do cenário parece que não aconteceu nada. **O Make consegue se conectar ao servidor MCP de vocês?** Não. O Make é um servidor MCP e não um cliente, então não tem como chamar o nosso. O caminho do webhook cobre tudo o que um cenário precisa. **Preciso de um app do Make para WhatsApp?** Não. Um webhook personalizado recebe e um módulo HTTP envia. A integração é uma URL e uma chamada REST. **A equipe ainda pode responder pelo celular?** Sim. É isso que Coexistência significa. O app continua funcionando no mesmo número e o cenário vê o que a pessoa enviou. **Um cenário só pode atender vários clientes?** Sim. Aponte todos os números para o mesmo webhook e encaminhe pelo phone number id que está recebendo, dentro do payload. --- ## zapier | Conectar o WhatsApp ao Zapier pela Cloud API oficial https://easycoexistence.com/pt/integrations/zapier Aponte o destino do webhook do número para um catch hook do Zapier e toda mensagem recebida dispara um Zap. As respostas voltam pela Cloud API com uma ação de webhook. O Zapier não consegue consumir o nosso servidor MCP, porque o Zapier é um servidor MCP, e não um cliente. ### Como uma mensagem recebida dispara um Zap? Comece um Zap com o gatilho Webhooks by Zapier, escolha Catch Hook, e copie a URL que o Zapier gera. Defina essa URL como destino do webhook do número e a Meta entrega toda mensagem recebida direto nela. O payload te dá o remetente, o conteúdo da mensagem, um timestamp e o id da mensagem, que é tudo em que a maioria dos Zaps se ramifica. Nada roda na sua infraestrutura e não existe um app do Zapier nosso para manter, porque a superfície da integração é uma URL. O app do WhatsApp Business segue funcionando no mesmo número esse tempo todo, então uma pessoa pode assumir qualquer conversa que o Zap não tratar. ### Por que o Zapier não usa o conector MCP? Porque o Zapier roda um servidor MCP, e não um cliente MCP. Assistentes como Claude e ChatGPT se conectam para dentro do Zapier para usar as ações dele. O Zapier não se conecta para fora, até um servidor MCP de terceiros, então não alcança o nosso. O efeito prático é nenhum. O MCP serve para um assistente agir quando uma pessoa pede, e um Zap tem o formato oposto: alguma coisa acontece, e a automação responde. Isso é território de webhook em qualquer ferramenta, inclusive nas que têm clientes MCP. Se você também quiser um assistente no circuito, o conector funciona no Claude ou no ChatGPT ao lado do Zap, em vez de dentro dele. ### Como um Zap envia uma resposta? Com uma ação POST do Webhooks by Zapier contra a Cloud API, usando o phone number id e o token de acesso do número, tirados do painel. O tempo decide o que você tem permissão de enviar. Dentro de 24 horas da última mensagem do cliente, texto livre é entregue. Fora disso, só um template aprovado é, e é aqui que a maioria dos Zaps quebra em produção, porque os testes sempre acontecem segundos depois de uma mensagem. Um Zap que trata os dois casos precisa de um filtro de caminho baseado em há quanto tempo chegou a última mensagem recebida. É um passo a mais e é a diferença entre uma automação que funciona na terça à tarde e uma que funciona às três da manhã. - Usar uma URL de teste do Zapier como destino. Ela para de escutar e as mensagens são entregues para o nada. - Esquecer o GET de verificação da Meta. O catch hook precisa devolver o desafio antes de a entrega começar. - Enviar texto livre fora da janela de 24 horas, o que falha em silêncio do ponto de vista do Zap. **Existe um app oficial do WhatsApp no Zapier?** Aqui você não precisa de um. Um catch hook recebe e uma ação de webhook envia, o que te mantém na Cloud API oficial sem intermediário. **O Zapier consegue usar o servidor MCP de vocês?** Não. O Zapier é ele mesmo um servidor MCP e não age como cliente, então não tem como chamar o nosso. **Minha equipe perde o celular?** Não. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número. **E se o meu Zap estiver pausado?** A Meta repete por um período e depois para. As mensagens continuam chegando no app do celular, então a empresa não perde nada. --- ## chatgpt | Conectar o WhatsApp ao ChatGPT com um conector personalizado https://easycoexistence.com/pt/integrations/chatgpt Ligue o modo desenvolvedor nas configurações do ChatGPT, adicione a EasyCoexistence como conector, e o ChatGPT consegue listar seus números, verificar a saúde de cada um, enviar mensagens e templates, e apontar webhooks para os seus próprios sistemas, tudo pela Cloud API oficial da Meta. ### Como adicionar isso ao ChatGPT? Abra as Configurações, vá em Conectores, depois em Avançado, e ligue o modo desenvolvedor. É isso que revela a opção de adicionar um conector por URL, em vez de escolher da lista embutida. Adicione um conector apontando para o endpoint MCP da EasyCoexistence. Na primeira vez que o ChatGPT chamar uma ferramenta ele abre um login, e você autoriza ali. Nada é gerado, copiado ou colado, porque o conector usa OAuth em vez de uma chave de API. O servidor em si é remoto. Nada é instalado, nada roda em segundo plano na sua máquina, e fechar o ChatGPT não afeta de forma alguma um número conectado. ### O que o ChatGPT consegue fazer depois de conectado? Peça em linguagem comum e ele escolhe a ferramenta. Qual dos meus números está com problema. Manda para este cliente a confirmação do agendamento dele. Cria um template para avisos de pedido e me avisa quando a Meta aprovar. Aponta o webhook deste número para o meu servidor. As ferramentas de leitura cobrem listar números, verificar a classificação de qualidade, o nível de mensagens e o estado da conexão, e puxar as credenciais quando outra coisa precisa delas. As ferramentas de envio cobrem texto livre dentro da janela de atendimento e templates aprovados fora dela. Uma das dezesseis entrega ao ChatGPT a nossa documentação em markdown, e é por isso que ele responde perguntas sobre como tudo isso funciona a partir dos nossos documentos, e não de um palpite. ### O que ele não consegue fazer? Reagir a uma mensagem recebida, e vale ser claro sobre isso porque é o que a maioria das pessoas presume que um assistente vai fazer. O MCP é requisição e resposta. O ChatGPT chama uma ferramenta quando você pede. Não existe mecanismo para a mensagem de WhatsApp de um cliente acordar o ChatGPT e fazer com que ele responda sozinho às três da manhã. Nada no nosso conector muda isso, e nenhum servidor MCP em produto nenhum muda. Respostas automáticas são o caminho do webhook: a Meta entrega as mensagens recebidas para um sistema que você mantém, e esse sistema decide o que fazer. Os dois funcionam juntos, e o conector pode inclusive definir o destino do webhook para você. - Esperar que ele responda aos clientes automaticamente. O MCP age quando é chamado; mensagens recebidas precisam de um webhook. - Procurar a EasyCoexistence na lista embutida de conectores. Ela é adicionada por URL, com o modo desenvolvedor ligado. - Achar que é preciso uma chave. O conector autoriza por OAuth e não há nada para colar. **Preciso de um plano pago do ChatGPT?** Conectores personalizados ficam atrás do modo desenvolvedor nas configurações. A disponibilidade segue as regras de plano da própria OpenAI, e não algo que a gente controle. **O ChatGPT enxerga as conversas dos meus clientes?** Só o que você pedir. As mensagens recebidas vão da Meta para o destino de webhook que você indicar, e nós nunca guardamos o conteúdo das conversas. **Ele consegue conectar um número novo?** Ele consegue começar o processo. O conector devolve um link que o dono da empresa abre para autorizar o próprio número pelo fluxo da Meta. **Funciona com a mesma conta que o Claude usa?** Sim. Uma conta EasyCoexistence, um endpoint, e todo assistente que você conectar enxerga os mesmos números. --- ## cursor | Conectar o WhatsApp ao Cursor por MCP https://easycoexistence.com/pt/integrations/cursor Adicione a EasyCoexistence à configuração de MCP do Cursor e o editor alcança um número real de WhatsApp sem você sair do projeto: listar números, verificar a saúde de cada um, enviar mensagens e templates aprovados, e apontar destinos de webhook para aquilo que você está construindo, tudo pela Cloud API oficial da Meta. ### Como adicionar isso ao Cursor? Abra as Configurações e encontre a seção de MCP, depois adicione um servidor apontando para o endpoint da EasyCoexistence. O Cursor também lê um arquivo mcp.json, que é o caminho melhor se você estiver configurando várias máquinas ou quiser a configuração versionada. Depois de recarregar, peça ao Cursor para listar seus números. Ele faz login na primeira vez e as ferramentas ficam disponíveis dali em diante. Não há pacote para instalar nem chave para gerar. O servidor é remoto, então nada roda ao lado do editor e fechar o Cursor não tem efeito nenhum sobre um número conectado. ### Por que você iria querer WhatsApp dentro de um editor? Porque a coisa que está sendo construída costuma ser a própria integração, e sem isso o ciclo de feedback é lento. Ligar um webhook, checar se ele verificou, enviar uma mensagem de teste para você mesmo, ler de volta o status de aprovação de um template: cada uma dessas coisas é uma troca de contexto para um painel e de volta. Com o conector, elas viram perguntas feitas onde o código já está. Também é o jeito mais rápido de configurar o número de um cliente enquanto se trabalha no projeto dele. O get_connect_link devolve o link que ele abre, e o set_webhook_destination aponta o número para aquilo que você está construindo, sem ninguém abrir uma aba de navegador que não seja o popup da Meta. - Esperar que ele receba mensagens. O MCP age quando é chamado; o tráfego de entrada precisa de um destino de webhook. - Colocar um token na configuração. O conector usa OAuth e não precisa de nenhum segredo no arquivo. - Enviar texto livre para um contato que não escreve há um dia. Fora das 24 horas, só um template aprovado é entregue. **Tem alguma coisa para instalar?** Não. É um servidor remoto por HTTP com OAuth, então o Cursor se conecta a ele em vez de executá-lo. **Posso manter a configuração versionada?** Pode, pelo mcp.json. Não há segredo nenhum dentro dele, porque a autorização acontece por OAuth no primeiro uso. **Funciona no Claude Code também?** Sim, com um comando só. O endpoint é o mesmo para todo cliente. **Ele consegue enviar para qualquer número?** Ele envia a partir dos números conectados à sua conta, para qualquer destinatário no WhatsApp, respeitando as regras de sempre de janela e de template. --- ## claude-code | Conectar o WhatsApp ao Claude Code por MCP https://easycoexistence.com/pt/integrations/claude-code Rode um comando claude mcp add e o Claude Code alcança um número real de WhatsApp: listar números, verificar a saúde, enviar mensagens e templates, e definir destinos de webhook, tudo pela Cloud API oficial da Meta, e não por uma sessão de aparelho vinculado. ### Como adicionar? Rode claude mcp add com o transporte http e o endpoint da EasyCoexistence, em qualquer terminal. Depois rode /mcp dentro do Claude Code e autentique. As dezesseis ferramentas ficam disponíveis em todas as sessões daquela máquina dali em diante. Nada é instalado além da entrada de configuração. O servidor é remoto, então não há processo para manter vivo nem sessão guardada em disco em lugar nenhum. A autorização é OAuth, o que significa que nenhum token vai parar num histórico de shell, num dotfile ou num repositório. Isso importa mais aqui do que num aplicativo de desktop, porque configuração de terminal costuma ser commitada sem querer. ### Para que isso serve de verdade? Para trabalho de agente que atravessa o WhatsApp e uma base de código ao mesmo tempo, que é a maior parte do que os nossos usuários pagantes estão fazendo. Um agente pode fazer o onboarding do número de um cliente com get_connect_link, apontá-lo para o serviço que está construindo com set_webhook_destination, depois enviar uma mensagem de teste e ler de volta se o webhook verificou. Esse é um ciclo que, de outro jeito, envolve um painel, um celular e muita espera. É também como a documentação chega ao modelo. O get_docs devolve a documentação do nosso produto em markdown, então um agente respondendo perguntas sobre regras de Coexistência, sobre a janela de 24 horas ou sobre a condição de 14 dias responde a partir dos nossos documentos, e não do que ele por acaso lembra. - Esperar que as mensagens recebidas cheguem ao agente. O MCP é requisição e resposta; a entrega precisa de um webhook. - Adicionar por projeto. Ele é configurado por máquina e fica disponível em todas as sessões. - Enviar texto livre fora da janela dentro de um script. Verifique o horário da última mensagem recebida e ramifique para um template. **Funciona no Codex também?** Qualquer coisa que fale MCP por HTTP com OAuth pode usar o mesmo endpoint. **Fica algum token guardado em disco?** Não. A autorização é OAuth, então não existe segredo no arquivo de configuração. **Um agente consegue conectar um número sozinho?** Ele consegue começar o processo. O link que ele devolve precisa ser aberto pelo dono da empresa, porque o fluxo da Meta exige um navegador e o celular. **Fechar o terminal desconecta alguma coisa?** Não. O servidor é remoto e o número segue conectado independentemente do que esteja rodando localmente. --- ## Webhooks do WhatsApp: mensagens direto no seu servidor https://easycoexistence.com/pt/whatsapp-webhook Um webhook do WhatsApp é um endpoint HTTPS que você indica, e a Meta posta eventos nele: mensagens recebidas, status de entrega, mudanças de qualidade e atualizações de conta. Num número em Coexistência o destino pode ser o seu próprio servidor, então as conversas não passam por provedor nenhum. ### O que a Meta manda de fato para um webhook? Eventos, em categorias, e a distinção entre elas decide sua arquitetura. O caminho de mensagem carrega o que os clientes enviam e, num número em Coexistência, ecos do que sua equipe envia pelo app do WhatsApp Business. São os campos messages e smb_message_echoes, e são os que contêm conteúdo de conversa. O caminho operacional carrega todo o resto: account_update quando um estado de conexão muda, phone_number_quality_update quando qualidade ou throughput se move, account_alerts, account_review_update, business_capability_update e phone_number_name_update. Esses não contêm conteúdo de conversa e são do que o monitoramento é feito. Um provedor que se coloca no caminho de mensagem recebe o primeiro grupo. Um que não se coloca, não recebe. ### Como a Meta verifica um endpoint? Com uma requisição GET antes de entregar qualquer coisa, e falhar nisso é o motivo mais comum de uma configuração que parece pronta nunca receber mensagem. A Meta chama sua URL com hub.mode valendo subscribe, seu hub.verify_token, e um valor hub.challenge. Seu endpoint precisa devolver aquele challenge como corpo bruto da resposta, não embrulhado em JSON e sem nada acrescentado. Se não devolver, a Meta nunca começa a entregar, e nenhum painel vai avisar. O endpoint também precisa ser HTTPS. Um endpoint que devolve 404 em silêncio, ou um atrás de uma camada de autenticação que rejeita a Meta, parece idêntico a uma configuração funcionando até a primeira mensagem não chegar. ### O destino pode apontar para o seu próprio servidor? Pode, e é essa a parte que difere entre provedores. A Meta permite que um app sobrescreva onde uma dada conta do WhatsApp Business entrega os webhooks. Nós apontamos esse override para a sua URL, o que move os eventos do caminho de mensagem do nosso callback para o seu. Ficamos com os eventos operacionais, porque o painel e os alertas são feitos deles. A consequência é arquitetural, não uma política que a gente publica. Conteúdo de conversa não tem onde ser armazenado do nosso lado, porque nunca é entregue a nós. Uma conta sem override cai no nosso callback padrão, onde o handler descarta esses eventos sem persistir. ### O que acontece com o destino quando um número reconecta? Ele é removido, e essa é a falha que quase ninguém planeja. O destino não é propriedade do número de telefone. É um override na assinatura do nosso app à conta do WhatsApp Business. Quando uma conexão é removida, pela regra de quatorze dias de inatividade da Meta ou por outro motivo, o app é desinstalado daquela conta e o override vai junto. Reconectar restaura o envio e restaura o monitoramento. Não restaura a entrega no seu servidor, e nada reporta erro, então o primeiro sinal é um cliente dizendo que ninguém respondeu. Nós reaplicamos o override em toda reconexão, porque isso aconteceu com um número real que reconectou limpo e ficou mudo. - Devolver JSON no GET de verificação. A Meta quer o valor bruto de hub.challenge e nada mais. - Usar uma URL temporária ou de teste. A Meta continua entregando nela depois que a ferramenta que a gerou para de escutar. - Achar que o destino sobrevive a uma reconexão. Ele vive numa assinatura de app e é desinstalado junto. - Colocar o endpoint atrás de autenticação que rejeita a requisição da Meta. **Minhas mensagens passam pela EasyCoexistence?** Não. O override manda os eventos do caminho de mensagem da Meta direto para o seu endpoint. Eventos de uma conta sem override caem no nosso callback e são descartados sem persistir. **Posso mudar o destino depois?** Pode, a qualquer momento, pelo painel ou pelo conector MCP. Passar null volta para o nosso padrão. **E se meu servidor estiver fora quando a Meta entregar?** A Meta tenta de novo por um período e depois para. As mensagens ainda chegam no app do WhatsApp Business no celular, então o negócio não perde nada mesmo quando a integração perde. **Um webhook só serve para vários números?** Serve. Aponte todos para o mesmo endpoint e ramifique pelo phone number id que recebe, no payload. --- ## python | Enviar e receber WhatsApp a partir do Python https://easycoexistence.com/pt/integrations/python Receber é uma rota no seu framework web que responde ao GET de verificação da Meta e aceita POSTs. Enviar é uma requisição HTTPS para a Cloud API com o phone number id e o token do número. Nenhum SDK nosso, e nada para instalar. ### Como receber mensagens em Python? Com dois handlers numa mesma rota, em qualquer framework que você já use. O handler de GET responde à verificação da Meta. Ele lê hub.mode, hub.verify_token e hub.challenge da query string, confere o token contra o seu, e devolve o challenge como corpo bruto. Devolver JSON aqui é o erro mais comum, e ele falha em silêncio. O handler de POST recebe os eventos. Devolva 200 rápido e faça o trabalho depois, porque a Meta trata uma resposta lenta como falha e vai repetir, o que significa tratar a mesma mensagem duas vezes. Enfileire, ou entregue a uma tarefa em segundo plano, em vez de processar ali mesmo. As mensagens chegam com um id de mensagem wamid. Vale deduplicar por ele desde o começo, já que as repetições são normais, e não excepcionais. ### Como enviar? Um POST para o endpoint de mensagens da Cloud API do phone number id, com um bearer token. Os dois valores vêm da conexão: o painel mostra eles, e o get_api_credentials devolve eles se você preferir que um assistente busque. Nada na chamada é específico nosso, então qualquer biblioteca HTTP funciona e a requisição fica exatamente igual à documentação da própria Meta. O que muda com o tempo é o corpo. Dentro de 24 horas da última mensagem do cliente você envia um objeto de texto. Fora disso você envia um objeto de template nomeando um template aprovado e o idioma dele. Um cliente que só conhece o primeiro formato funciona perfeitamente nos testes e falha na primeira mensagem que atravessa a noite, devolvendo o erro 131047. ### O que um handler de produção precisa além disso? Três coisas que é fácil pular e caro acrescentar depois. Deduplique pelo id da mensagem, porque a Meta repete. Coloque um segredo longo e aleatório na URL do webhook e rejeite requisições sem ele, já que, sem isso, qualquer um que descubra uma URL fácil de adivinhar pode postar nela. O header de assinatura não é uma opção aqui: a Meta assina com o app secret do app responsável pelo webhook, que é o nosso e nunca é compartilhado. E ramifique por há quanto tempo o contato escreveu pela última vez, para que o caminho de envio escolha texto ou template sem uma pessoa decidindo. Nada disso precisa de framework ou de biblioteca. São um conjunto, uma checagem e uma comparação, e deixar isso pronto antes do primeiro cliente é a diferença entre uma integração que roda em silêncio e uma que te acorda de madrugada. - Devolver JSON no GET de verificação em vez do valor bruto do challenge. - Processar ali mesmo antes de devolver 200. A Meta repete respostas lentas e você trata a mensagem duas vezes. - Enviar texto livre sem checar a janela. Devolve 131047 e parece que não aconteceu nada. **Existe um SDK em Python?** Nosso não, e você não precisa de um. A API é da Meta, documentada pela Meta, e alcançável com qualquer biblioteca HTTP. **Qual framework devo usar?** Qualquer um. O requisito é uma rota que responda a um GET e aceite um POST, coisa que todo framework web em Python faz. **Como evito tratar uma mensagem duas vezes?** Deduplique pelo id de mensagem wamid que vem no payload. A Meta repete por projeto, então isso é esperado, e não um caso de borda. **A equipe ainda pode usar o celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, e o seu handler vê o que eles enviam como um evento de eco. --- ## node | Enviar e receber WhatsApp a partir do Node.js https://easycoexistence.com/pt/integrations/node Receber é uma rota que responde ao GET de verificação da Meta e aceita POSTs. Enviar é uma chamada fetch para a Cloud API com o phone number id e o token do número. Não existe SDK nosso e não há nada para instalar. ### Como receber mensagens em Node? Uma rota com dois métodos, em Express, Fastify, num route handler do Next ou num servidor puro. 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 puro. Devolver como JSON é o erro de sempre e produz um endpoint que nunca recebe nada enquanto parece estar correto. O POST recebe os eventos. Responda 200 imediatamente e processe depois. A Meta repete qualquer coisa lenta, e um handler que faz o trabalho antes de responder vai ver a mesma mensagem mais de uma vez. Em serverless, em especial, responder primeiro e enfileirar o trabalho é o que impede que um cold start vire uma duplicata. ### Como enviar? Um fetch para o endpoint de mensagens da Cloud API do phone number id, com o token no header bearer. Nada nisso é específico nosso, então a requisição bate exatamente com a documentação da própria Meta e não há wrapper para aprender nem para ficar preso. Os dois valores estão no painel, e o get_api_credentials devolve eles pelo conector MCP se for um assistente fazendo a ligação. O corpo depende do tempo. Dentro de 24 horas da última mensagem recebida do cliente, envie um objeto de texto. Fora disso, envie um objeto de template com um nome de template aprovado e o idioma. Código que só envia texto passa em todos os testes e falha na primeira mensagem que chega de madrugada. ### O que muda em serverless? Duas coisas, e as duas são sobre a função terminar antes do trabalho terminar. Devolver 200 e depois seguir processando não sobrevive a uma função que congela no instante em que responde. Use o que a sua plataforma oferecer para manter o trabalho vivo depois da resposta, ou empurre o payload para uma fila e deixe outra função tratar. A Meta só precisa do reconhecimento rápido; ela não precisa que o trabalho esteja feito. Cold starts também tornam respostas lentas mais prováveis, o que significa mais repetições e mais duplicatas. Deduplicar pelo id de mensagem wamid não é opcional neste formato, é justamente o que o torna confiável. - Devolver o challenge como JSON em vez de como corpo bruto. - Fazer o trabalho antes de responder 200. Em serverless a função pode congelar no instante em que responde. - Pular a deduplicação. A Meta repete por projeto e duplicatas são normais, não um caso de borda. **Preciso de uma biblioteca?** Não. Uma rota e o fetch bastam, e a chamada bate exatamente com a documentação da Meta. **Isso funciona na Vercel ou no Lambda?** Sim, com a ressalva de sempre do serverless: reconheça primeiro, depois processe por uma fila ou por um mecanismo em segundo plano, em vez de ali mesmo. **Como verifico que a requisição veio da Meta?** Coloque um segredo longo e aleatório na URL do webhook e rejeite qualquer requisição sem ele. A Meta assina com o app secret do app responsável pelo webhook, que aqui é o nosso e nunca é compartilhado, então o header de assinatura não tem como ser conferido do seu lado. **Posso usar TypeScript?** Pode. Não há nada nosso contra o que tipar, já que o payload é da Meta e documentado pela Meta. --- ## EasyCoexistence vs uma caixa de entrada de BSP https://easycoexistence.com/pt/compare/coexistence-vs-bsp Um BSP vende uma plataforma: uma caixa de entrada compartilhada onde sua equipe trabalha, com as mensagens guardadas nos servidores deles. A Coexistência mantém o app do WhatsApp Business no celular e entrega as mensagens onde você indicar. A escolha é entre querer um produto para trabalhar dentro ou uma conexão para construir em cima. ### O que um BSP de fato entrega? Um produto, e isso não é crítica. Um Business Solution Provider costuma vender uma caixa de entrada compartilhada: os atendentes entram, as conversas são atribuídas, há respostas prontas, etiquetas, relatórios e um app de celular. Para uma equipe de suporte de oito pessoas que precisa dividir trabalho e ver quem respondeu o quê, essa é genuinamente a compra certa, e construir por conta seria tolice. A consequência arquitetural é que as mensagens passam e ficam guardadas na plataforma deles, porque uma caixa de entrada compartilhada não existe de outro jeito. Ela precisa do histórico para mostrar. Isso é inerente ao produto, não uma escolha que um fornecedor específico fez. ### Quando a Coexistência encaixa melhor? Quando o número pertence a um negócio que já tem um jeito de trabalhar, e ninguém quer mudar isso. Uma equipe pequena atendendo de um celular não precisa de atribuição de conversa. Precisa das noites de volta, o que significa algo automático cuidando de confirmações e primeiras respostas enquanto o celular continua funcionando exatamente como funciona. Mudar essa gente para uma caixa de entrada resolve um problema que ela não tem e cria um que ela não pediu. Uma agência tem o mesmo formato por outro motivo. Clientes não vão migrar o número nem retreinar a equipe, e muitas vezes não aceitam as conversas deles ficarem numa plataforma de terceiro. A Coexistência é a única rota oficial que não pede nada deles. ### Qual é o certo se você está construindo o software? Coexistência, quase sempre, e o motivo é estrutural, não de recurso. Se você está construindo a coisa que trata as conversas, uma caixa de entrada de BSP é concorrente do que você constrói e uma camada entre você e a Meta. Você acaba integrando contra a abstração deles em vez da Cloud API, o que significa os limites de taxa deles, o formato de webhook deles, o calendário de release deles e o preço deles por cima do da Meta. Com a Coexistência o webhook vai para o seu endpoint e as chamadas de API são da própria Meta, documentadas pela Meta. Nada na integração é específico de um fornecedor, que é também o que torna possível ir embora. - Escolher por preço. São produtos diferentes, e o mais barato não é uma versão menor do outro. - Colocar uma equipe de suporte de oito pessoas numa conexão crua sem nada construído. Elas precisam de caixa de entrada e vão ficar insatisfeitas sem uma. - Achar que um BSP consegue manter o app do WhatsApp Business vivo. Alguns conseguem por Coexistência, muitos não, e vale perguntar direto. **Dá para usar os dois?** Na prática sim, se um BSP suportar Coexistência. A pergunta a fazer a eles é onde o conteúdo das conversas fica guardado, porque é isso que de fato difere. **Um BSP é mais confiável?** Os dois rodam na Cloud API da Meta, então a entrega é a mesma. O que muda é quantas partes ficam entre a Meta e o seu sistema. **Qual é mais barato?** Normalmente um valor fixo de conexão sai menos que preço de caixa de entrada por assento, mas são compras diferentes e comparar só os números engana. **O que acontece com meu histórico se eu sair?** Com a Coexistência ele nunca esteve conosco. Com uma plataforma ele mora lá, e tirar de lá é uma exportação. --- ## EasyCoexistence vs construir por conta própria https://easycoexistence.com/pt/compare/build-it-yourself-vs-easycoexistence Toda chamada de API que este produto faz está documentada pela Meta e disponível para qualquer um que tenha um app na Meta. Construir a conexão é um fim de semana. O que demora mais é virar Tech Provider, e o que nunca termina é perceber quando uma conexão morre em silêncio. ### O que você teria mesmo que construir? Menos do que as pessoas esperam para a primeira versão, e bem mais do que elas esperam para aquela que se sustenta. A primeira versão é um app na Meta, o Embedded Signup, um endpoint que responde ao handshake de verificação, e uma chamada de envio. Isso é genuinamente um fim de semana para quem está confortável com OAuth e webhooks, e as nossas próprias páginas de documentação descrevem quase tudo. A versão que se sustenta é outra coisa. Ela trata oito tipos de evento de webhook pelo nome, distingue um token revogado de um número removido, consulta classificação de qualidade e nível de mensageria porque nenhum dos dois chega como um evento em que dá para confiar, reaplica o override de webhook depois que uma reconexão o desinstala, e separa uma desconexão por quatorze dias de inatividade de um cliente que foi embora de verdade. Cada um desses itens foi aprendido com alguma coisa quebrando. ### Qual é a parte que não tem atalho? Virar o seu próprio Tech Provider na Meta, que é a diferença entre conectar um número e conectar os números dos outros. É gratuito, e não é rápido. Exige um Business Manager verificado, um app que passe no App Review, e vídeos gravados demonstrando os fluxos. Até isso estar pronto você está trabalhando através da conta de provedor de outra pessoa, que é justamente o que produz os limites de conexão única que as pessoas encontram em ferramentas de prateleira. Se você está conectando um número que é seu, nada disso se aplica e você deveria simplesmente construir. Se você está conectando números para clientes, esse é o projeto de verdade, e ele é medido em semanas de espera em vez de dias de trabalho. ### Quanto custa de fato manter o monitoramento rodando? É a parte sem data de conclusão, e é exatamente isso que a torna diferente de todo o resto. Uma conexão falha em silêncio. O app do WhatsApp Business continua funcionando através de uma queda de qualidade, de um token expirado, de um override de webhook removido e de uma desconexão de quatorze dias, então nada no celular indica que há problema e o primeiro sinal costuma ser um cliente perguntando por que ninguém respondeu. Pegar isso significa um poller agendado, um receptor de webhook, algum lugar para guardar estado, alertas, e alguém que perceba o alerta. Nada disso é difícil. Tudo isso tem que continuar rodando, e tem que continuar correto conforme a Meta muda as coisas, o que ela faz. Essa é a coisa honesta que está sendo comprada aqui, e não as chamadas de API. - Estimar a partir da primeira versão. Conectar um número é um fim de semana; manter cinquenta conectados não é nada disso. - Planejar virar Tech Provider com prazo marcado. O tempo do App Review não é seu para controlar. - Tratar monitoramento como uma fase futura. As falhas que ele pega são silenciosas, então a ausência delas não é prova de que não estão acontecendo. **Tem alguma coisa proprietária aqui?** Não. Toda chamada é a Cloud API documentada da Meta. Isso é deliberado: significa que nada prende você e que você pode sair com a sua própria integração intacta. **Devo construir se eu tenho um número só?** Provavelmente sim. Um número que é seu, conectado uma vez, é um projeto pequeno e você vai aprender a plataforma direito. **Quanto tempo leva o status de Tech Provider?** É gratuito, mas envolve um Business Manager verificado e o App Review, incluindo vídeos gravados. A espera é a parte longa disso tudo. **O que eu perco construindo?** Nada técnico. Você assume o monitoramento, que é a parte que nunca termina e a parte que falha caladinha. --- ## Erro 368 do WhatsApp: conta restringida por política https://easycoexistence.com/pt/docs/whatsapp-error-368 O erro 368 significa que a WhatsApp Business Account foi restringida pela Meta em decorrência de uma ação de aplicação de política. É uma decisão em nível de conta, e não um problema da requisição, e o recurso é feito junto à Meta, não junto a um provedor. ### O que uma restrição significa, na prática? Que a Meta tomou uma medida de aplicação contra a conta de negócio, normalmente depois de problemas repetidos de política, e não de um evento isolado. As causas comuns são conteúdo de mensagem que fere a política de comércio ou de negócios do WhatsApp, um padrão de destinatários denunciando mensagens, ou um detalhe de verificação do negócio que não se sustenta. O que elas têm em comum é dizerem respeito à conta, e não a uma mensagem específica, e é por isso que todos os envios falham em vez de alguns. Vale separar isso da limitação por qualidade, que restringe o quanto uma conta saudável pode enviar. Uma restrição é um julgamento sobre se a conta deveria estar operando, e não se resolve enviando menos. ### Como isso se resolve? Pela Meta, no Business Manager, e só pelas pessoas que são donas da conta. O aviso de aplicação no Business Manager explica qual política foi citada e se há um recurso aberto. Recursos existem e às vezes dão certo, mas não há prazo que alguém possa prometer nem caminho de escalonamento que passe por um provedor. Ninguém que vende acesso à API tem visibilidade sobre uma decisão de aplicação nem capacidade de influenciar uma. Esta é uma das poucas situações em que a resposta honesta de qualquer fornecedor é que ele não pode ajudar justamente naquilo em que você mais quer ajuda. O que ele pode dizer é qual conta está restringida e quando isso aconteceu, que é para isso que a linha do tempo da conexão existe. - Pedir a um provedor que levante a restrição. Uma decisão de aplicação pertence à Meta e mais ninguém consegue vê-la. - Conectar o número em outro lugar. A restrição é na conta de negócio e segue junto com ela. - Confundir com a limitação por qualidade, que restringe volume em uma conta saudável em vez de restringir a própria conta. **Posso levar o número para outro provedor?** Não. A restrição é na WhatsApp Business Account, então vale onde quer que o número seja usado. **Quanto tempo leva um recurso?** A Meta não publica um número, e nenhum provedor tem visibilidade sobre o processo. **Isso afeta o recebimento?** A aplicação varia caso a caso. O que é constante é que o envio para de funcionar. **O 131031 é o mesmo?** É relacionado. Aquele acompanha uma restrição com divergência nos dados de verificação, o que aponta para os dados do negócio e não para o comportamento de mensagens. --- ## Erro 131031 do WhatsApp: conta restringida ou dados divergentes https://easycoexistence.com/pt/docs/whatsapp-error-131031 O erro 131031 significa que a WhatsApp Business Account está restringida, comumente porque os dados de verificação do negócio não batem com o que a Meta tem, ou porque um PIN de verificação em duas etapas está envolvido. Isso se resolve no Business Manager, e não no código. ### Que tipo de divergência causa isso? Uma diferença entre o que a Meta tem sobre o negócio e o que foi informado, o que parece pouco e não é. A verificação do negócio liga uma pessoa jurídica à conta: razão social, endereço, dados de registro e documentos de apoio. Quando algo muda do lado do negócio e não é atualizado junto à Meta, ou quando o que foi enviado não bate com um registro que a Meta consulta, a conta pode ser restringida até que isso se concilie. O PIN de verificação em duas etapas é a outra causa comum, e é mais fácil de resolver. Ele é definido no número de telefone e exigido para certas operações, e se foi esquecido ou definido por alguém que já saiu, precisa ser redefinido antes que qualquer outra coisa funcione. ### Onde olhar, na prática? No Business Manager, na conta de negócio, e não no número de telefone. O status de verificação e qualquer aviso de aplicação ficam os dois lá, e juntos costumam dizer qual das duas causas se aplica. O painel de um provedor consegue dizer que um número parou de funcionar e quando, mas não enxerga um registro de verificação, então não consegue dizer qual dado está errado. Se a causa for a verificação, o caminho é atualizar os dados do negócio e enviar de novo. Se a causa for o PIN, ele é redefinido nas configurações daquele número no WhatsApp Manager, e vale anotar em algum lugar onde a empresa consiga achar depois. - Tratar como falha de código. A requisição estava bem formada e a conta é que foi recusada. - Reenviar a verificação com os mesmos dados que foram rejeitados. - Achar que o PIN fica guardado por um provedor. Ele é definido no número, nas próprias configurações da Meta. **Isso é o mesmo que o 368?** É relacionado, mas não idêntico. O 368 é uma ação de aplicação de política; este aqui costuma apontar para os dados de verificação do negócio ou para um PIN de duas etapas. **Um provedor consegue ver meu status de verificação?** Não. Isso fica na conta de negócio no Business Manager e não é exposto aos provedores. **Reconectar ajuda?** Não. A restrição vale para a conta, então uma conexão nova encontra a mesma condição. **Como redefino o PIN de duas etapas?** No WhatsApp Manager, nas configurações do número de telefone. Anote em algum lugar onde a empresa consiga recuperar depois. --- ## Erro 132015 do WhatsApp: template pausado por qualidade https://easycoexistence.com/pt/docs/whatsapp-error-132015 O erro 132015 significa que esse template foi pausado pela Meta porque a qualidade dele caiu, normalmente depois de destinatários bloquearem ou denunciarem mensagens que o usaram. O número está bem. É este template que está temporariamente impedido de enviar. ### Por que um template sozinho é pausado? Porque a qualidade é medida por template além de por número, e um template ruim pode ser isolado sem punir todo o resto. A Meta observa como os destinatários reagem às mensagens enviadas com cada template: bloqueios, denúncias e se as pessoas interagem de alguma forma. Um template que produz reações ruins de forma consistente é pausado enquanto os outros do mesmo número seguem funcionando. É uma resposta deliberadamente estreita, e mais útil do que parece à primeira vista, porque diz exatamente qual mensagem é o problema. Os culpados de sempre são conteúdo promocional dentro de um template de utilidade, uma mensagem que não deixa claro qual empresa está escrevendo, ou um template enviado para pessoas que não esperavam receber. ### O que fazer com um template pausado? Editar em vez de reenviar, e tratar a pausa como informação sobre o conteúdo. Um template pausado volta a poder enviar depois de um período, mas mandar o mesmo conteúdo para o mesmo tipo de público produz a mesma reação e uma segunda pausa. A Meta desativa um template de forma permanente depois de pausas repetidas, e a partir daí o único caminho é criar um novo com conteúdo diferente, então a segunda pausa é a que vale evitar. Editar normalmente significa deixar o propósito óbvio na primeira linha, dizer o nome da empresa e ser honesto sobre por que aquela pessoa está recebendo isso. Significa também conferir para quem o template é enviado, porque um bom template mandado para uma lista desinteressada ainda produz os mesmos sinais. - Reenviar o mesmo template depois que a pausa cai. O conteúdo é o que causou a pausa. - Ler isso como um problema do número. Outros templates do mesmo número continuam funcionando. - Esperar por uma terceira pausa. Pausas repetidas desativam o template permanentemente. **Os outros templates ainda enviam?** Sim. A pausa vale para 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 tempo aumenta com pausas repetidas. **Posso editar um template pausado?** Pode, e editar é justamente o ponto. Reenviar um conteúdo melhor é como ele se recupera. **O que é o 132016?** A versão permanente. Depois de 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/docs/whatsapp-error-100 O erro 100 significa que a requisição levou um parâmetro que a Meta não aceita: não suportado, escrito errado ou no formato errado para aquele endpoint. É determinístico, então a mesma requisição falha igual todas as vezes e repetir nunca resolve. ### O que provoca esse erro Algo no corpo ou na query da requisição que o endpoint não reconhece, e as causas são entediantemente parecidas. - Um nome de campo escrito errado, ou com maiúsculas e minúsculas trocadas. - Um parâmetro que pertence a outro endpoint. - Um valor do tipo errado, como um número enviado como texto onde se espera inteiro. - Um objeto aninhado achatado, ou um valor simples onde deveria ir um objeto. ### Por que repetir não adianta Porque nada mudou na plataforma entre uma tentativa e outra. Uma requisição malformada continua malformada na segunda tentativa pelo mesmo motivo da primeira, e um laço de repetição em cima desse erro produz limite de taxa somado ao problema original, em vez de sucesso. A resposta útil é registrar o corpo da requisição junto do erro e comparar campo a campo com a referência do endpoint. Na quase totalidade dos casos a diferença aparece em menos de um minuto de leitura. - Repetir. A requisição é determinística e vai falhar igual. - Achar que é o número. Este erro nunca diz nada sobre a conexão. - Ler como falha genérica. Ele aponta um problema de parâmetro, e existem os códigos 131008 e 131009 para ausente e fora do aceito. **Isso quer dizer que meu número quebrou?** Não. Este erro é só sobre a requisição, e o número não é afetado. **Por que ele é tão vago?** É o código guarda-chuva para problemas de parâmetro. A Meta tem códigos mais específicos para parâmetro ausente e para valor inválido. **Um provedor pode causar isso?** Só ao montar a requisição. Numa integração direta, a requisição é sua. **Devo repetir com backoff?** Não. É determinístico, e repetir soma limite de taxa a um problema que não é temporário. --- ## Erro 131008 do WhatsApp: parâmetro obrigatório ausente https://easycoexistence.com/pt/docs/whatsapp-error-131008 O erro 131008 significa que um parâmetro obrigatório ficou de fora da requisição. É mais específico e mais útil que o erro 100, que cobre parâmetros malformados em geral, porque este diz que o campo estava ausente, não errado. ### O que costuma faltar Os campos que parecem opcionais e não são, e é por isso que os mesmos poucos aparecem de novo e de novo. - messaging_product, que precisa valer whatsapp em todo envio. - recipient_type nos formatos de mensagem que o exigem. - O objeto language no envio de template, obrigatório mesmo quando só existe um idioma. - components num template que define variáveis, onde lista vazia não é o mesmo que omitir. ### Por que isso é boa notícia Porque é a falha mais específica desta família. O erro 100 diz que algum parâmetro está errado em algum lugar; este diz que um parâmetro obrigatório não está ali, o que reduz a busca à lista de campos exigidos pelo endpoint. A correção é ler a referência do endpoint chamado e conferir a requisição contra o conjunto obrigatório. É um minuto de trabalho, e é por isso que vale distinguir este do 100 no log em vez de agrupar os dois como requisição inválida. - Tratar igual ao erro 100. Este aponta uma ausência, que é mais específico. - Enviar components como lista vazia achando que equivale a omitir. São coisas diferentes para a API. - Esquecer messaging_product. É obrigatório em todo envio e é a omissão mais comum. **Qual parâmetro está faltando?** A resposta nomeia. Quando não nomeia, a referência do endpoint lista o conjunto obrigatório. **messaging_product é obrigatório mesmo?** Sim, em todo envio, com valor whatsapp. É a omissão mais comum. **É a mesma coisa que o 100?** Não. O 100 cobre parâmetro presente e errado; este cobre parâmetro ausente. **Repetir ajuda?** Não. A requisição é determinística e vai falhar igual até o campo ser acrescentado. --- ## Erro 131009 do WhatsApp: valor de parâmetro inválido https://easycoexistence.com/pt/docs/whatsapp-error-131009 O erro 131009 significa que um ou mais valores de parâmetro são inválidos: o campo estava presente e foi entendido, mas o conteúdo não é aceito pelo endpoint. Código de idioma, formatação de telefone e valores de enum respondem pela maioria. ### Os valores que mais falham Três formatos causam a maioria, e os três parecem corretos para quem lê. - Códigos de idioma: en onde o template foi criado como en_US, ou pt onde é pt_BR. - Telefones com pontuação, zero à esquerda ou sinal de mais, onde se espera só dígitos em formato internacional. - Valores de enum com caixa errada, como categoria de template em minúsculas. - Datas ou timestamps em formato diferente do documentado pelo endpoint. ### Por que o caso do idioma merece destaque Porque produz dois erros diferentes dependendo do endpoint, e as pessoas perseguem o errado. Enviar um template com idioma que não existe para aquele nome devolve 132001, que se lê como template inexistente. Passar um código de idioma malformado a um endpoint que valida antes devolve este erro. Os dois são o mesmo engano por baixo, e a correção nos dois casos é ler a listagem de templates e copiar a string exata de idioma em vez de supor o formato. - Supor que en e en_US são intercambiáveis. Identificam templates diferentes. - Enviar telefone com mais ou pontuação. Só dígitos, em formato internacional. - Repetir. O valor está errado de forma determinística. **Qual valor está errado?** A resposta costuma nomear o parâmetro. Quando não nomeia, idioma e formato de telefone são os primeiros lugares a olhar. **Como formatar o telefone?** Formato internacional, só dígitos, sem sinal de mais e sem pontuação. **Por que o mesmo engano às vezes devolve 132001?** Porque o envio de template resolve nome e idioma juntos, então um par desconhecido se lê como template ausente. **Isso é problema do meu número?** Não. Este erro é só sobre a requisição. --- ## Erro 131051 do WhatsApp: tipo de mensagem não suportado https://easycoexistence.com/pt/docs/whatsapp-error-131051 O erro 131051 significa que o tipo de mensagem enviado não é suportado. Às vezes é um valor de tipo malformado, mas num número em Coexistência costuma significar que o tipo é um dos que a plataforma não permite naquele tipo de conexão. ### Duas causas diferentes A primeira é banal: um valor de tipo escrito errado ou que a API não define. Ler a referência do endpoint resolve em um minuto. A segunda é estrutural e pega as pessoas de surpresa, porque o código é idêntico. Um número em Coexistência não faz tudo o que um número comum de Cloud API faz, e tentar uma dessas coisas devolve este erro em vez de uma mensagem mais clara. Mensagens temporárias, mídia de visualização única, localização em tempo real e listas de transmissão ficam desligadas num número conectado, e grupos estão fora da API por completo. ### Como saber qual das duas é Pelo que você estava tentando enviar. - Um tipo que a API define e que você já enviou antes: erro de formatação, então compare o payload. - Qualquer coisa endereçada a um grupo: estrutural, e nenhum provedor consegue liberar. - Localização em tempo real, visualização única ou mensagem temporária: estrutural num número em Coexistência. - Um tipo novíssimo que você nunca enviou: confira se está disponível na sua conta e na sua região. - Construir em cima de grupos. Eles estão fora da API em qualquer provedor. - Achar que um provedor consegue habilitar um tipo desligado. Isso é nível de plataforma. - Repetir. Nenhuma das duas causas é transitória. **Posso enviar para um grupo?** Não. Grupos estão fora da API num número em Coexistência, em qualquer provedor. **Por que localização em tempo real não é suportada?** É um dos recursos desligados num número quando a Coexistência é ativada. **Isso tem conserto?** Se a causa for tipo malformado, sim. Se for limite de plataforma, não. **Afeta o recebimento?** Não. Este erro é sobre enviar um tipo que não é permitido. --- ## Erro 131052 do WhatsApp: falha ao baixar mídia https://easycoexistence.com/pt/docs/whatsapp-error-131052 O erro 131052 significa que a Meta não conseguiu baixar a mídia anexada a uma mensagem. É sobre a mídia em si, não sobre sua requisição, então a resposta prática é pedir o arquivo de outro jeito em vez de mudar algo no código. ### Por que acontece Porque mídia recebida é buscada, não entregue. A mensagem carrega um media id, e os bytes são recuperados à parte com ele. Essa recuperação pode falhar por motivos do lado de quem enviou: um upload que não completou, um arquivo que expirou antes de ser buscado, ou um formato que não sobreviveu ao que o gerou. Nada disso é visível do seu lado, e nada disso se resolve mudando a sua requisição. ### O que fazer Trate como uma mensagem recebida sem o anexo, e lide com ela como qualquer outra entrada incompleta. - Registre a mensagem e marque a mídia como indisponível, em vez de descartar o evento inteiro. - Busque a mídia logo: media ids não valem para sempre. - Havendo uma pessoa no fluxo, peça ao cliente para enviar de novo, o que resolve a maioria dos casos. - Não repita indefinidamente. Se a primeira busca e uma repetição falharem, a mídia não vem. - Descartar a mensagem inteira. O texto e o contexto continuam úteis sem o anexo. - Buscar mídia muito depois de receber. Media ids expiram. - Repetir em laço. Uma busca que falhou raramente funciona depois. **A mensagem se perde?** Não. A mensagem chega; o que falhou foi recuperar o anexo. **Devo pedir ao cliente para reenviar?** Havendo uma pessoa envolvida, sim. Resolve a maioria dos casos rápido. **Por quanto tempo um media id vale?** Não indefinidamente, e é por isso que buscar logo importa. **O 131053 é a mesma coisa?** Não. Aquele é falha ao subir mídia que você está enviando. --- ## Códigos de erro da WhatsApp Cloud API https://easycoexistence.com/pt/docs/whatsapp-error-codes Esta é a lista de todos os códigos de erro da WhatsApp Cloud API que documentamos, em uma tabela só, com o que cada um significa e se repetir a chamada ajuda. A maioria não ajuda: eles são determinísticos, então a mesma requisição falha do mesmo jeito e um laço de repetição transforma uma requisição ruim em um limite de taxa. ### Como ler a coluna de repetição Ela tem três valores, e escolher errado entre eles é o erro mais caro desta referência inteira. Não significa que a falha é determinística. A requisição, o template ou o estado do destinatário é o que falhou, e enviar a requisição idêntica de novo produz o erro idêntico enquanto consome throughput que você vai querer depois. Sim significa que a falha foi do lado da Meta e que um backoff realmente resolve. Aguarde significa que a condição é real, mas temporária: um limite ou um bloqueio que passa sozinho, em que repetir antes de ele passar não faz nada e pode prolongar. ### Por que a maioria deles não é repetível Porque a plataforma devolve códigos específicos em vez de genéricos. Um parâmetro malformado, um template que não existe, uma janela de mensagens fechada e um destinatário que saiu da lista são todos conhecíveis no momento da resposta, então a Meta nomeia eles em vez de falhar de forma vaga. - Um problema de requisição não fica correto na segunda tentativa. - Um problema de template vive no template, que a requisição não consegue mudar. - Um problema de janela ou de saída da lista é sobre o estado do destinatário, não sobre o seu. - Uma restrição de conta é uma decisão, e repetir não é um recurso. ### O que registrar quando um desses chega O suficiente para diagnosticar sem reproduzir, que é a diferença entre uma correção de cinco minutos e um dia de adivinhação. - A resposta de erro completa, incluindo o trace id, que é o que o suporte da Meta pede. - O corpo da requisição como foi enviado, e não como era pretendido. A distância entre os dois costuma ser o bug. - O phone number id, para que um problema em um número seja distinguível de um problema em toda a conta. - O carimbo de tempo, para que a falha possa ser conferida contra o estado da conexão naquele momento. ### Os códigos que só existem na Coexistência São dois, e eles confundem as pessoas porque parecem falhas comuns de envio. O 2593107 e o 2593108 dizem respeito os dois à sincronização do histórico de conversas, que é a etapa que copia as conversas recentes do app do WhatsApp Business quando um número é conectado pela primeira vez. Eles não são erros de mensagem e não querem dizer que a conexão falhou. Uma sincronização que excede o limite dela ou que roda fora da janela dela deixa o número conectado e enviando normalmente, com menos histórico copiado do que se esperava. Ler isso como uma conexão quebrada leva as pessoas a desconectar e começar de novo, o que perde mais histórico em vez de recuperar. - Repetir por padrão. A maioria desses códigos é determinística e um laço ainda ganha um limite de taxa por cima. - Registrar o erro sem o corpo da requisição. A distância entre o enviado e o pretendido costuma ser o bug. - Ler um erro de sincronização como uma conexão quebrada. O número continua conectado e enviando. - Descartar o trace id, que é a única coisa que torna um chamado de suporte acionável. **Quais erros eu devo repetir?** O 131016 e o 131000, com backoff exponencial. O 130429, o 132015 e o 133008 passam sozinhos se você esperar. Todo o resto é determinístico. **Um código de erro quer dizer que meu número foi desconectado?** Em geral não. A maioria deles diz respeito à requisição, ao template ou ao destinatário. Problemas de conexão aparecem como webhooks de conta e de qualidade, e não como erros de envio. **O que é um trace id?** Um identificador na resposta de erro que permite ao suporte da Meta achar aquela requisição específica. Registre em toda falha; sem ele um chamado não pode ser tratado. **Esses códigos são iguais em todo provedor?** São. Eles vêm da Cloud API da Meta, então são idênticos independentemente de qual provedor conectou o número. Um provedor só consegue mudar com que clareza eles chegam até você. --- ## Erro 131053 do WhatsApp: falha ao subir mídia https://easycoexistence.com/pt/docs/whatsapp-error-131053 O erro 131053 significa que a Meta falhou ao subir a mídia da sua requisição. Diferente do irmão 131052, este é sobre um arquivo que você controla, então tem conserto: confira tamanho, formato e, se estiver mandando link, se a Meta consegue mesmo alcançá-lo. ### As três causas Na ordem em que aparecem na prática. - Tamanho: o arquivo passou do teto do seu tipo. Imagens 5 MB, vídeo e áudio 16 MB, documentos 100 MB. - Formato: um codec ou contêiner que a API não aceita, comum em vídeo exportado de software de edição. - Alcance: mandar link em vez de id já subido, onde a URL pede login, está atrás de firewall ou redireciona. - Expiração: um media id já subido usado muito depois de criado. ### Subir é melhor que linkar Mandar link faz a Meta buscar o arquivo na hora do envio, o que acrescenta uma forma de falhar que você não enxerga da sua própria rede. Uma URL que abre perfeitamente no seu navegador pode ser inalcançável da infraestrutura da Meta por geografia, regra de firewall ou um cookie de autenticação que seu navegador já tem. Subir o arquivo antes e enviar o media id devolvido elimina essa classe de falha por inteiro. É uma requisição a mais e torna o envio determinístico, o que compensa em qualquer coisa enviada em volume. - Achar que uma URL que funciona no seu navegador funciona para a Meta. Sua sessão e sua rede não são as dela. - Exportar vídeo sem conferir o codec. Os padrões de software de edição costumam não ser aceitos. - Reusar um media id muito depois de subir. Ids expiram. **Quais são os limites de tamanho?** Imagens 5 MB, vídeo e áudio 16 MB, documentos 100 MB. **Devo subir ou mandar URL?** Suba. Isso elimina alcance como causa de falha. **A URL funciona para mim, por que não para a Meta?** A rede deles não é a sua. Geografia, firewalls e autenticação são todos diferentes. **É a mesma coisa que o 131052?** Não. Aquele é falha ao baixar mídia que um cliente te enviou. --- ## Erro 131016 do WhatsApp: serviço indisponível https://easycoexistence.com/pt/docs/whatsapp-error-131016 O erro 131016 significa que um serviço do lado da Meta está temporariamente indisponível. É um dos poucos erros de plataforma que realmente é transitório, então repetir com backoff exponencial é a resposta certa, e não investigar. ### Por que este é diferente A maioria dos erros desta plataforma é determinística: a requisição está malformada, o template não existe, a janela fechou. Repetir esses desperdiça requisição e rende limite de taxa. Este erro é a exceção. Ele não diz nada sobre sua requisição nem sobre seu número, só que um serviço da Meta não conseguiu responder agora. A mesma requisição um minuto depois costuma funcionar, que é exatamente para isso que serve um backoff. ### Como repetir direito Com moderação, porque uma enxurrada de repetições piora uma indisponibilidade. - Backoff exponencial: espere um segundo, depois dois, depois quatro, depois oito. - Um teto de tentativas, normalmente cinco, após o qual a mensagem vai para uma fila. - Jitter, para uma frota de workers não repetir em uníssono. - Idempotência, para uma mensagem que de fato saiu antes do erro chegar não ser enviada duas vezes. - Repetir na hora, em laço apertado. Isso soma carga a algo que já está sofrendo. - Tratar como problema de conexão. Seu número está bem. - Repetir sem teto. Algumas indisponibilidades duram mais que qualquer política de repetição deveria. **Devo repetir?** Sim, com backoff exponencial. Este é um dos erros em que repetir funciona. **Meu número é afetado?** Não. É uma falha do lado da plataforma. **Quanto tempo isso dura?** Normalmente de segundos a minutos. Um backoff de cinco tentativas cobre a maioria. **Como diferenciar de uma queda real?** Pela persistência. Monitoramento contínuo responde isso sem chute. --- ## Erro 131000 do WhatsApp: algo deu errado https://easycoexistence.com/pt/docs/whatsapp-error-131000 O erro 131000 significa que uma mensagem falhou por um motivo que a Meta não classificou. É o balde do não classificado, então a abordagem prática é repetir uma vez com backoff e, se persistir, escalar com o trace id da resposta. ### O que isso realmente cobre Qualquer coisa em que o caminho de envio da Meta falhou sem mapear a falha para um código com nome. Isso inclui falhas transitórias reais, problemas internos e, às vezes, uma condição que tem código específico numa versão mais nova da API mas não tinha na hora. Como o balde é largo, nenhuma resposta única está certa. Uma ocorrência isolada é ruído. O mesmo destinatário falhando repetidamente é um padrão que merece chamado. ### O que fazer com ele Nesta ordem, parando assim que uma funcionar. - Repita uma vez com backoff curto. Parte desses é transitória. - Registre a resposta completa, incluindo o trace id, que é o que o suporte vai pedir. - Veja se é um destinatário ou todos. Um destinatário aponta para aquele número; todos apontam para a plataforma. - Se persistir entre repetições, abra chamado citando o trace id e os horários. - Repetir indefinidamente. Se duas tentativas falham, não é transitório. - Descartar o trace id. É a única coisa que torna um chamado acionável. - Achar que significa número quebrado. Normalmente não significa. **Devo repetir?** Uma vez, com backoff. Além disso não é transitório. **O que é um trace id?** Um identificador na resposta de erro que permite ao suporte da Meta achar aquela requisição específica. **Significa que meu número caiu?** Normalmente não. Veja se outros envios estão funcionando. **Quando abrir chamado?** Quando repetir entre tentativas, com o trace id e os horários. --- ## Erro 131021 do WhatsApp: remetente e destinatário iguais https://easycoexistence.com/pt/docs/whatsapp-error-131021 O erro 131021 significa que remetente e destinatário são o mesmo número. O WhatsApp não permite que um número de negócio mande mensagem para si mesmo, e a causa é quase sempre uma mensagem de teste endereçada ao número recém-conectado em vez de a um segundo aparelho. ### Por que acontece Porque a primeira coisa que qualquer um faz depois de conectar um número é mandar uma mensagem de teste, e o único número à mão é o que acabou de conectar. É um instinto razoável e a plataforma recusa. Não existe configuração para mudar. Mandar mensagem para si mesmo funciona no WhatsApp comum como recurso de anotações, e não existe pela API. ### Como testar direito Com um segundo número, e um pouco de cuidado com a direção do teste. - Use um celular pessoal como destinatário de teste. Qualquer número de WhatsApp que não o conectado serve. - Para testar envio livre, faça o número de teste mandar mensagem primeiro, o que abre a janela de atendimento de 24 horas. - Para testar fora dessa janela, envie um template aprovado, que é a única coisa permitida ali. - Não registre um segundo número de negócio só para testar, a menos que precise: um número comum basta. - Enviar para o número conectado para testar. É recusado por desenho. - Achar que anotações pessoais funcionam pela API. Não funcionam. - Testar mensagem livre sem o cliente escrever antes, o que falha com 131047. **Posso mandar mensagem para meu próprio número?** Não. O WhatsApp não permite isso pela API. **Existe alguma configuração para isso?** Não. É regra da plataforma. **Com o que devo testar?** Qualquer outro número de WhatsApp, inclusive um celular pessoal. **Por que meu teste falhou com 131047 depois?** Porque uma mensagem livre exige que o cliente tenha escrito nas últimas 24 horas. --- ## Erro 131045 do WhatsApp: número não registrado https://easycoexistence.com/pt/docs/whatsapp-error-131045 O erro 131045 significa que o número de telefone não foi registrado para mensageria na Cloud API. Adicionar um número a uma conta do WhatsApp Business e registrá-lo para envio são passos separados, e este erro diz que o segundo não aconteceu. ### Por que existem dois passos Porque uma conta do WhatsApp Business pode conter números que não enviam nada. Adicionar um número estabelece a propriedade; registrá-lo ativa para mensageria na Cloud API e define o PIN de verificação em duas etapas. Numa configuração manual esses são chamados de API separados, e é fácil concluir o primeiro e esquecer o segundo. O número então aparece na conta, parece correto no painel, e recusa todo envio com este erro. ### O que resolve Depende de como o número chegou ali. - Numa configuração manual, chame o endpoint de registro para o phone number id com o PIN de duas etapas. - Num onboarding de Coexistência por um provedor, o registro acontece dentro do fluxo, então este erro costuma significar que o fluxo não terminou. - Se o número foi migrado recentemente de outra conta, o registro precisa ser refeito na conta nova. - Se o próprio registro falha, a causa costuma ser o PIN, que é o erro 133005. - Achar que um número visível no painel está pronto para enviar. Visível e registrado são coisas diferentes. - Abandonar o fluxo de onboarding no meio. Os últimos passos são justamente os que registram. - Confundir com o 133006, que é sobre verificação e não sobre registro. **O que é registro?** Ativar um número para mensageria na Cloud API, coisa separada de adicioná-lo à conta. **Preciso fazer isso eu mesmo?** Numa configuração manual, sim. Por um fluxo de Coexistência é feito por você. **Precisa ser refeito?** Só depois de migrar o número para outra conta. **E se o registro falhar?** Normalmente é o PIN de duas etapas, que devolve o erro 133005. --- ## Erro 133005 do WhatsApp: PIN incorreto da verificação em duas etapas https://easycoexistence.com/pt/docs/whatsapp-error-133005 O erro 133005 significa que o PIN da verificação em duas etapas informado durante o registro estava incorreto. É um PIN de seis dígitos definido quando o número foi registrado pela primeira vez, e palpites errados repetidos bloqueiam novas tentativas, então o caminho de recuperação importa mais do que repetir a requisição. ### De onde vem o PIN Ele é definido na primeira vez que o número é registrado para mensagens pela Cloud API e é exigido novamente em qualquer registro posterior, inclusive depois de migrar o número para outra conta. É nessa lacuna que o problema começa. Um PIN definido uma única vez na configuração e não usado por um ano raramente fica anotado, e quem o definiu muitas vezes já saiu da empresa. O erro aparece justamente quando o número está sendo movido ou registrado de novo, que já é um momento de pressão. ### Se ninguém sabe o PIN Existe um caminho, e ele é mais lento do que adivinhar, mas funciona de verdade. - Pare de adivinhar. Falhas repetidas retornam 133008 e bloqueiam as tentativas por um período. - Altere o PIN no WhatsApp Manager, nas configurações de verificação em duas etapas do número; não existe endpoint de API para desativá-la. - Um administrador também pode definir um novo PIN pela API, com um POST para o ID do número de telefone, e depois registrar o número de novo com ele. - Depois de recuperar, guarde o novo PIN em um lugar onde a próxima pessoa vá encontrá-lo. ### Como evitar da próxima vez Trate o PIN como infraestrutura, não como um dado pessoal. Ele deve ficar no mesmo lugar das credenciais da conta, sob responsabilidade da empresa e não de quem por acaso fez a configuração, e precisa sobreviver à saída dessa pessoa. O custo de não fazer isso não é o erro em si, que é trivial. É não conseguir migrar ou registrar de novo um número que funciona justamente quando você precisa. - Adivinhar repetidamente. Isso dispara o 133008 e um bloqueio. - Deixar o PIN com uma só pessoa em vez de com a empresa. - Achar que ele nunca mais será necessário depois da configuração. A migração exige o PIN. **Onde esse PIN foi definido?** Quando o número foi registrado pela primeira vez para mensagens pela Cloud API. **E se eu não souber o PIN?** Altere-o no WhatsApp Manager, nas configurações de verificação em duas etapas do número, ou defina um novo pela API. **O que acontece se eu continuar adivinhando?** As tentativas são bloqueadas e você recebe o erro 133008. **Quando o PIN é necessário?** No registro e novamente em qualquer novo registro ou migração. --- ## Erro 133008 do WhatsApp: tentativas de PIN demais https://easycoexistence.com/pt/docs/whatsapp-error-133008 O erro 133008 significa que houve tentativas incorretas demais do PIN de verificação em duas etapas, e novas tentativas ficam bloqueadas por um período. Ele vem depois de erros 133005 repetidos, e é por isso que a resposta certa a um PIN errado é parar, não tentar de novo. ### O que dispara Uma sequência curta de tentativas erradas de PIN, fácil de alcançar porque um PIN errado dá a sensação de valer uma segunda tentativa. Não vale. O primeiro 133005 é o sinal para achar o PIN direito em vez de chutar de novo. Uma vez bloqueado, o número não pode ser registrado até o período passar, mesmo que o PIN correto apareça no meio do caminho. ### O que fazer enquanto está bloqueado Use a espera em vez de brigar com ela. - Pare de tentar. Novas tentativas podem estender o bloqueio, não encurtar. - Ache ou redefina o PIN durante a espera: desative a verificação em duas etapas com um token de conta, ou peça ao suporte da Meta. - Confirme que está registrando o phone number id certo. Uma falha de PIN contra o número errado parece idêntica. - Planeje a nova tentativa para depois do período, em vez de ficar consultando. - Continuar tentando enquanto está bloqueado. Não ajuda e pode estender o bloqueio. - Esperar sem usar o tempo para redefinir o PIN direito. - Achar que o número foi banido. Bloqueio de PIN é temporário e não tem relação com política. **Quanto tempo dura o bloqueio?** Um período definido pela Meta. Tentativas durante ele podem estender em vez de encurtar. **Meu número foi banido?** Não. É bloqueio de verificação, sem relação com aplicação de política. **Dá para redefinir o PIN enquanto está bloqueado?** Dá, e é o melhor uso da espera. **Por que isso aconteceu?** Tentativas incorretas repetidas de PIN, cada uma delas devolvendo 133005. --- ## Erro 133006 do WhatsApp: número não verificado https://easycoexistence.com/pt/docs/whatsapp-error-133006 O erro 133006 significa que o número de telefone precisa ser verificado antes de ser registrado para mensageria. A verificação prova o controle do número por um código enviado por SMS ou chamada de voz, e é um passo separado tanto de adicionar quanto de registrar. ### Verificação contra registro A verificação prova que o negócio controla o número. O registro o ativa para mensageria na Cloud API. Acontecem nessa ordem, e este erro significa que o primeiro não concluiu. A exigência prática é que alguém consiga receber um código naquele número, por SMS ou por chamada de voz automática. Um número que ninguém atende não pode ser verificado, e esse é o verdadeiro impedimento na maioria dos casos, não a chamada de API. ### O que trava a verificação Quase sempre algo físico, não técnico. - Ninguém tem o aparelho ou o chip, comum em número herdado de um dono anterior. - O número é fixo e não recebe SMS, caso em que a verificação por voz é o caminho. - Um número virtual cujo provedor filtra ou atrasa o código. - O número já está registrado em outra conta do WhatsApp, o que precisa ser resolvido antes. - Tentar registrar antes de verificar. A ordem importa. - Escolher SMS num telefone fixo. A verificação por voz existe exatamente para isso. - Achar que um número virtual vai receber o código com segurança. Muitos não recebem. **Como faço a verificação?** Com um código enviado por SMS ou por chamada de voz automática para o próprio número. **E se for telefone fixo?** Use verificação por voz, que existe para números sem SMS. **É a mesma coisa que registro?** Não. A verificação prova controle; o registro ativa a mensageria. **Dá para pular?** Não. O registro vai continuar devolvendo este erro até ser feita. --- ## Erro 131050 do WhatsApp: o usuário saiu da lista https://easycoexistence.com/pt/docs/whatsapp-error-131050 O erro 131050 significa que o destinatário saiu da lista de mensagens do seu negócio. Não é uma falha e não existe contorno técnico: a pessoa fez uma escolha, e a resposta correta é registrar e parar de enviar. ### Por que não existe contorno Porque o mecanismo existe para proteger pessoas de negócios que não aceitam um não, e uma plataforma que permitisse burlar isso não valeria a pena para nenhum dos dois lados. A Meta também observa o que acontece depois. Continuar tentando enviar para quem saiu da lista alimenta os sinais por trás da classificação de qualidade, e uma classificação em queda custa capacidade de envio no número inteiro, não só para aqueles destinatários. ### O que fazer no lugar Registre direito, uma vez, e deixe o resto do sistema respeitar. - Guarde a saída da lista junto ao contato, para nada tentar de novo automaticamente. - Suprima o número em toda campanha e automação, não só na que disparou o erro. - Não tente alcançar a pessoa por um segundo número de negócio. É a mesma pessoa e a mesma escolha. - Se ela escrever para você depois, a janela reabre e você pode responder. Essa decisão é dela, não sua. - Repetir. O bloqueio é deliberado e permanente até a pessoa mudar de ideia. - Suprimir só na campanha que falhou, e outra tentar amanhã. - Usar outro número para alcançar a mesma pessoa. É a mesma escolha sendo ignorada. **Posso escrever para essa pessoa de novo?** Só se ela escrever primeiro, o que reabre a janela de atendimento. **Existe algum jeito de contornar?** Não, e tentar prejudica sua classificação de qualidade. **Isso afeta meu número inteiro?** A saída vale para aquele destinatário, mas tentativas repetidas afetam sua classificação de qualidade no geral. **Devo tirar a pessoa da minha lista?** Suprima em todo lugar, não só na campanha que falhou. --- ## Erro 130497 do WhatsApp: país do destinatário não permitido https://easycoexistence.com/pt/docs/whatsapp-error-130497 O erro 130497 significa que mensagens para o país do destinatário não são permitidas na sua conta. É restrição geográfica, não algo sobre o destinatário, e costuma refletir um limite da conta e não um erro na requisição. ### O que causa uma restrição por país Várias coisas, e nem todas são permanentes. - Conta nova ou não verificada, com limites que caem depois da verificação do negócio. - Um país sob restrição que a Meta aplica em toda a plataforma. - Um controle de nível de conta imposto durante revisão ou aplicação de política. - Um número formatado com o código de país errado, o que produz o erro para um país que você nunca quis alcançar. ### Descarte a formatação primeiro Porque é a única causa que você consegue corrigir sozinho, e é mais comum que as outras. Um telefone enviado com zero à esquerda, ou sem o código de país e com um padrão aplicado, resolve para um país diferente do pretendido. O envio então falha contra uma restrição de um país que não te interessa. Conferir se o número está em formato internacional, só dígitos, com o código de país correto, leva um segundo e elimina a causa mais provável. - Achar que o destinatário é o problema. A restrição é da sua conta com aquele país. - Repetir. Nada muda entre uma tentativa e outra. - Pular a conferência de formatação, que é a única causa sob seu controle. **O destinatário está me bloqueando?** Não. É uma restrição por país na sua conta. **Dá para remover?** Algumas são temporárias e caem com a verificação do negócio. Outras valem para toda a plataforma. **Pode ser erro de formatação?** Pode, e vale descartar primeiro. Um código de país errado resolve para o país errado. **Repetir ajuda?** Não. A restrição não muda entre tentativas. --- ## Erro 132007 do WhatsApp: violação de política no template https://easycoexistence.com/pt/docs/whatsapp-error-132007 O erro 132007 significa que o template viola a política de mensagens para empresas do WhatsApp. A mensagem não vai ser enviada na forma atual, e a correção é reescrever e reenviar o template, não mudar qualquer coisa na requisição. ### O que a política realmente proíbe Um conjunto mais estreito do que a maioria das pessoas imagina quando escreve o primeiro template. - Conteúdo que soa como promoção não solicitada para quem não pediu nada. - Categorias proibidas, incluindo certos produtos financeiros, de saúde e regulados. - Linguagem que representa mal quem envia ou sugere uma afiliação que não existe. - Urgência enganosa, ou qualquer coisa estruturada para pressionar uma resposta. ### Por que a categoria importa tanto quanto a redação Um template enviado como utilidade mas que se lê como marketing é um problema de política mesmo quando nada nele é questionável. A Meta categoriza os templates porque os dois carregam expectativas de consentimento diferentes, e uma mensagem promocional enviada sob a categoria de utilidade destrói isso. A regra prática é escrever o template para a categoria de forma honesta. Um template de marketing que assume ser marketing é aprovado. Um template de marketing vestido de aviso de entrega não é, e retrabalhar a redação sem mudar a categoria raramente salva ele. - Repetir o envio. O template é o problema, não a requisição. - Reenviar com edições cosméticas. Se a categoria está errada, a redação não vai salvar. - Achar que a aprovação é permanente. Um template pode ser desativado depois, sob o 132016. **Posso repetir o envio?** Não. O template precisa ser reescrito e reenviado para revisão. **Por que foi rejeitado se a redação parece boa?** Muitas vezes é a categoria. Uma mensagem de marketing enviada como utilidade é um problema de política independentemente da redação. **Quanto tempo leva o reenvio?** A revisão costuma ser rápida, mas não há tempo garantido. **Isso é o mesmo que o 132016?** Não. Aquele é um template desativado permanentemente depois de aprovado. --- ## Erro 132012 do WhatsApp: formato dos parâmetros do template divergente https://easycoexistence.com/pt/docs/whatsapp-error-132012 O erro 132012 significa que os valores de parâmetro enviados não batem com o formato que o template define. Um template com três variáveis precisa de exatamente três, na ordem e do tipo certo, e qualquer desvio produz esse erro em vez de um envio parcial. ### O que precisa se alinhar Tudo, e silenciosamente. Não existe correspondência parcial. - Quantidade: três marcadores no corpo significam três parâmetros de corpo, nem mais nem menos. - Ordem: os parâmetros são posicionais, então trocar dois produz uma mensagem enviada com os valores nos lugares errados, ou esse erro se os tipos forem diferentes. - Tipo: um parâmetro de moeda ou de data tem um formato de objeto definido e não pode ser enviado como texto simples. - Componentes: os parâmetros de cabeçalho, de corpo e de botão são listas separadas e não podem ser fundidos em uma só. ### A edição que quebra a produção Os templates são editados por pessoas que não são as pessoas que chamam a API. Alguém adiciona uma variável para deixar a mensagem mais clara, o template é aprovado de novo, e todo envio feito pela integração que não mudou começa a falhar. Vale se defender disso em vez de descobrir na hora. Assinar os webhooks de status de template faz com que uma edição chegue como um evento, e tratar a quantidade de variáveis de um template como parte do contrato da integração, revisada quando ela muda, impede que uma melhoria de redação vire uma queda de serviço. - Enviar um parâmetro a mais por precaução. Mais é tão errado quanto menos. - Tratar parâmetros posicionais como se fossem nomeados. Eles são combinados só pela posição. - Editar um template sem conferir o código que envia ele. **Quantos parâmetros eu envio?** Exatamente quantos o template define, e na ordem. **Posso enviar alguns a mais?** Não. Demais falha do mesmo jeito que de menos. **Por que isso começou a acontecer do nada?** Normalmente porque o template foi editado e a quantidade de variáveis dele mudou. **Os parâmetros têm nome?** Não. Eles são posicionais, então a ordem importa. --- ## Erro 132016 do WhatsApp: template desativado permanentemente https://easycoexistence.com/pt/docs/whatsapp-error-132016 O erro 132016 significa que o template foi desativado permanentemente e não pode ser usado de novo. Em geral é o fim de uma queda de qualidade: destinatários bloquearam ou denunciaram mensagens enviadas com ele, a classificação de qualidade do template caiu, e a Meta retirou ele. ### Como um template chega até aqui Raramente em um passo só. Um template aprovado de que os destinatários não gostam acumula bloqueios e denúncias, a classificação de qualidade dele cai de verde para amarelo e depois para vermelho, e ele é pausado. Pausas repetidas terminam em desativação permanente. Essa sequência é inteiramente observável para quem está ouvindo. O webhook de qualidade de template reporta cada mudança, e um template indo para amarelo é um aviso com tempo ainda no relógio. Ignorar isso é como um template que funciona vira um template inutilizável. ### O que fazer a respeito Duas coisas, nesta ordem. - Pare de enviar com ele e mude para outro template, porque este nunca mais vai funcionar. - Entenda por que os destinatários não gostaram dele antes de escrever o substituto, ou o substituto segue o mesmo caminho. - Confira o público, e não só a redação. Um bom template mandado para pessoas que não esperavam receber ainda junta bloqueios. - Assine os webhooks de qualidade de template para que a próxima queda fique visível no amarelo, e não já desativada. - Recriar o mesmo template com um nome novo. O conteúdo é o que falhou. - Ignorar as classificações de qualidade amarelas. O amarelo é o aviso, o vermelho é a consequência. - Culpar a redação quando o problema era o público. **Dá para reativar?** Não. Desativado permanentemente é permanente. **Posso recriar ele com outro nome?** Pode, mas o conteúdo é o que causou a queda, então ela provavelmente vai junto. **Qual a diferença para o 132015?** O 132015 é uma pausa, que passa. Esta aqui não passa. **Eu poderia ter visto isso chegando?** Sim. Os webhooks de qualidade de template reportam a queda antes de ela chegar a esse ponto. --- ## Erro 131056 do WhatsApp: mensagens demais para um destinatário https://easycoexistence.com/pt/docs/whatsapp-error-131056 O erro 131056 significa que muitas mensagens foram enviadas entre seu número de negócio e um único destinatário numa janela curta. É um limite de taxa por par, separado do throughput geral da conta, e quase sempre significa que uma automação está se repetindo. ### Por que o limite é por par Porque a falha da qual ele protege não é volume em geral, é uma pessoa sendo inundada. Uma conta pode estar folgada no throughput geral enviando trinta mensagens para um destinatário em um minuto, e quem está do outro lado vive isso como spam independente do total da conta. O limite se aplica então ao par e não à conta, e é por isso que ele aparece num número de baixo volume que nunca chegou perto do limite geral. ### O que costuma causar Quase sempre algo automático, não alguém digitando. - Um laço de repetição que trata falha de entrega como falha de envio e manda de novo. - Um handler de webhook que responde e é invocado mais de uma vez para o mesmo evento. - Um chatbot quebrando uma resposta em várias mensagens curtas em sequência. - Um script de teste enviando para o mesmo número repetidamente durante o desenvolvimento. ### Como evitar Limitando no nível da conversa, não só no da conta. Um teto de mensagens por destinatário por minuto, aplicado antes do envio, custa quase nada e evita tanto este erro quanto a experiência de cliente por trás dele. Deduplicar mensagem importa igual. Eventos de webhook podem ser entregues mais de uma vez, e um handler que responde sem checar se já tratou aquele message id vai produzir exatamente esse padrão sob carga. - Repetir, o que manda mais uma mensagem para o destinatário que já está sendo inundado. - Limitar só no nível da conta. Este limite é por destinatário. - Tratar eventos de webhook sem deduplicar por message id. **Isso é o limite de taxa da minha conta?** Não. Aquele é o 130429. Este é por destinatário. **Por que num número de baixo volume?** Porque o limite vale para o par, não para o total da conta. **Como faço parar?** Limite por conversa e deduplique eventos de webhook por message id. **Devo repetir?** Não. Repetir manda mais uma mensagem para o mesmo destinatário. --- ## Erro 80007 do WhatsApp: limite de taxa na conta do WhatsApp Business https://easycoexistence.com/pt/docs/whatsapp-error-80007 O erro 80007 significa que a conta do WhatsApp Business bateu num limite de taxa. Ele vale para chamadas de gestão e leitura, não para throughput de mensagens, então a causa comum é consulta em laço: algo checando status muito mais vezes do que o dado muda. ### O que ele conta Chamadas contra a conta, não mensagens para clientes. - Ler números, suas classificações de qualidade e seus níveis de throughput. - Listar e ler templates de mensagem. - Chamadas de assinatura e de configuração de webhook. - Qualquer checagem de status rodando em agenda, que é de onde o volume costuma vir. ### Consulta em laço é a causa que vale corrigir Uma checagem de status a cada trinta segundos em alguns números dá milhares de chamadas por dia contra um dado que muda poucas vezes por mês. Ela bate no limite em algum momento, e quando bate a checagem para de funcionar exatamente quando algo interessante aconteceu. Webhooks invertem isso. A Meta empurra mudança de classificação de qualidade, atualização de conta ou mudança de status de template quando acontece, o que não custa chamada nenhuma e chega mais rápido que qualquer consulta. A arquitetura certa é webhook para mudança, com consulta reservada a uma conferência esporádica em vez de ser o mecanismo principal. - Consultar status em intervalo curto. Queima o limite com um dado que raramente muda. - Reagir acrescentando repetições, o que consome o limite mais rápido. - Confundir com o 130429, que é sobre enviar mensagens. **Isso é sobre enviar mensagens?** Não. Aquele limite é o 130429. Este cobre chamadas de gestão e leitura. **O que causa?** Normalmente consultar status em intervalo curto. **O que fazer no lugar?** Assinar webhooks e reservar a consulta para conferência esporádica. **Isso passa sozinho?** Passa, quando a janela vira, mas volta se a consulta não mudar. --- ## Coexistência do WhatsApp para agências e consultorias https://easycoexistence.com/pt/whatsapp-coexistence-for-agencies Agências batem na mesma parede em todo cliente: o número é um que a equipe dele já atende, e migrar tira o app do WhatsApp Business das mãos deles. A Coexistência elimina isso, então um número de cliente conecta sem ninguém mudar o jeito de trabalhar. ### Por que números de cliente travam a maioria das integrações? Porque o número não é seu para mexer, e tudo nele já está em uso. O número do cliente está impresso em veículos, notas fiscais, num site e em anos de conversas passadas. Alguém atende pelo celular o dia inteiro e conhece os habituais pelo nome. No instante em que a proposta envolve migrar aquele número, o app do WhatsApp Business para de funcionar nele e essa pessoa tem que se mudar para o que você construiu. A maioria dos clientes diz não, e faz bem. É por isso que tantas agências foram parar em gateways não oficiais. Eles mantinham o celular funcionando, que era a única coisa que o cliente se importava, e o risco de banimento ficava invisível até deixar de ficar. A Coexistência é a versão oficial da mesma promessa. ### Como é o onboarding de um cliente na prática? O cliente faz uma coisa, no próprio celular, e leva cerca de dois minutos. Você manda um link de conexão. Ele abre, o popup da própria Meta roda, ele escolhe o Portfólio de Negócios e o número, e lê um código no app do WhatsApp Business. É esse o pedido inteiro. Nada é instalado, nenhuma credencial é entregue, e o app continua funcionando no momento em que a leitura termina. O número fica no Portfólio de Negócios dele, não no seu, e isso importa por dois motivos. É a resposta quando um cliente pergunta de quem é a conexão, e significa que a relação sobrevive a ele trocar de agência, o que é mais fácil prometer do que explicar depois. ### Como isso fica com vinte clientes? Uma conta, vinte números, um valor fixo cada, e uma lista que dá para ler. Não existe faixa a superar nem plano que muda num limiar. Adicionar o vigésimo primeiro cliente é a mesma operação do primeiro. Cada número informa a própria classificação de qualidade, nível de mensageria e estado de conexão, então um cliente cujo número está escorregando fica visível antes de ele te ligar por causa disso. Essa visibilidade é a maior parte do valor nessa escala. Uma conexão falha em silêncio, o app do WhatsApp Business continua funcionando em quase toda falha, e o cliente não tem como saber. Sem monitoramento, o primeiro sinal é um cliente perguntando por que a automação parou, que é uma conversa que começa mal. ### Um agente pode fazer o onboarding no lugar de uma pessoa? Quase tudo, e a parte que não pode é justamente a que o cliente precisa fazer de qualquer jeito. Pelo conector MCP, um assistente pode chamar get_connect_link para gerar o link que o cliente abre, depois set_webhook_destination para apontar aquele número ao sistema seu que vai tratar dele, e então checar a saúde do número para confirmar que está tudo vivo. É a sequência inteira sem ninguém abrir um painel. O que ele não pode é ler o código. O onboarding da Meta roda num navegador e precisa do celular que tem o número, o que é proteção deliberada e não lacuna. O cliente é a única pessoa que pode autorizar o próprio número, e é assim que deve ser. - Prometer ao cliente que a equipe dele não vai notar, e então migrar o número. Migração tira o app e eles notam na hora. - Conectar números de cliente sob o seu próprio Portfólio de Negócios. Mantenha cada um no do cliente, para a conexão ser dele. - Tratar monitoramento como opcional em escala. Vinte modos de falha silenciosa em vinte clientes é carga de suporte, não caso raro. **Cada cliente precisa de conta própria com vocês?** Não. Uma conta guarda todos os números que você gerencia, cada um cobrado à parte, e o conector lista todos. Não há restrição de usar para negócios que você atende. **De quem é a conexão, minha ou do cliente?** O número fica no Portfólio de Negócios do cliente. Você gerencia a conexão, e a relação de fundo com a Meta é dele, que é a resposta honesta quando ele pergunta. **O que acontece se um cliente sair?** O número é desconectado e o app do WhatsApp Business dele segue exatamente como antes. Nada no número é alterado permanentemente por ter sido conectado. **Quem paga a Meta pelas mensagens?** O cliente, pelo meio de pagamento na própria conta do WhatsApp Business. Essas cobranças nunca passam por nós, então não há onde ninguém colocar margem. --- ## O que é ser um Meta Tech Provider, e por que isso importa https://easycoexistence.com/pt/meta-tech-provider Um Meta Tech Provider roda o próprio app da Meta num Business Manager verificado e pode conectar números de WhatsApp de outros negócios por ele. A EasyCoexistence é um, e é por isso que um número conecta direto no seu próprio portfólio em vez de ficar sob a conta de um revendedor. ### O que um Tech Provider faz na prática? Ele roda o app pelo qual outros negócios conectam seus números de WhatsApp. Quando um negócio faz o onboarding, o Embedded Signup da Meta abre e pede autorização para um app. Esse app é do Tech Provider, e uma vez autorizado pode agir sobre o número em nome dele: ler o status, enviar mensagens, gerenciar templates e definir onde os webhooks são entregues. Tudo o que um provedor oferece é construído sobre essa relação. O status é o que torna isso legítimo. A Meta concede a uma empresa com app próprio num Business Manager verificado, depois do App Review, e é o que separa um provedor de um script segurando as credenciais de alguém. ### Por que importa de quem é o app? Porque isso decide a qual conta o número do seu cliente acaba preso. Ferramenta construída sobre a conta de provedor de outra pessoa herda as restrições daquela conta. É daí que vêm os limites de conexão única com que as pessoas esbarram em plataformas de automação genéricas: a plataforma tem uma relação de provedor e todo mundo que a usa divide aquela. Com app próprio, a conexão é feita direto entre o Portfólio de Negócios do cliente e a Meta. O número continua sendo dele, não há revendedor segurando, e adicionar o próximo é a mesma operação do primeiro. Para uma agência isso não é detalhe técnico, é a resposta quando um cliente pergunta quem controla o número dele. ### O que o status exige? Um Business Manager verificado, um app que passe no App Review, e demonstrações gravadas dos fluxos. A verificação de negócio amarra o app a uma pessoa jurídica real, com documentos que a Meta confere em registros. O App Review examina o que o app pede e por quê, e para WhatsApp inclui vídeos gravados mostrando o onboarding funcionando de ponta a ponta. Nada disso custa dinheiro e tudo leva tempo, que é a parte que não dá para comprimir. Isso vale saber se você está pensando em construir o seu. Conectar um único número que é seu não precisa de nada disso. Conectar números para clientes precisa de tudo isso, e a espera se mede em semanas enquanto o trabalho se mede em dias. ### O que muda para o negócio que conecta um número? Três coisas, e nenhuma aparece na interface. O número é conectado no Portfólio de Negócios dele, então a relação com a Meta é dele. A Meta cobra as conversas direto na conta do WhatsApp Business dele, que é também por que ninguém no meio consegue colocar margem nisso. E não existe teto de quantos números uma conta pode ter, porque não há relação de provedor compartilhada sendo dividida. O que não muda é o onboarding em si. O Embedded Signup é o fluxo da própria Meta, o popup é da Meta, e a leitura do código acontece no app do WhatsApp Business. Um Tech Provider não substitui nada disso, é o que torna aquilo disponível. - Achar que todo provedor tem status próprio de Tech Provider. Muitos são construídos sobre o de outra pessoa, e é daí que vêm os limites de conexão. - Planejar obter o status com prazo. O tempo do App Review não é algo que uma empresa controla. - Tratar como selo. É uma relação de conta, e decide qual portfólio guarda o número do cliente. **Isso quer dizer que a Meta endossa a EasyCoexistence?** Não, e nenhum provedor deveria insinuar o contrário. Tech Provider é um status técnico que permite conectar números de outros negócios por um app aprovado. Não é endosso do produto construído sobre ele. **Eu posso virar Tech Provider?** Pode. É gratuito e aberto a qualquer empresa com Business Manager verificado disposta a passar pelo App Review. O custo é a espera, não uma taxa. **Qual Portfólio de Negócios guarda meu número?** O seu. A conexão é feita entre o seu portfólio e a Meta, com nosso app autorizado a agir sobre o número. Ele não passa para a nossa conta. **Existe limite de quantos números posso conectar?** Não. Os limites com que as pessoas esbarram em outros lugares vêm de dividir uma relação de provedor entre muitos usuários, que não é como isto funciona. --- ## Quanto custa a Coexistência do WhatsApp, provedor por provedor https://easycoexistence.com/pt/whatsapp-coexistence-pricing-compared Os provedores cobram em três unidades diferentes: por número, por assento ou por mensagem. Isso torna os preços de vitrine incomparáveis e o custo real só aparece para uma quantidade definida de números. Esta página faz a conta com um, dez e cinquenta números. ### Por que os preços de vitrine não são comparáveis? Porque cobram por coisas diferentes, e a unidade define para qual tipo de negócio cada um serve. A cobrança por número acompanha quantos números de WhatsApp você mantém. É a unidade que uma agência de fato controla, e é a que EasyCoexistence, 360dialog e Dualhook usam. A cobrança por assento e por contato acompanha quantas pessoas respondem e com quantos clientes você conversa. É o que WATI e respond.io usam, e é a unidade certa quando o produto comprado é uma equipe de atendentes. A cobrança por mensagem acompanha apenas o volume, que é o modelo da Twilio: sem taxa de plataforma e sem valor por número, mas com uma cobrança em cada mensagem, além do que a Meta cobra. Portanto, a única comparação honesta é feita com uma quantidade declarada de conexões, que é o que a tabela abaixo faz. ### Quanto custam os provedores cobrados por plataforma nas mesmas quantidades? Não dá para colocá-los na mesma coluna com honestidade, porque o valor deles não varia com a quantidade de números. O que varia são assentos e contatos. Os planos publicados da WATI vão de três a dez usuários, com 500 a 2.500 contatos ativos por mês. A respond.io publica US$ 79 para cinco usuários e 1.000 contatos, subindo até US$ 279. A YCloud publica um plano gratuito, depois US$ 39, US$ 89 e US$ 399, com usuários e canais como complementos a US$ 10 e US$ 5 cada por mês. Para uma equipe de suporte com um número, esses planos são competitivos e incluem uma caixa de entrada que uma conexão não inclui. Para uma agência com cinquenta números de clientes, o custo aparece nas linhas de complementos, e aparece por canal, não por conversa. A pergunta que decide é se alguém vai de fato entrar na caixa de entrada que você está pagando. ### E a Twilio, que não cobra nenhum dos dois? A Twilio publica uma tarifa por mensagem de US$ 0,005 em cada direção, além das tarifas de template da própria Meta, que repassa sem margem. Não há taxa mensal de plataforma nem valor por número na tabela de preços publicada. Isso a torna a forma mais barata de manter um número que quase não envia nada, e a mais cara de operar um número movimentado. Cinquenta números parados não custam nada; cinquenta números com conversas reais custam por mensagem, para sempre. Vale saber também que a página de preços da Twilio não trata da Coexistência. Se manter o app do WhatsApp Business funcionando no número é importante para você, essa é a pergunta a fazer a eles antes de comparar qualquer outra coisa. ### Qual deles uma agência deve escolher? Aquele cuja unidade corresponde ao que cresce no seu negócio. Se o que cresce são números de clientes, a cobrança por número com desconto por volume é o único formato que não pune você por ter sucesso. A EasyCoexistence custa US$ 9 por número até cinco números e cai para US$ 1 cada conforme você adiciona números, de modo que, com cinquenta clientes, cada número custa menos do que o primeiro, e não mais. Se o que cresce são atendentes respondendo em uma caixa de entrada, uma plataforma cobrada por assento é a compra certa, e esta página não vai argumentar o contrário. WATI e respond.io construíram isso e funciona. Se o que cresce é o volume de mensagens em poucos números, vale simular o modelo por mensagem da Twilio contra os outros, na sua taxa real de envio. Para o caso para o qual este produto foi feito, uma agência ou um desenvolvedor que mantém números que não são seus, a cobrança por número com preço por volume é a única que cresce na mesma direção do negócio: o valor por número cai conforme a quantidade sobe. - Comparar diretamente os preços de vitrine. Eles são cobrados em três unidades diferentes e o menor valor costuma ser a escolha errada. - Presumir que algum deles aplica margem sobre os custos de mensagem da Meta. Nenhum dos desta página aplica; a Meta cobra você. - Tratar um recurso não documentado como um recurso ausente. Quando uma página de preços não menciona a Coexistência, pergunte ao provedor em vez de confiar nesta tabela. **Esses preços estão atualizados?** São os publicados na página de preços de cada provedor em setembro de 2026, com link nos valores acima. Preços mudam, então confira a fonte antes de decidir. **Por que a EasyCoexistence fica mais barata por número?** Porque o custo de acompanhar uma conexão não cresce na mesma proporção da quantidade delas. Uma agência com cinquenta números não dá cinquenta vezes mais trabalho, então não paga cinquenta vezes mais. **Algum deles aplica margem sobre as cobranças da Meta?** Nenhum dos provedores desta página aplica. A Meta cobra os custos de mensagem no meio de pagamento da sua própria conta do WhatsApp Business, e é por isso também que ninguém no meio consegue dar desconto. **Quais provedores oferecem suporte à Coexistência?** YCloud e 8x8 a documentam, e Dualhook e EasyCoexistence são construídos em torno dela. Várias outras páginas de preços não tratam do assunto, o que não é prova em nenhum dos sentidos e vale perguntar diretamente. --- ## Glossário da Coexistência do WhatsApp https://easycoexistence.com/pt/whatsapp-coexistence-glossary Os termos em volta da Coexistência do WhatsApp são fáceis de confundir, e a maior parte da confusão na prática vem de duas pessoas usando uma palavra para coisas diferentes. Estas são as definições que este site usa, cada uma ligada à página que a cobre direito. ### Por que o vocabulário dá tanto problema? Porque vários destes termos nomeiam coisas em níveis diferentes que parecem todas do mesmo nível. Um Portfólio de Negócios contém uma conta do WhatsApp Business, que contém números de telefone, cada um com um phone number id. Na conversa os quatro viram a conta, e uma frase como confere se a conta está funcionando pode significar quatro verificações diferentes. O mesmo acontece com as duas janelas de vinte e quatro horas desta plataforma, que medem coisas sem relação e são trocadas uma pela outra o tempo todo. A outra metade é que a Meta e os provedores usam palavras diferentes para a mesma coisa, e os provedores também não concordam entre si. Esta página usa o vocabulário da própria Meta onde ele existe, e diz claramente quando um termo é nosso. ### Quais distinções importam de fato na prática? Três, e cada uma já custou um dia de alguém. A janela de atendimento e a janela de sincronização têm ambas vinte e quatro horas e nada a ver uma com a outra. Uma governa se o texto livre entrega, contada a partir da última mensagem do cliente. A outra governa se o histórico ainda pode ser puxado, contada a partir do onboarding. Um dispositivo vinculado não é uma API. É o cliente comum do WhatsApp logado em outro lugar, que é o que ferramentas não oficiais automatizam e o que derruba números. E destino de webhook não é uma configuração do número. É um override na assinatura de um app a uma conta, e é por isso que ele some quando uma conexão é removida e precisa ser reposto na reconexão. **Coexistência é uma API diferente da Cloud API?** Não. Coexistência é um jeito de conectar um número à Cloud API que deixa o app do WhatsApp Business funcionando nele. Os endpoints, o formato de mensagem e as regras são idênticos. **Qual a diferença entre Portfólio de Negócios e WABA?** O Portfólio de Negócios é o contêiner de nível de empresa no Meta Business Manager. Uma conta do WhatsApp Business fica dentro dele e guarda os números. Um portfólio pode conter várias WABAs. **BSP é a mesma coisa que Tech Provider?** Se sobrepõem, mas descrevem coisas diferentes. Tech Provider é um status da Meta que permite a uma empresa conectar números de outros negócios pelo próprio app. BSP costuma descrever uma empresa que vende uma plataforma de mensageria, que pode ou não ter esse status. **O que MCP tem a ver com WhatsApp?** Nada por natureza. MCP é um protocolo para dar a um assistente de IA acesso a uma ferramenta, e um servidor MCP de WhatsApp expõe um número como uma dessas ferramentas. Ele não recebe mensagens, só age quando solicitado. --- ## Campos do webhook do WhatsApp, e para onde cada um vai https://easycoexistence.com/pt/docs/webhook-fields Uma conta do WhatsApp Business entrega eventos como campos nomeados. Dois carregam conteúdo de conversa e são roteados para o seu endpoint. Seis carregam estado operacional e são a base do monitoramento. Saber qual é qual decide a sua arquitetura. ### O que cada campo carrega? messages carrega tudo o que um cliente envia para o número: texto, referências de mídia, respostas e reações. smb_message_echoes carrega o que a sua equipe envia pelo app do WhatsApp Business, que só existe em um número com Coexistência e é como o software enxerga as respostas de uma pessoa. account_update carrega o estado da conexão: PARTNER_REMOVED quando o app é desinstalado da conta, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, e eventos de restrição ou de violação. phone_number_quality_update carrega mudanças de classificação de qualidade e de throughput. account_alerts carrega alertas que a Meta levanta contra a conta, e account_review_update carrega o resultado de uma revisão. business_capability_update carrega mudanças de limite de mensagens e de capacidades, e phone_number_name_update carrega aprovações e recusas do nome de exibição. ### Por que essa separação importa na arquitetura? Porque ela decide se o conteúdo das conversas chega ou não a um provedor. O override manda os dois campos de mensagem para o seu endpoint direto da Meta. Os seis campos operacionais seguem para o provedor, e é isso que torna possível ter painel e alertas sem ninguém guardar uma mensagem. É também por isso que a afirmação de não armazenar mensagens pode ser estrutural, e não apenas uma política. Se os campos de mensagem são entregues em outro lugar, não existe caminho de código no qual eles poderiam ser armazenados. No nosso caso, uma conta sem override cai no callback padrão, onde o handler descarta esses eventos sem persistir nada. ### Quais campos o seu handler deve esperar? Só os dois campos de mensagem, se o override estiver definido, e vale escrever o handler para ignorar qualquer outra coisa em vez de falhar com ela. A Meta acrescenta campos com o tempo e o formato de um payload pode ganhar chaves sem aviso. Um handler que decide pelo nome do campo e ignora o que não reconhece continua funcionando; um que presume um formato quebra no primeiro evento desconhecido. Também vale tratar smb_message_echoes de forma explícita em vez de encarar como ruído. Sem ele, o software não tem ideia de que uma pessoa já respondeu, e é assim que um cliente acaba com duas respostas para a mesma pergunta. - Presumir um payload genérico. Todo evento nomeia o seu campo, e o handler deve decidir por ele. - Ignorar smb_message_echoes. Sem ele o software responde em cima de uma pessoa que já respondeu. - Falhar em campos não reconhecidos em vez de pular. A Meta acrescenta campos sem pedir licença. **Posso receber apenas alguns campos?** O override move o caminho de mensagem para você. A separação operacional é fixa, porque o monitoramento é construído a partir dela. **smb_message_echoes existe em um número Cloud API normal?** Não. Ele existe porque um número com Coexistência tem uma pessoa enviando pelo app além do software enviando pela API. **O que acontece com os eventos de mensagem se eu não definir destino?** Eles chegam ao nosso callback padrão e são descartados sem serem persistidos. **Os nomes dos campos são da Meta ou seus?** Da Meta. Nada aqui é um nome que inventamos, e é por isso que vale aprender uma vez. --- ## Verificando um endpoint de webhook do WhatsApp https://easycoexistence.com/pt/docs/webhook-verification Antes de entregar qualquer evento, a Meta chama o seu endpoint com um GET que leva hub.mode, hub.verify_token e hub.challenge. O seu endpoint precisa comparar o token e devolver o challenge como corpo puro da resposta. Qualquer outra coisa e a entrega nunca começa. ### O que exatamente a Meta envia? Uma requisição GET para a sua URL com três parâmetros de query. hub.mode vem com o valor subscribe. hub.verify_token é o token que você configurou ao definir o destino. hub.challenge é um valor que a Meta gera para essa tentativa. O seu endpoint deve comparar hub.verify_token com o token que você escolheu e, se combinar, responder 200 com hub.challenge como todo o corpo da resposta. Sem embrulhar em JSON, sem aspas em volta, sem a quebra de linha no final que alguns frameworks acrescentam por padrão. Se o token não combinar, responda 403. Esse é o protocolo inteiro, e ele é pequeno de propósito. ### Por que uma resposta errada falha em silêncio? Porque a verificação falhar não é um erro no seu sistema, é uma ausência no da Meta. Quando o challenge não é devolvido corretamente, a Meta simplesmente não começa a entregar naquele destino. O seu servidor devolve 200 para a verificação, os seus logs mostram que uma requisição chegou, e nenhum painel em lugar nenhum relata problema. O único sintoma é que as mensagens nunca chegam, o que a maioria das pessoas diagnostica como problema de Coexistência em vez de problema de handshake. É por isso que validar antes da chamada vale a pena. Nós checamos que a URL é HTTPS e que um verify token foi informado antes de fazer a requisição no Graph, então um destino malformado falha na hora em vez de parecer conectado. ### O que mais pode bloquear a verificação? Três coisas que não têm nada a ver com o código. Autenticação na frente do endpoint. Um gateway, uma camada de basic auth ou uma lista de IPs permitidos vai recusar a requisição da Meta, e a Meta não tem credencial nenhuma para apresentar. A rota de verificação precisa estar acessível sem isso. Um redirecionamento. A Meta chama a URL que você deu, e um 301 para um host canônico não é seguido de um jeito que complete o handshake. Entregue a URL final. E um framework que serializa a resposta. Devolver uma string de um handler que embrulha tudo em JSON produz um corpo com aspas em volta do challenge, e isso não combina. - Devolver JSON. O corpo precisa ser o valor puro do challenge, sem nada em volta. - Colocar o endpoint atrás de autenticação. A Meta não tem credenciais e vai ser recusada. - Dar à Meta uma URL que redireciona. Use a final. **Que token eu devo usar?** Qualquer texto que você escolher. Ele existe para o seu endpoint distinguir a requisição da Meta da de qualquer um que descubra a URL. **Com que frequência a verificação acontece?** Na configuração, e de novo sempre que o destino é definido. Um endpoint que funciona não é reverificado em cada evento. **Posso testar por conta própria?** Sim. Chame o seu próprio endpoint com os três parâmetros e confira que o corpo volta exatamente como o valor do challenge. **E se o meu servidor estava fora durante a verificação?** O handshake falha e o destino não é ativado. Salvar de novo faz a verificação rodar outra vez. --- ## mcp-tools-reference | Referência das ferramentas MCP https://easycoexistence.com/pt/docs/mcp-tools-reference O conector expõe dezesseis ferramentas sobre todos os números de uma conta. A list_numbers vem primeiro porque toda outra ferramenta recebe um connection_id dela. Seis ficam bloqueadas quando a cobrança atrasa: as quatro que agem sobre o mundo externo, a get_api_credentials, que devolve o token de acesso, e a create_connect_link. As outras dez, as leituras de saúde e de templates e a configuração da Partner API, continuam abertas. ### O que cada ferramenta faz? Leitura: a list_numbers devolve os números conectados com status, classificação de qualidade e nível de mensagens, e é de onde toda outra chamada parte. A get_number_health devolve um retrato ao vivo da Meta mais a linha do tempo recente de monitoramento, eventos de webhook e checagens do poller juntos. A get_api_credentials devolve a URL base da Graph API, o id da WABA, o phone number id e, quando disponível, o token de acesso da própria conta. Envio: a send_message manda texto livre dentro da janela de 24 horas, onde as respostas são gratuitas. A send_template manda um template aprovado, que é como se inicia uma conversa com alguém que não escreveu. A list_templates, a create_template e a get_template_status cobrem o ciclo de vida do template. Conexão: a set_webhook_destination encaminha mensagens recebidas e ecos do app para o seu sistema, e passar null redefine isso. A get_connect_link devolve o link do painel e os passos para conectar um número novo. A get_docs devolve a documentação do produto em markdown. Partner API, para software ou agências cujos próprios clientes conectam números: a get_partner_setup mostra a cobrança, a chave de API, a URL de eventos e o próximo passo. A create_api_key emite a chave da Partner API e mostra uma única vez, e não substitui uma chave existente sem confirmação explícita. A revoke_api_key revoga a chave, também após confirmação. A set_partner_events_url define para onde vão os eventos de status e devolve o segredo de assinatura uma única vez. A create_connect_link cria um link de conexão hospedado para um cliente, válido por 1 hora, igual ao POST /api/v1/connect-sessions. ### Por que o connection_id importa? Porque é ele que amarra uma instrução a um número específico, e um assistente não tem como adivinhar. Toda ferramenta que age sobre um número recebe um connection_id, e a list_numbers é o único lugar de onde um deles vem. Na prática isso significa que um assistente a quem se pede para enviar uma mensagem vai chamar a list_numbers antes, e é por isso que a primeira requisição de uma sessão costuma ser mais lenta que as demais. Também significa que uma conta com vários números fica sem ambiguidade por construção. Não existe número padrão nem seleção implícita, então uma instrução que não identifica de qual número se trata é perguntada, em vez de chutada. ### O que acontece quando a cobrança atrasa? Seis ferramentas ficam bloqueadas: send_message, send_template, create_template e set_webhook_destination, que agem sobre o mundo externo; get_api_credentials, porque devolve o token de acesso da conta, com o qual uma conta bloqueada poderia enviar direto pela Graph API; e create_connect_link, que conecta um número novo. Toda outra leitura continua disponível, assim como a configuração da Partner API: get_partner_setup, create_api_key, revoke_api_key e set_partner_events_url. Isso é de propósito, e não um descuido. Uma conta que não consegue ver por que está bloqueada, ou não consegue checar se os números dela estão saudáveis, não tem caminho de volta a não ser um chamado de suporte. Essas mesmas leituras também são do que o monitoramento de saúde depende, então bloqueá-las desligaria o monitoramento no exato momento em que alguém mais precisa dele. O efeito prático é que uma conta atrasada ainda responde perguntas sobre o próprio estado e segue monitorada. O que para é qualquer coisa que alcance um cliente. - Esperar que o conector receba mensagens. O MCP é requisição e resposta; o tráfego de entrada precisa de um webhook. - Fixar um connection_id no código. Ele vem da list_numbers e não é um valor para anotar. - Achar que uma conta atrasada está totalmente fora do ar. As leituras e o monitoramento continuam de propósito, exceto as credenciais, que carregam o token que envia. **Sou eu que escolho qual ferramenta chamar?** Não. Você pede em linguagem comum e o assistente escolhe, que é justamente para o que as descrições das ferramentas foram escritas. **Ele consegue ler as minhas conversas?** Não. As mensagens recebidas vão para o destino de webhook que você indicar. O conector lê o estado da conta e dos números. **A get_docs é útil?** Mais do que parece. Ela entrega ao assistente a nossa documentação em markdown, então respostas sobre as regras de Coexistência vêm dos nossos documentos, e não da memória. **Um conector cobre vários clientes?** Sim. Uma conta guarda quantos números você precisar e a list_numbers devolve todos eles. --- ## connecting-a-number | Conectando um número, passo a passo https://easycoexistence.com/pt/docs/connecting-a-number Conectar passa pelo Embedded Signup da própria Meta: escolha o Portfólio de Negócios, a Conta do WhatsApp Business e o número, depois escaneie um código no app do WhatsApp Business. Cerca de dois minutos, e o app continua funcionando o tempo todo. ### O que acontece no fluxo? O popup da Meta abre e pergunta três coisas, em ordem. Primeiro o Portfólio de Negócios, que é o contêiner no nível da empresa dentro do Business Manager. Depois a Conta do WhatsApp Business dentro dele. Depois o número de telefone, que precisa ser um já registrado no app do WhatsApp Business, porque a Coexistência conecta um número que o app está usando, em vez de criar um. Depois disso o fluxo vai para o celular. A Meta mostra um código, alguém abre o app do WhatsApp Business no aparelho que tem aquele número, e escaneia. Esse é o único passo que sai do navegador, e é o passo que ninguém mais consegue fazer no lugar da empresa. ### O que é decidido durante o onboarding e não pode ser mudado? Se o histórico de conversas existente será compartilhado, o que é perguntado uma vez e é definitivo para aquela conexão. Dizer sim sincroniza o histórico recente de conversas para a API, então o software começa com contexto em vez de às cegas. Dizer não significa que a API só enxerga as mensagens a partir do momento em que ela conecta. As duas escolhas são razoáveis, e a maioria das integrações se importa com conversas novas, mas a decisão não pode ser revista sem desconectar e conectar de novo. Também existe uma janela sobre isso. A sincronização precisa ser iniciada dentro de 24 horas do onboarding, e só pode rodar uma vez. Perder qualquer um dos dois produz um erro pouco familiar em vez de um aviso, e é por isso que vale decidir sobre o histórico no mesmo dia, e não durante o trabalho de integração. ### O que deve estar pronto antes de começar? Três coisas, e tê-las evita que o fluxo seja abandonado no meio. Acesso ao Portfólio de Negócios que é dono do número, que normalmente é o dono da empresa, e não quem está fazendo a integração. O celular com o número, desbloqueado e com o app do WhatsApp Business instalado. E, de preferência, o destino do webhook, porque defini-lo no fim do onboarding é mais limpo do que lembrar depois. Se o fluxo for fechado antes de terminar, o número pode acabar vinculado à conta mas não registrado, o que produz um erro no primeiro envio. Rodar o fluxo de novo desde o começo resolve. - Começar sem o celular por perto. O escaneamento não pode ser feito depois, de outro aparelho. - Fechar o popup assim que o número aparece. O fluxo tem passos depois disso e parar deixa o número não registrado. - Deixar a decisão sobre o histórico para quando a integração estiver pronta. Ela expira 24 horas depois do onboarding. **Posso conectar um número que não é meu?** Só a empresa dona dele pode autorizar. Você manda um link e ela completa o fluxo no próprio celular. **O app para de funcionar durante o onboarding?** Não. Ele continua funcionando o tempo todo, inclusive enquanto o código está sendo escaneado. **E se o número estiver no app comum do WhatsApp?** Ele precisa ser movido para o app do WhatsApp Business antes. A Coexistência conecta um número do app Business. **Posso refazer o fluxo?** Pode. Desconectar e conectar de novo roda tudo outra vez, inclusive uma chance nova de aceitar o histórico de conversas. --- ## A janela de atendimento de 24 horas https://easycoexistence.com/pt/docs/customer-service-window A janela de atendimento abre quando um cliente manda mensagem para o seu número e dura 24 horas. Dentro dela você pode enviar texto livre, e essas respostas são gratuitas. Fora dela, só um template aprovado pela Meta vai ser entregue. ### Quando exatamente o relógio começa a contar? Quando o cliente envia uma mensagem, e ele reinicia a cada nova mensagem que o cliente manda. Esse é o detalhe que as pessoas entendem ao contrário. A janela não é medida a partir da sua última mensagem, nem do começo da conversa, nem do momento em que um ticket foi aberto. Ela é medida a partir da mensagem de entrada mais recente do cliente, o que significa que uma conversa ativa na prática nunca fecha e uma conversa de mão única fecha depois de um dia. Isso também significa que a janela é por contato, e não por número. Um cliente pode estar dentro dela enquanto outro está fora, no mesmo número, no mesmo instante. ### O que pode ser enviado dentro e fora dela? Dentro, qualquer coisa: texto livre, mídia e templates, se você quiser usá-los. Fora, apenas um template que a Meta já aprovou. É por isso que os templates existem. Eles são a forma autorizada de começar ou recomeçar uma conversa com alguém que não escreveu, e são revisados com antecedência justamente porque o destinatário não convidou aquela mensagem. Num número em Coexistência existe uma consequência extra. O app do WhatsApp Business não consegue enviar templates, então qualquer coisa fora da janela tem que passar pela API. Uma equipe que atende pelo celular pode responder livremente a uma conversa viva e não consegue recomeçar uma conversa fria, e essa é uma das razões práticas para um número ser conectado. ### Por que as integrações descobrem isso em produção? Porque o teste sempre acontece dentro da janela. Quem constrói a integração manda uma mensagem para si mesmo e responde a ela segundos depois. Isso está dentro das 24 horas, então o texto livre funciona e todo teste passa. O primeiro caso real que falha é um cliente que escreveu ontem, o que normalmente acontece depois do lançamento. O formato que se sustenta é uma bifurcação antes do envio: verifique há quanto tempo aquele contato escreveu pela última vez e siga pelo caminho do texto livre ou pelo caminho do template. Fazer isso desde o começo custa quase nada. Adaptar depois significa encontrar cada envio no código. - Medir a partir da sua própria última mensagem. É a dele que abre a janela. - Tratar a janela como se fosse por número. Ela é por contato, então duas conversas no mesmo número podem estar em estados diferentes. - Testar somente logo depois de uma mensagem, o que está sempre dentro da janela. **A janela pode ser estendida?** Não. Ela é fixada pela Meta e nenhum provedor consegue alongá-la. **Uma resposta por template reabre a janela?** O cliente respondendo reabre. Enviar um template, por si só, não abre uma janela de texto livre. **As respostas são realmente gratuitas?** A Meta não cobra pelas mensagens enviadas dentro da janela de atendimento. O que ela cobra são as conversas abertas fora dela. **E aquela outra janela de 24 horas sobre a qual eu li?** Essa é a janela de sincronização, contada a partir do onboarding, e ela rege o histórico de conversas, não o envio. As duas não têm relação. --- ## Templates de mensagem do WhatsApp https://easycoexistence.com/pt/docs/message-templates Um template é uma mensagem submetida à Meta para revisão com antecedência. Depois de aprovado, ele pode ser enviado a qualquer momento, inclusive para alguém que nunca escreveu. É a única coisa que é entregue fora da janela de atendimento de 24 horas. ### Para que servem as três categorias? Elas dizem à Meta que tipo de mensagem é aquela, e a categoria muda tanto a revisão quanto a cobrança. Utilidade cobre mensagens transacionais ligadas a algo que o cliente fez: uma atualização de pedido, uma confirmação de reserva, um aviso de entrega. Marketing cobre conteúdo promocional, e enviar uma dessas exige uma forma de pagamento na WhatsApp Business Account. Autenticação cobre códigos de uso único e tem um formato próprio, mais rígido. Escolher a categoria errada é um motivo comum de rejeição. Linguagem promocional dentro de um template de utilidade é pega, e é pega com constância suficiente para não valer a tentativa. ### Como funcionam as variáveis? Marcadores numerados, preenchidos em ordem, contados por componente. Um corpo que diz Olá {{1}}, seu pedido {{2}} foi enviado define duas variáveis, e um envio precisa fornecer exatamente dois valores para o corpo. Os parâmetros de cabeçalho e de botão são contados separadamente, em vez de juntos numa lista só, e é por isso que um envio com o total correto ainda pode ser rejeitado. A Meta também exige valores de exemplo quando um template é criado, para que o revisor veja como fica uma mensagem real. E há regras de posicionamento: uma variável logo no começo ou no fim da mensagem, ou variáveis demais para a quantidade de texto em volta, são igualmente rejeitadas. ### Por que o app do celular não consegue enviá-los num número em Coexistência? Porque templates são um recurso da plataforma, e não do app, e o app não tem nenhum conceito equivalente. Essa é uma das coisas mais úteis de saber cedo. Um negócio conectado por Coexistência mantém a equipe atendendo pelo celular, e essa equipe pode responder a qualquer conversa viva. O que ela não consegue fazer pelo app é recomeçar uma conversa que esfriou, porque isso exige um template, e templates só existem pela API. Então qualquer coisa agendada, transacional ou dirigida a alguém que não escreveu hoje é, por definição, trabalho de API. Para muitos negócios é exatamente essa a lacuna que a conexão foi feita para preencher. - Criar um template e enviá-lo na mesma execução. A Meta revisa antes, normalmente em minutos, às vezes em um dia. - Juntar as variáveis de cabeçalho e de corpo numa lista só. Elas são contadas por componente. - Usar linguagem de marketing num template de utilidade. É um motivo de rejeição constante. **Quanto tempo leva a revisão?** Normalmente minutos, às vezes até um dia. Nenhum provedor consegue acelerar isso. **Um template é por idioma?** Sim. Nome e idioma juntos identificam um template, então o mesmo nome em outro locale é outro template. **Posso editar um template aprovado?** Pode, e editar muda o contrato de variáveis, o que quebra os remetentes que fixaram a contagem antiga no código. **Preciso de uma forma de pagamento?** Para envios de marketing, sim, na sua própria WhatsApp Business Account. A Meta exige isso e nenhum provedor pode cadastrar uma por você. --- ## O webhook account_update, e cada motivo de desconexão https://easycoexistence.com/pt/docs/webhook-account-update account_update é como a Meta informa que uma conexão mudou de estado. O campo event nomeia o que aconteceu e, em uma remoção, disconnection_info.reason nomeia o porquê. Esse motivo é a diferença entre um número que vai voltar e um que se foi. ### Que eventos o account_update carrega? PARTNER_REMOVED, quando o app é desinstalado da conta do WhatsApp Business. Esse é o sinal definitivo de desconexão e o que vale usar como base, em vez de deduzir uma desconexão de um campo que virou false. ACCOUNT_OFFBOARDED, quando o número sai por completo. ACCOUNT_RECONNECTED, quando uma conexão antes removida volta. E os eventos de aplicação de regras: ACCOUNT_RESTRICTION e ACCOUNT_VIOLATION, junto de eventos cujos nomes incluem DISABLED ou BAN. Resultados de verificação e de aprovação também chegam aqui, com nomes de evento contendo VERIFIED ou APPROVED. Um handler deve decidir pelo nome do evento e tratar qualquer coisa não reconhecida como informativa em vez de falhar, porque a Meta acrescenta eventos sem aviso. ### Quais são os motivos de desconexão? São seis, e significam coisas bem diferentes. PRIMARY_INACTIVITY é a regra dos aproximadamente catorze dias: o app do WhatsApp Business não foi aberto no dispositivo principal. Recuperável, e de longe o mais comum. COMPANION_INACTIVITY é a mesma ideia em um dispositivo vinculado, com uma janela maior, de cerca de trinta dias. BUSINESS_DOWNGRADE quer dizer que o número voltou para o app do WhatsApp comum, o que encerra a Coexistência, porque a Coexistência exige o app Business. CHANGE_NUMBER quer dizer que o próprio número de telefone mudou. USER_RE_REGISTERED quer dizer que ele foi registrado de novo em um novo aparelho. E ACCOUNT_DISCONNECTED quer dizer que o cliente desconectou de propósito, ou que a aplicação de regras desconectou. O motivo também chega junto de disconnection_info.initiated_by, que diz se foi uma pessoa ou o sistema. ### Por que o motivo importa mais que o evento? Porque PARTNER_REMOVED sozinho não diz se você deve agir. Um número removido por PRIMARY_INACTIVITY vai voltar: a empresa abre o app, reconecta, e tudo volta a funcionar. Tratar isso como um cliente que foi embora produz um e-mail de cancelamento para alguém que continua sendo cliente. Um número removido por BUSINESS_DOWNGRADE ou ACCOUNT_DISCONNECTED é outra situação, e tratar como temporário deixa uma conexão no limbo para sempre. Quando uma remoção chega sem motivo nenhum, initiated_by é o recurso alternativo: uma remoção feita por uma pessoa se lê como deliberada, e uma feita pelo sistema sem explicação não. Essa distinção vale ser feita no código, e não em uma conversa de suporte depois. - Tratar todo PARTNER_REMOVED igual. O motivo separa duas semanas de silêncio de um cliente que foi embora. - Deduzir a desconexão de um campo que virou false em vez de usar este evento. É isso que produz alarme falso. - Falhar em um nome de evento não reconhecido. A Meta acrescenta eventos e o handler deve pular o que não conhece. **PARTNER_REMOVED é permanente?** Em geral não. A maioria chega com PRIMARY_INACTIVITY, o que quer dizer que o app ficou sem ser aberto e reconectar restaura tudo. **Reconectar restaura o destino do meu webhook?** Não, e essa é a armadilha. O destino é um override na assinatura do app e é desinstalado junto com ele. Precisa ser aplicado de novo. **O que é COMPANION_INACTIVITY?** A mesma ideia de inatividade em um dispositivo vinculado em vez do principal, com uma janela maior, de cerca de trinta dias. **Posso receber este evento sem motivo?** Sim. Quando isso acontece, disconnection_info.initiated_by é o único sinal de se foi deliberado. --- ## O webhook phone_number_quality_update https://easycoexistence.com/pt/docs/webhook-phone-number-quality-update O phone_number_quality_update informa mudanças de throughput e de limite de mensagens de um número. Em 2026 ele não carrega a classificação de qualidade verde, amarela ou vermelha, apesar do nome, e essa classificação precisa ser consultada no número. ### O que este webhook realmente contém? Informação de throughput e de limite de mensagens, entregue como um valor de evento mais campos que carregam o limite atual. O conteúdo prático é que a capacidade de um número mudou: ele foi para outra faixa de mensagens, ou o nível de throughput dele foi ajustado. Esses dados valem ser registrados porque mudam o que uma integração consegue fazer, e porque uma faixa que desce é um sinal precoce. O que não está nele, apesar do nome do campo, é a classificação de qualidade. Um handler escrito com base em documentação antiga vai procurar GREEN, YELLOW ou RED aqui, não vai achar nada, e então vai concluir que a qualidade nunca muda. ### De onde vem a classificação por cor, então? De ler o número de telefone diretamente, em uma rotina periódica. O campo quality_rating fica no objeto do número de telefone na Graph API, e ele precisa ser consultado em vez de esperado. É por isso que monitorar uma conexão direito exige um poller além de um receptor de webhook: os dois carregam coisas diferentes e nenhum dos dois basta sozinho. É também por isso que uma queda de qualidade é invisível para a maioria das integrações. Nada empurra essa informação, o app do WhatsApp Business não dá nenhum sinal dela, e quando ela produz o erro 131048 os envios afetados já falharam. - Procurar GREEN, YELLOW ou RED neste payload. Em 2026 isso não está lá. - Montar o monitoramento só com webhooks. A classificação de qualidade precisa ser consultada. - Ignorar uma queda de faixa. Costuma ser o primeiro sinal visível de um problema. **Por que o campo tem nome de qualidade, então?** Ele é anterior à mudança. O nome ficou enquanto o conteúdo mudou, e é por isso que isso pega as pessoas de surpresa. **Com que frequência a classificação deve ser consultada?** Com frequência suficiente para pegar a queda antes de virar limite. Consultamos em uma rotina periódica, e não sob demanda. **O app mostra a classificação?** Não. Nada sobre ela aparece no app do WhatsApp Business no celular. **O 131048 tem relação?** Sim. É o erro que um número passa a devolver quando uma classificação baixa vira limitação. --- ## O webhook smb_message_echoes https://easycoexistence.com/pt/docs/webhook-smb-message-echoes O smb_message_echoes entrega o que a sua equipe envia pelo app do WhatsApp Business. Ele existe só em números com Coexistência, porque só eles têm uma pessoa enviando pelo celular além do software enviando pela API. ### Por que esse campo existe? Porque a Coexistência cria uma situação para a qual a API não foi construída no começo: duas coisas enviando de um único número. Em um número Cloud API comum, o software é o único remetente, então não há nada a informar. Em um número com Coexistência a equipe continua respondendo pelo celular, e sem uma forma de enxergar isso o software estaria operando às cegas sobre metade de cada conversa. O echo fecha essa lacuna. Quando alguém digita uma resposta no app do WhatsApp Business, ela chega ao seu endpoint como um evento, com o mesmo formato de uma mensagem recebida, mas marcada como saída da empresa. ### O que quebra se você ignorar? O cliente é respondido duas vezes, e isso parece descuido. A sequência de sempre é o cliente perguntar algo às oito da manhã, uma pessoa pegar a conversa no celular em menos de um minuto, e uma automação que nunca viu aquela resposta responder a mesma pergunta três minutos depois. Do lado do cliente, isso é uma empresa que não sabe o que ela mesma já disse. Tratar disso não é complicado. Registre o echo na conversa exatamente como faria com uma mensagem recebida, e confira se houve atividade recente antes de enviar. O que torna isso perigoso é que é invisível em teste, porque uma conversa de teste não tem uma pessoa respondendo. - Tratar os echoes como ruído e descartar. Eles são o único sinal de que uma pessoa já respondeu. - Presumir que o campo existe em todo número. Ele é específico da Coexistência. - Testar sem uma pessoa no fluxo, que é justamente o cenário em que o problema nunca aparece. **Os echoes incluem mídia?** Eles informam o que foi enviado, inclusive referências a mídia, no mesmo formato das mensagens recebidas. **Isso existe em um número Cloud API normal?** Não. Sem Coexistência não há uma pessoa enviando por um app, então não há nada para ecoar. **Posso desligar?** Ele vem junto com o caminho de mensagem. Rotear esse caminho para o seu endpoint inclui ele, e ignorar no código é uma escolha com consequências. **Isso tem algum custo?** Não. É um evento de webhook, não um envio de mensagem. --- ## O webhook messages https://easycoexistence.com/pt/docs/webhook-messages messages é o campo que carrega tudo o que um cliente envia para o seu número: texto, mídia, respostas, reações e retornos interativos. Em um número com Coexistência roteado, ele vai da Meta direto para o seu endpoint, e nunca passa por um provedor. ### O que o payload carrega Uma ou mais mensagens em uma única entrega, cada uma com o remetente, um id e um tipo. O tipo decide quais outras chaves estão presentes. - O número de telefone de quem enviou, e o phone number id do número para o qual escreveram. - Um id de mensagem wamid, que é a base da eliminação de repetições. - Um timestamp unix. - Um tipo: text, image, audio, video, document, sticker, location, contacts, reaction, button ou interactive. - Para tipos de mídia, um id de mídia para buscar o arquivo, e não os bytes em si. ### Por que ele nunca chega a nós em um número roteado Porque o override move este campo, junto de smb_message_echoes, para o destino que você indicar. A Meta permite que um app sobrescreva para onde uma conta do WhatsApp Business entrega os webhooks dela. Nós apontamos esse override para a sua URL, o que tira o caminho de mensagem da nossa infraestrutura por completo. Não existe cópia, nem fila, nem retenção do nosso lado, porque a entrega nunca chega lá. Quando nenhum destino é definido, esses eventos caem no nosso callback padrão, onde o handler os descarta sem persistir. Essa é a diferença entre uma afirmação sobre armazenamento e um caminho de código: não há para onde o conteúdo de conversa ir. ### Confirmando o recebimento do jeito certo Devolva 200 antes de fazer o trabalho, não depois. A Meta trata uma resposta lenta como falha e repete a entrega, o que significa que um handler que processa na mesma requisição vai ver a mesma mensagem mais de uma vez. Responda na hora, coloque o payload em uma fila ou em uma tarefa de segundo plano, e deixe o trabalho acontecer fora da requisição. Em serverless isso não é opcional. Uma função que responde e depois continua trabalhando pode ser congelada no instante em que responde, então a confirmação e o processamento precisam ser de fato separados. ### Eliminando repetições Pelo wamid, sempre, porque repetir a entrega é normal, e não excepcional. A mesma mensagem pode chegar duas vezes por motivos que não têm nada a ver com um bug do seu lado: uma resposta lenta, um timeout de rede, um deploy no meio da entrega. Guardar os ids já vistos e pular os repetidos são poucas linhas, e é a diferença entre um cliente ser respondido uma vez e ser respondido duas. Em um número com Coexistência isso importa ainda mais, porque smb_message_echoes chega pelo mesmo caminho e um handler que trata todo evento como novo vai responder em cima de uma pessoa que já respondeu. - Processar antes de devolver 200. A Meta repete a entrega lenta e você trata a mensagem duas vezes. - Pular a eliminação de repetições. As repetições são por projeto, não um caso extremo. - Esperar os bytes da mídia no payload. Ele carrega um id de mídia para buscar o arquivo. **A EasyCoexistence vê as mensagens dos meus clientes?** Não. O override entrega este campo no seu endpoint. Qualquer coisa que chegue ao nosso callback de reserva é descartada sem ser persistida. **Podem chegar várias mensagens em uma requisição?** Sim. Uma única entrega pode trazer mais de uma, então os handlers devem percorrer a lista em vez de ler só a primeira. **Como eu pego a mídia?** O payload carrega um id de mídia. Busque a URL com ele usando o token de acesso do número, e então baixe. **O que é smb_message_echoes?** O campo companheiro que carrega o que a sua equipe envia pelo app do WhatsApp Business. Ele só existe em números com Coexistência. --- ## O webhook phone_number_name_update https://easycoexistence.com/pt/docs/webhook-phone-number-name-update O phone_number_name_update carrega o resultado do envio de um nome de exibição. O campo decision diz se a Meta aprovou ou recusou o nome, e este evento é o único lugar em que esse resultado é informado: nada sobre ele aparece no app do WhatsApp Business. ### O que ele informa O resultado do envio de um nome de exibição, como uma decisão no evento. O nome é o que os clientes veem acima de uma conversa, e mudá-lo o coloca em revisão pela Meta. O que faz valer a pena assinar este evento é que nada mais diz o que aconteceu. O app do WhatsApp Business não mostra nada, e uma empresa que enviou uma mudança semanas antes não tem como saber se ela passou, a menos que alguém esteja recebendo isso. Registrar em uma linha do tempo transforma o "será que a mudança do nosso nome passou" de uma conversa de suporte em um fato com data. ### Por que um nome é recusado Principalmente porque ele não corresponde ao negócio sob o qual a conta está verificada. - Um nome que bate com a razão social, com um nome fantasia registrado ou com a marca no site tende a passar. - Uma descrição genérica, ou um nome sem ligação com o negócio verificado, tende a não passar. - Qualquer coisa que se leia como palavra-chave em vez de nome é pega de forma consistente. ### O que a falta de nome bloqueia Certos envios, e é assim que a maioria das pessoas descobre que o nome nunca foi aprovado. Um número sem nome de exibição aprovado devolve o erro 131037 em operações que exigem um. Essa falha parece defeito de código para quem esbarra nela, porque todo o resto no número funciona, e em geral ela é rastreada até uma conexão de teste em que a etapa do nome foi pulada e nunca revisitada. Enviar um nome faz parte de configurar um número direito, e não é uma etapa cosmética, então vale fazer isso no dia em que o número conecta. - Achar que silêncio quer dizer aprovado. A decisão chega aqui e em nenhum outro lugar. - Enviar uma palavra-chave em vez de um nome. A Meta confere contra o negócio verificado. - Pular o nome de exibição durante um teste, e então esbarrar no 131037 em um envio que exige um. **Quanto tempo leva a revisão?** A Meta não publica um prazo fixo, e nenhum provedor consegue acelerar isso. **Posso mudar o nome depois?** Pode, e cada mudança passa por revisão de novo, produzindo outro evento aqui. **O cliente também vê o meu número?** Ele vê o nome de exibição aprovado, que é justamente o motivo de ter um. **O que é o erro 131037?** É o que um número devolve quando não tem nome de exibição aprovado e tenta algo que exige um. --- ## O webhook message_template_status_update https://easycoexistence.com/pt/docs/webhook-message-template-status-update O message_template_status_update informa uma mudança no estado de revisão de um template: aprovado, recusado, pausado ou desativado. É o que permite a uma integração enviar um template e depois ser avisada do resultado, em vez de consultar a Meta em intervalos e adivinhar de quanto em quanto tempo perguntar. ### Os status que ele carrega Um template passa por um conjunto pequeno de estados, e cada mudança chega aqui. - Aprovado: o template pode ser enviado a partir de agora. - Recusado: ele não pode, e o motivo acompanha o evento. - Pausado: a qualidade caiu o suficiente para a Meta suspender o template temporariamente. - Desativado: pausas repetidas terminaram em uma parada permanente, e é preciso um template novo. ### Por que isso elimina a consulta periódica Porque a alternativa é perguntar várias vezes e adivinhar a frequência. Sem este evento, uma integração que cria um template precisa consultar get_template_status em algum intervalo até a resposta mudar. Com frequência demais é desperdício; com frequência de menos, um template fica aprovado por uma hora antes de alguém perceber. Com ele, o fluxo é enviar e esperar. A Meta empurra o resultado, em geral em minutos, e a integração reage uma vez. Para uma agência que cria templates em nome de clientes, essa é a diferença entre uma fila que se esvazia sozinha e uma que alguém precisa ficar olhando. ### O que fazer em cada resultado Aprovado é o simples: marque como enviável. Os outros três é onde está o valor. Recusado traz um motivo, que vale mostrar literalmente em vez de resumir, porque o motivo costuma ser específico o bastante para agir, e uma paráfrase perde isso. Pausado quer dizer que o conteúdo produziu reações ruins, e reenviar depois que a pausa acabar produz o mesmo resultado. É um convite a editar, e não a esperar. Desativado é final para aquele template. O único caminho adiante é um novo, com conteúdo diferente, e tratar como temporário deixa um caminho de envio quebrado por tempo indeterminado. - Ficar consultando pela aprovação quando este evento a informa. - Resumir um motivo de recusa em vez de mostrar. Os detalhes são o que torna o motivo acionável. - Esperar um template desativado voltar. Esse estado é permanente e exige um template novo. **Quanto tempo costuma levar a aprovação?** Em geral minutos, às vezes até um dia. Nenhum provedor consegue acelerar isso. **Um template pausado é o mesmo que um desativado?** Não. A pausa acaba depois de um período; a desativação é permanente e vem depois de pausas repetidas. **A recusa diz o motivo?** Sim, e o motivo é específico o bastante para agir, e é por isso que vale repassar sem editar. **Posso enviar outros templates enquanto um está pausado?** Pode. O estado vale para aquele template, e não para o número. --- ## O webhook message_template_quality_update https://easycoexistence.com/pt/docs/webhook-message-template-quality-update O message_template_quality_update informa uma mudança em como as pessoas estão reagindo a um template específico. Ele chega antes de a qualidade virar uma pausa, o que faz dele o único sinal de template que dá tempo de agir em vez de uma falha para explicar depois. ### O que ele está medindo Como as pessoas reagem às mensagens enviadas com um template específico, e não ao número como um todo. Bloqueios e denúncias pesam mais, e não interagir de jeito nenhum também conta alguma coisa. Essa restrição a um template é o que torna o sinal útil. Um número pode estar saudável no geral enquanto um template envenena em silêncio o próprio público, e este é o evento que separa as duas coisas. Sem ele, o primeiro sinal é aquele template deixando de enviar enquanto todo o resto no número funciona normalmente. ### Por que agir cedo é o ponto inteiro Porque todo estado depois deste é pior e mais difícil de desfazer. A qualidade caindo o suficiente pausa o template, que passa a devolver o erro 132015 em cada tentativa e só volta depois de um período que a Meta não publica. Pausas repetidas o desativam em definitivo, e a partir daí o conteúdo precisa ser reconstruído como um template novo, com outro nome. Um sinal de qualidade que chega enquanto o template ainda envia é o único momento em que editar não custa nada. Depois de pausado, editar continua sendo o movimento certo, mas um caminho de envio já ficou quebrado pelo tempo que ninguém percebeu. ### O que costuma causar isso Conteúdo e público, nessa ordem, e o segundo é o que as pessoas esquecem. - Linguagem promocional dentro de um template declarado como utilidade, que quem recebeu não esperava. - Uma mensagem que não deixa claro qual empresa está escrevendo. - Enviar para uma lista em vez de para pessoas que interagiram recentemente. - O mesmo template saindo em volume para um público que nunca pediu por ele. - Tratar como informativo. É o último sinal que chega enquanto o template ainda funciona. - Ler como um problema do número. Ele é restrito a um template. - Editar o texto e manter o mesmo público. Para quem vai produz os mesmos sinais que o que está escrito. **Isso afeta os meus outros templates?** Não. O sinal é restrito a um template, e os outros no mesmo número não são afetados. **Consigo ver isso no app?** Não. Nada sobre a qualidade de template aparece no app do WhatsApp Business no celular. **O que acontece se eu ignorar?** A qualidade continuar caindo pausa o template, e pausas repetidas o desativam em definitivo. **Editar o texto basta?** Muitas vezes, mas nem sempre. Para quem o template é enviado produz os mesmos sinais que o que ele diz. --- ## O webhook history https://easycoexistence.com/pt/docs/webhook-history O history carrega a transferência única das conversas que um número com Coexistência já tinha para a API. Ele chega depois da integração, quando o compartilhamento de histórico foi aceito, e é o único sinal que uma integração recebe de que a transferência aconteceu. ### O que ele entrega O histórico de mensagens individuais que um número já tinha no app do WhatsApp Business, trazido para o outro lado, para que o software não comece às cegas em uma linha que uma empresa usa há anos. O que não vem junto são as conversas em grupo, que ficam totalmente fora da API em um número com Coexistência, e as ferramentas do próprio app: etiquetas, respostas rápidas, mensagens de saudação e de ausência não têm equivalente na API e ficam no aparelho. Este campo existe apenas em números com Coexistência. Um número integrado do jeito comum não tem histórico anterior de app para trazer, então não há nada para ele entregar. ### Por que ele dispara uma vez só Porque a transferência faz parte da integração, e não é uma capacidade contínua. O dono do negócio é perguntado durante o Embedded Signup se quer compartilhar as conversas existentes. Responder que sim é o que permite a sincronização rodar, e não há configuração que ligue isso de novo depois nem endpoint que repita. Uma segunda tentativa devolve 2593107, e não um limite de taxa que passa. Também existe um prazo. A sincronização precisa ser iniciada em até 24 horas da integração, e tentar depois devolve 2593108. Perder qualquer um dos dois significa desconectar o número e rodar o fluxo inteiro de novo. ### O que um handler deve fazer com isso Tratar como um lote que chega uma vez e pode ser grande, e não como mais tráfego no caminho de mensagem. - Confirme rápido e processe de forma assíncrona, como em qualquer outra entrega. - Elimine repetições pelo id da mensagem: o histórico e as mensagens ao vivo podem se sobrepor perto do momento da integração. - Espere que ele não venha. Um número cujo dono recusou o histórico não envia nada aqui, e a integração precisa funcionar dos dois jeitos. - Não bloqueie a integração por causa dele. A conexão já é utilizável antes de a transferência terminar. - Construir uma integração que exige a existência de histórico. Muitos números conectam sem ele. - Repetir a sincronização depois do 2593107. É um evento único, então a repetição devolve o mesmo erro. - Deixar a decisão sobre o histórico para quando o trabalho de integração começar, o que em geral é depois de a janela de 24 horas fechar. **Quanto histórico chega?** Uma janela de conversas individuais recentes, definida pela Meta e não por um provedor. **As conversas em grupo vêm junto?** Não. Os grupos ficam totalmente fora da API em um número com Coexistência. **Posso pedir de novo mais tarde?** Não. Roda uma vez por integração, e rodar de novo significa desconectar e reconectar o número. **E se o dono recusou o histórico?** Nada chega neste campo, e a API vê apenas as mensagens a partir do momento em que o número conectou. --- ## O webhook smb_app_state_sync https://easycoexistence.com/pt/docs/webhook-smb-app-state-sync O smb_app_state_sync carrega estado do próprio app do WhatsApp Business, principalmente a sincronização de contatos que roda quando um número com Coexistência conecta. Ele é separado do history, que carrega conversas, e existe apenas em números com Coexistência. ### O que ele carrega Estado do lado do app, o que na prática quer dizer os contatos que uma empresa já tinha no celular. Todo contato com um número de WhatsApp pode ser sincronizado para a plataforma, e é isso que permite ao software reconhecer um cliente que está na agenda da empresa há anos em vez de tratar como um número novo. Isso é diferente das conversas em si, que chegam no campo history, e os dois são separados porque um é uma lista de contatos e o outro é uma transcrição. Assim como o history, isso só existe na Coexistência. Não há estado de app para sincronizar em um número que nunca esteve em um. ### O que ele não carrega As ferramentas de trabalho do próprio app, que não têm representação do lado da plataforma. - Etiquetas, que ficam no aparelho e não podem ser lidas pelo software. - Respostas rápidas e as mensagens de saudação e de ausência. - O catálogo, os pedidos e o status. - Canais, e o histórico de chamadas de voz ou de vídeo. ### Por que isso importa para uma integração Porque decide se o seu sistema sabe quem está escrevendo já no primeiro dia. Sem a sincronização de contatos, cada mensagem recebida chega como um número de telefone sem nome nenhum, e casar isso com um registro de cliente é problema seu. Com ela, a lista de contatos da própria empresa fica disponível e o casamento já está quase todo feito. Vale planejar para os dois casos, porque uma empresa pode recusar a sincronização ou perder a janela, e uma integração que presume que os contatos existem vai mostrar uma parede de números crus para quem abrir. - Presumir que os contatos vão estar lá. Uma empresa pode recusar a sincronização ou perder a janela dela. - Esperar etiquetas ou respostas rápidas neste payload. Elas ficam no aparelho. - Confundir com o history, que carrega conversas em vez da lista de contatos. **Isso é o mesmo que a sincronização de histórico?** Não. Este carrega estado do app, principalmente contatos. O history carrega as conversas. **Ele roda mais de uma vez?** A sincronização inicial é uma etapa única da integração, com a mesma janela de 24 horas do history. **Eu recebo as etiquetas?** Não. Etiquetas são um recurso do app sem equivalente na API. **Isso existe em um número Cloud API normal?** Não. Não há estado do app do WhatsApp Business para sincronizar em um número assim. --- ## O webhook template_category_update https://easycoexistence.com/pt/docs/webhook-template-category-update O template_category_update informa que a Meta reclassificou um template, movendo entre utilidade, marketing e autenticação. Isso importa porque a categoria decide quanto a Meta cobra por uma conversa, então uma reclassificação muda os seus custos sem ninguém editar coisa alguma. ### Por que uma categoria muda sozinha Porque a Meta revisa o que um template de fato diz, e não apenas como ele foi declarado. Um template enviado como utilidade que carrega uma oferta é conteúdo promocional vestindo um rótulo mais barato. Às vezes isso é pego na revisão e recusado. Às vezes é aprovado e reclassificado depois, quando o conteúdo já foi visto em uso, e esse segundo caso é o que este evento informa. Nada do seu lado dispara isso. O template está igual, o código está igual, e o primeiro sinal sem este evento é uma fatura que não bate com a previsão. ### O que isso muda O preço de cada conversa que aquele template abrir dali em diante. - A Meta cobra preços diferentes por conversas de utilidade, de marketing e de autenticação. - Os envios de marketing exigem ainda uma forma de pagamento na conta do WhatsApp Business. - Um template reclassificado como marketing em uma conta sem forma de pagamento passa a devolver 131042. - O template em si continua funcionando; o que muda é quanto ele custa e o que ele exige. ### Como evitar ser reclassificado Declarar com honestidade, que sai mais barato do que otimizar. Um template de utilidade descreve algo que o cliente fez: um pedido, uma reserva, uma entrega. Se uma mensagem não existiria sem uma ação que o cliente tomou, ela é utilidade. Se ela existe porque você quer vender alguma coisa, ela é marketing, e declarar assim custa menos do que ser movido para lá depois, em um momento que você não escolheu. Enviar templates mal categorizados repetidas vezes também chama atenção para a própria conta, e esse é um desfecho pior do que pagar a tarifa de marketing em uma mensagem de marketing. - Declarar conteúdo promocional como utilidade para pagar menos. A reclassificação chega depois e em um momento pior. - Ignorar este evento. Ele muda a cobrança sem mudar nada que você controla. - Presumir que a aprovação é final. Um template pode ser aprovado e movido em seguida. **O template para de funcionar?** Não. Ele continua enviando; o que muda é o preço da conversa e, no marketing, a exigência de forma de pagamento. **Posso contestar uma reclassificação?** A Meta trata disputas de categoria pelos canais dela; nenhum provedor consegue mudar uma categoria. **Qual categoria é a mais barata?** A Meta cobra preços diferentes por mercado. A categoria correta mais barata é aquela que descreve a mensagem com honestidade. **O que é o 131063?** Templates de marketing desativados na conta, o que é diferente de não ter forma de pagamento. --- ## meta-business-portfolio | O Portfólio de Negócios da Meta, e o que fica dentro dele https://easycoexistence.com/pt/docs/meta-business-portfolio Um Portfólio de Negócios é o contêiner no nível da empresa dentro do Meta Business Manager. Ele guarda Contas do WhatsApp Business, que guardam números de telefone. Quando um cliente conecta um número, ele permanece no portfólio dele, em vez de ir para o de um provedor. ### Como os níveis se encaixam? São três níveis, e chamar todos eles de conta é onde a maior parte da confusão começa. O Portfólio de Negócios fica no topo, representando a empresa dentro do Meta Business Manager. Ele guarda ativos: contas de anúncio, páginas e Contas do WhatsApp Business. Dentro de uma Conta do WhatsApp Business ficam os números de telefone, cada um com o próprio phone number id, classificação de qualidade e nível de mensagens. Então uma frase como verifica se a conta está funcionando pode significar quatro verificações diferentes dependendo de quem está falando. Quando algo está errado, ser preciso sobre qual nível você quer dizer economiza a maior parte do tempo de diagnóstico. ### Por que importa de quem é o portfólio que guarda o número? Porque isso decide quem de fato controla a conexão. Quando o onboarding roda pelo app do próprio Tech Provider, o número é conectado dentro do portfólio do cliente, com o app do provedor autorizado a agir sobre ele. A relação com a Meta pertence ao cliente, a cobrança das conversas vai para o meio de pagamento dele, e revogar o acesso é algo que ele mesmo consegue fazer. Quando uma ferramenta é construída sobre a conta de provedor de outra pessoa, os números acabam vinculados de outro jeito, e os limites que as pessoas encontram em plataformas de automação de propósito geral vêm dessa relação compartilhada. Para uma agência, isso é a resposta a uma pergunta que todo cliente sério acaba fazendo. - Usar portfólio e WABA como sinônimos. Um guarda o outro e eles falham de maneiras diferentes. - Conectar os números dos clientes dentro do seu próprio portfólio. Isso faz a conexão ser sua, e não deles. - Achar que a verificação de negócio fica no número. Ela fica no nível do portfólio. **Um portfólio é a mesma coisa que uma Conta do WhatsApp Business?** Não. O portfólio é o contêiner da empresa; a WABA fica dentro dele e guarda os números de telefone. **Um portfólio pode guardar várias WABAs?** Pode, e as agências costumam ver isso quando um cliente tem contas separadas para marcas diferentes. **Quem pode conceder acesso a um portfólio?** Um administrador daquele portfólio, que normalmente é o dono da empresa, e não quem está fazendo a integração. **Conectar move o meu número?** Não. Ele permanece no seu portfólio, com o app do provedor autorizado a agir sobre ele. --- ## whatsapp-business-account | A Conta do WhatsApp Business, e por que os overrides ficam nela https://easycoexistence.com/pt/docs/whatsapp-business-account Uma Conta do WhatsApp Business guarda números de telefone e templates. Ela importa mais do que parece porque o roteamento de webhook é aplicado nesse nível, e não por número, e é por isso que remover uma conexão leva o roteamento junto. ### O que uma WABA guarda de verdade? Números de telefone e templates, que é uma dupla com mais consequências do que parece à primeira vista. Templates pertencem à conta, e não a um número, então todo número na mesma WABA compartilha a mesma biblioteca de templates. Crie um para avisos de pedido e todos eles podem enviar. A Meta limita a quantidade de templates numa conta, e esse é um limite que agências com muitas marcas numa conta só conseguem alcançar. Cada número carrega o próprio phone number id, nome de exibição, classificação de qualidade e nível de mensagens. Esses são por número, então um pode estar degradado enquanto outro da mesma conta está saudável. ### Por que os overrides de webhook ficam nesse nível? Porque a inscrição que eles modificam é a inscrição de um app numa conta, e não num número. Quando um destino é definido, o que de fato acontece é que uma override callback URI é aplicada à inscrição do nosso app naquela WABA. A partir daí, todo número da conta entrega ali os eventos do caminho de mensagens. Não existe roteamento por número, o que surpreende quem administra vários números sob um mesmo cliente. A consequência é a que vale planejar. Quando uma conexão é removida, pela regra de quatorze dias de inatividade ou por outro motivo, o app é desinstalado da conta e o override é desinstalado junto. O envio e o monitoramento voltam na reconexão. A entrega no seu próprio servidor não volta, a menos que alguma coisa recoloque o override. - Esperar roteamento de webhook por número. O override é por conta. - Achar que uma reconexão restaura o destino. Ele é desinstalado junto com o app e precisa ser reaplicado. - Esquecer que os templates são compartilhados. Todo número da conta enxerga a mesma biblioteca. **Dois números numa mesma WABA podem rotear para endpoints diferentes?** Não. O override se aplica à conta, então todos os números dela entregam no mesmo destino. **Templates são transferidos entre contas?** Não. Eles pertencem à conta em que foram criados. **O que acontece com o override quando um número é removido?** Se o app for desinstalado da conta, o override vai junto. Reconectar restaura o envio, mas não o destino. **Existe um limite de templates?** A Meta limita os templates por conta, e ultrapassar esse limite devolve um erro específico. --- ## two-step-verification | Verificação em duas etapas num número de WhatsApp https://easycoexistence.com/pt/docs/two-step-verification A verificação em duas etapas é um PIN definido num número de telefone do WhatsApp Business. Certas operações exigem ele, e como quase sempre é definido uma vez no onboarding e nunca mais usado, a falha comum é ninguém na empresa se lembrar dele. ### Quando o PIN é realmente necessário? No registro e no novo registro de um número, e em certas operações de conta que a Meta protege. Isso significa que a maioria das empresas define o PIN durante o onboarding e nunca mais o vê, que é justamente por isso que ele vira um problema. A pessoa que definiu segue a vida, o PIN nunca foi anotado em lugar nenhum, e ele é necessário dezoito meses depois, no exato momento em que alguma coisa já está quebrada. Os erros em torno dele são específicos o bastante para diagnosticar. Um PIN incorreto devolve 133005. Tentativas demais devolvem 133008 e travam novas tentativas por um período informado na resposta. Tentativas enviadas rápido demais devolvem 133009, que é um limite de taxa, e não uma resposta errada. ### O que fazer quando ele se perde? Redefinir no WhatsApp Manager, nas configurações do número, o que exige acesso à conta que é dona dele. Essa é uma operação do dono da empresa, e não do provedor. Nenhuma API consegue ler ou redefinir um PIN, e nenhum provedor o guarda, o que é de propósito: uma credencial que um provedor pudesse recuperar não seria um segundo fator. O conselho prático é registrar o PIN em algum lugar de onde a própria empresa consiga recuperar, e não a agência. Um PIN guardado só no gerenciador de senhas de uma agência cria exatamente o mesmo problema uma relação de cliente depois. - Tentar de novo rápido depois de um PIN errado. Isso devolve 133009 e atrasa a próxima tentativa legítima. - Guardar o PIN só do lado da agência. A empresa precisa conseguir recuperar por conta própria. - Achar que um provedor consegue recuperar. Ninguém o guarda, que é justamente o motivo de ele existir. **Vocês conseguem redefinir o meu PIN?** Não. Ele é definido no número, dentro das configurações da própria Meta, e nenhum provedor consegue ler ou alterar. **Quanto tempo dura um bloqueio?** A Meta informa a espera na resposta de erro do 133008, em vez de usar um período fixo. **O PIN é por número ou por conta?** Por número de telefone. **Isso é a mesma coisa que verificação de negócio?** Não. A verificação trata da pessoa jurídica no nível do portfólio; isto aqui é um PIN num número. --- ## O webhook account_review_update https://easycoexistence.com/pt/docs/webhook-account-review-update O account_review_update carrega o resultado de uma revisão da Meta sobre a conta do negócio. O campo decision diz o que foi decidido, e uma recusa merece ser tratada como conexão degradada em vez de informação, porque o envio costuma seguir o mesmo caminho para baixo. ### Quando acontece uma revisão? Quando a Meta examina a conta do negócio, o que pode vir depois do envio de uma verificação, de um recurso, ou de um alerta automático levantado pelo comportamento de mensagens. A revisão em si não é algo que um provedor dispare ou veja por dentro. O que chega é o resultado, como um evento com uma decisão. As aprovações são sem graça. As recusas é que merecem ação, porque muitas vezes antecedem uma restrição em vez de encerrarem o assunto. Nada sobre uma revisão é visível no app do WhatsApp Business, então uma empresa pode estar sob revisão, ser recusada, e continuar respondendo clientes pelo celular sem nenhuma indicação de que algo aconteceu. ### Por que tratar uma recusa como degradação e não como notícia? Porque em geral ela é o primeiro de vários eventos, e não o último. Uma revisão recusada quer dizer que a Meta olhou a conta e não ficou satisfeita. O que vem em seguida é com frequência uma restrição, que interrompe o envio por completo e chega como um account_update com um evento de aplicação de regras. Marcar a conexão como degradada já na recusa dá a quem está acompanhando uma dianteira na conversa com o cliente. A alternativa, registrar como informativo, faz com que a primeira ação de alguém seja quando os envios começam a falhar, e nesse ponto a empresa já não consegue alcançar os clientes e a discussão começa de uma crise em vez de um aviso. - Registrar uma recusa sem mudar o estado. Ela é um indicador antecedente, não uma nota de rodapé. - Esperar o motivo neste evento. Ele carrega a decisão; o detalhe fica no Business Manager. - Presumir que a empresa vai perceber. Nada sobre uma revisão aparece no celular. **Um provedor consegue ver por que a revisão falhou?** Não. O aviso de aplicação de regras e o raciocínio dele ficam no Business Manager, na conta do negócio. **Uma recusa sempre leva a restrição?** Nem sempre, mas com frequência suficiente para que tratar como aviso seja o padrão certo. **Quem pode recorrer?** As pessoas com acesso de administrador à conta do negócio. Nenhum provedor recorre em nome delas. **Isso é o mesmo que a revisão de template?** Não. Os resultados de revisão de template chegam à parte e dizem respeito a um template, não à conta. --- ## O webhook business_capability_update https://easycoexistence.com/pt/docs/webhook-business-capability-update O business_capability_update informa uma mudança no que a conta pode fazer, e o mais útil é o limite de mensagens. Ele carrega o limite atual, que é com quantos clientes distintos você pode iniciar conversas por dia. Ele se move nos dois sentidos. ### O que o limite de mensagens está limitando de fato? Com quantos clientes distintos você pode iniciar uma conversa em um dia corrido. Não quantas mensagens você pode enviar, e não com que velocidade. Essa é a distinção que causa problema. Throughput é uma taxa, medida por segundo, e excedê-la devolve 130429. A faixa de mensagens é uma contagem diária de novas conversas, e excedê-la é uma condição diferente. Um número pode estar bem dentro da faixa dele e ainda assim bater no limite de taxa, ou o contrário. Respostas dentro de uma janela de atendimento aberta não consomem a faixa, porque elas não iniciam uma conversa. O que consome é alcançar alguém que não escreveu. ### Por que ela desce? Porque a faixa acompanha a qualidade, e a qualidade acompanha como quem recebe reage. Um número cujos destinatários bloqueiam ou denunciam mensagens perde posição, e a faixa é uma das coisas que se ajusta. Isso faz de um movimento para baixo um sinal precoce útil: ele em geral chega antes de qualquer coisa parar de funcionar, enquanto ainda há tempo de mudar o que está sendo enviado e para quem. O sentido para cima é mais lento e é conquistado com boa recepção sustentada. Nenhum dos dois sentidos é anunciado em algum lugar que uma empresa veja, e é por isso que registrar este evento, em vez de só reagir a falhas, compensa o pequeno esforço. - Confundir a faixa com o throughput. Uma é conversas por dia, o outro é mensagens por segundo. - Contar respostas contra a faixa. Mensagens dentro de uma janela aberta não iniciam uma conversa. - Ignorar um movimento para baixo. Ele chega antes de algo quebrar, e é justamente esse o valor dele. **Como eu subo a minha faixa?** Ela acompanha a qualidade ao longo do tempo, e não um pedido. Enviar bem para pessoas que querem receber é o mecanismo. **Um envio de template sempre consome faixa?** Um template que inicia uma conversa consome. Um enviado dentro de uma janela aberta não. **O messaging_limit_update é diferente?** A Meta envia os dois nomes para mudanças relacionadas. O nosso handler trata igual porque o conteúdo útil é o mesmo. **Isso vale em um número com Coexistência?** Vale. O que é fixo na Coexistência é o throughput, e não a faixa de mensagens. --- ## O webhook account_alerts https://easycoexistence.com/pt/docs/webhook-account-alerts O account_alerts é o canal geral da Meta para levantar alguma coisa sobre uma conta de negócio. Diferente dos outros eventos, ele não carrega um estado a aplicar, o que faz dele um convite a ir olhar em vez de algo sobre o qual agir de forma automática. ### O que chega neste canal? O que quer que a Meta considere digno de sinalizar sobre a conta, algo que é de propósito aberto e que se expandiu com o tempo. Como o conteúdo não é um conjunto fixo, um handler escrito para decidir por tipos específicos de alerta vai deixar passar os novos. A abordagem que dura é registrar o alerta, ligar à conta, e mostrar para uma pessoa, em vez de mapear cada variedade para uma resposta automática. Este é o único evento operacional em que o tratamento honesto é perceber, e não decidir. O nosso próprio handler registra que um alerta chegou e não tenta deduzir um status a partir dele. ### Como ele deve entrar no monitoramento? Como uma marcação em uma linha do tempo, ao lado dos eventos que de fato carregam estado. O valor está na sequência. Um alerta que chega pouco antes de uma revisão recusada e depois de uma restrição conta uma história que nenhum dos três conta sozinho. Registrar tudo em uma única linha do tempo é o que torna isso visível, e é o que transforma uma conversa com o cliente de chute em uma data e um evento. O que ele não deve fazer é disparar nada. Um alerta não é uma desconexão, não é uma queda de qualidade e não é uma restrição, e tratar como qualquer uma dessas coisas produz alarme falso, o que ensina as pessoas a ignorar os alarmes reais. - Decidir por tipos específicos de alerta. O conjunto se expande e um handler montado em cima da lista de hoje envelhece. - Disparar automação a partir de um alerta. Ele não carrega estado, então qualquer coisa deduzida é chute. - Descartar porque não é acionável. O valor dele está na sequência que forma com outros eventos. **Por que ele não muda o status da minha conexão?** Porque ele não diz o que mudou. Deduzir um status a partir dele produziria alarme falso. **Onde eu vejo o detalhe?** No Business Manager, na conta do negócio. O evento é um convite a olhar lá. **Ele é raro?** Não é um evento de rotina, e isso é parte do motivo de valer a pena mostrar quando ele chega. **Isso quer dizer que algo está errado?** Não necessariamente. Quer dizer que a Meta levantou alguma coisa, o que merece o olhar de uma pessoa em vez de uma resposta automática. --- ## display-names | Nomes de exibição num número de empresa no WhatsApp https://easycoexistence.com/pt/docs/display-names O nome de exibição é o que os clientes veem acima de uma conversa com o seu número. Mudar ele exige aprovação da Meta, a decisão chega no webhook phone_number_name_update, e as rejeições quase sempre são sobre o nome não corresponder à empresa. ### O que a Meta verifica? Principalmente que o nome corresponda à empresa pela qual a conta está verificada. Um nome que bate com a pessoa jurídica, com um nome fantasia registrado, ou com a marca que um cliente reconheceria pelo site tende a passar. Uma descrição genérica, um nome sem ligação com a empresa verificada, ou algo que se lê como palavra-chave em vez de nome tende a não passar. Um número sem nome de exibição aprovado fica limitado no que consegue fazer, e devolve um erro específico em certos envios. Isso pega quem conectou um número rápido durante um teste e nunca completou o nome, e depois se perguntou por que uma classe de envio falha enquanto outras funcionam. ### Como a decisão chega? No webhook phone_number_name_update, carregando um campo de decisão. Esse é um dos seis campos operacionais que uma conexão assina, e é o único sinal de que um nome enviado foi resolvido. Nada sobre isso aparece no app do WhatsApp Business, e uma empresa que enviou uma mudança de nome semanas atrás não tem como saber o desfecho, a não ser que alguém esteja recebendo aquele evento. Registrar isso na linha do tempo da conexão faz com que a resposta para a nossa mudança de nome passou seja uma data, e não um chute, que é justamente o tipo de pergunta que de outro jeito vira uma conversa com o suporte. - Enviar uma palavra-chave em vez de um nome. A Meta confere contra a empresa verificada, e não contra volume de busca. - Achar que nenhuma notícia significa aprovado. A decisão chega como webhook e em nenhum outro lugar. - Pular o nome de exibição durante um teste e depois esbarrar no 131037 num envio que exige um. **Quanto tempo leva a aprovação?** A Meta não publica um período fixo, e nenhum provedor consegue acelerar. **Posso mudar depois?** Pode, e cada mudança passa por análise de novo. **O que é o erro 131037?** O erro devolvido quando um número não tem nome de exibição aprovado e tenta algo que exige um. **O cliente vê o meu número de telefone também?** Ele vê o nome de exibição depois de aprovado, que é justamente o motivo de ter um. --- ## Categorias de template: utilidade, marketing e autenticação https://easycoexistence.com/pt/docs/template-categories Todo template declara uma categoria quando é criado. Utilidade cobre mensagens transacionais ligadas a algo que o cliente fez, marketing cobre promoção e exige uma forma de pagamento na conta, e autenticação cobre códigos de uso único sob regras de formato próprias e mais rígidas. ### O que cabe em cada categoria? Utilidade é transacional e ligada a uma ação que o cliente tomou: uma confirmação de pedido, uma atualização de envio, um lembrete de reserva, uma mudança de agendamento. O teste que define é se o cliente esperaria aquela mensagem por causa de algo que ele fez. Marketing é tudo que for promocional: uma oferta, um produto novo, uma mensagem de reengajamento, uma newsletter. Enviar uma dessas exige uma forma de pagamento na WhatsApp Business Account, e é por isso que a primeira tentativa de marketing numa conta que só respondeu clientes até hoje costuma falhar. Autenticação são senhas de uso único e verificação. Tem o formato mais rígido, com restrições apertadas sobre o que pode aparecer em volta do código, e existe como categoria própria porque as expectativas de entrega são diferentes. ### Por que não declarar tudo como utilidade? Porque a Meta reclassifica, e ser reclassificado é pior do que declarar com honestidade. Conteúdo promocional dentro de um template de utilidade é pego com constância. O template ou é rejeitado na revisão, ou é aprovado e recategorizado depois, e nesse momento os envios que estavam sendo cobrados como utilidade passam a ser cobrados como marketing sem que ninguém tenha mudado nada. Isso é uma surpresa na fatura, não uma economia. Submeter templates mal categorizados repetidamente também atrai atenção para a própria conta. O caminho mais barato é declarar o que a mensagem realmente é, o que ainda torna a revisão mais rápida, porque o revisor está conferindo aquilo que o template diz ser. - Colocar uma oferta dentro de um template de utilidade. Isso é pego com constância e pode ser recategorizado depois da aprovação. - Tentar um envio de marketing sem forma de pagamento na conta. A Meta exige uma e nenhum provedor pode adicioná-la. - Usar autenticação para qualquer coisa que não seja uma senha. As restrições de formato são rígidas e não vai passar. **Quem paga por um envio de marketing?** A Meta cobra na forma de pagamento da sua própria WhatsApp Business Account. Isso nunca passa por nós. **Um template pode mudar de categoria?** A Meta pode recategorizar um template depois da aprovação se o conteúdo não corresponder ao que foi declarado. **Utilidade é gratuita?** As conversas de utilidade são precificadas pela Meta e não são a mesma coisa que as respostas dentro da janela de atendimento, que são gratuitas. **O que é o erro 131063?** Templates de marketing desativados na conta, o que é diferente de não ter forma de pagamento. --- ## troubleshooting-a-connection | Um número parou de funcionar: como descobrir por quê https://easycoexistence.com/pt/docs/troubleshooting-a-connection Quando um número conectado para de funcionar, a causa quase nunca é o código. Percorra na ordem de frequência: um token expirado, um override de webhook perdido numa reconexão, uma desconexão por quatorze dias de inatividade, uma queda de qualidade, e então uma restrição de conta. ### Por que nada parece errado no celular? Porque o app do WhatsApp Business e a API são superfícies separadas sobre o mesmo número, e quase toda falha afeta só uma delas. Um token expira e o app segue intocado. Um override de webhook é desinstalado e o app segue intocado. A qualidade cai e o app segue intocado. Em todos os casos a empresa continua atendendo os clientes, vê um comportamento normal, e não tem motivo nenhum para relatar nada. Esse é o argumento inteiro a favor de monitoramento, e não de um painel que alguém confere. As falhas são reais, são silenciosas, e as pessoas mais próximas do número são as menos propensas a notar. ### Em que ordem checar? Comece pelo token, porque é o mais comum e o mais barato de resolver. Uma credencial expirada ou invalidada faz toda chamada falhar igual, o que parece exatamente com o número ter sido removido. Manter uma segunda credencial contra a mesma conta é o que distingue as duas coisas. Depois o override de webhook. Se houve uma reconexão, o destino foi desinstalado junto com o app, então o envio e o monitoramento funcionam enquanto a entrega no seu servidor, em silêncio, não funciona. Depois uma desconexão: um evento account_update com PARTNER_REMOVED e um motivo, onde PRIMARY_INACTIVITY significa que o app ficou sem ser aberto por cerca de quatorze dias e reconectar resolve. Depois a qualidade, que é consultada por polling em vez de empurrada, e por fim uma restrição, que é uma aplicação no nível da conta que nenhum provedor consegue levantar. ### O que quase nunca é a causa? O seu código, se ele estava funcionando ontem e nada foi implantado. A Cloud API é estável e os formatos de requisição dela não mudam por baixo de você. Quando uma integração que rodou por meses para, a probabilidade esmagadora é de uma credencial, uma mudança de roteamento ou um evento no nível da conta, e nada disso depende de alguém tocar num repositório. A exceção que vale nomear é um template que foi editado. Mudar a quantidade de variáveis de um template muda o contrato para todo remetente, em silêncio, e isso de fato parece uma falha de código, sendo uma mudança de conteúdo feita no WhatsApp Manager por outra pessoa. - Reconectar o número primeiro. Se um token expirou, isso pede ao dono da empresa um trabalho que nunca foi necessário. - Achar que o código quebrou. Uma API estável somada a nenhum deploy aponta para outro lugar. - Procurar sintomas no celular. O app continua funcionando em quase todos esses casos. **O número funciona no celular 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. **Reconectei e as mensagens ainda não chegam no meu servidor.** O override de webhook foi desinstalado junto com o app. Ele precisa ser reaplicado; nós fazemos isso automaticamente. **Como sei se foi a regra de quatorze dias?** A desconexão chega com o motivo PRIMARY_INACTIVITY no evento account_update. **A edição de um template pode quebrar os meus envios?** Pode, e é a única causa que se parece com uma falha de código. Mudar a quantidade de variáveis muda o contrato para todo remetente. --- ## Quais mensagens do WhatsApp a Meta cobra https://easycoexistence.com/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 recebe 1.000 mensagens de atendimento gratuitas por mês, as respostas enviadas dentro da janela de atendimento de 24 horas, e a Meta cobra a partir da 1.001ª. Os templates são cobrados na entrega, inclusive os de utilidade. Essas cobranças vão para a forma de pagamento da sua própria conta do WhatsApp Business. ### O que exatamente é gratuito? Até 1.000 mensagens de atendimento por mês em cada número de telefone comercial. Mensagem de atendimento é qualquer mensagem que não seja template, e ela só pode ser enviada dentro de uma janela de atendimento aberta, que corresponde às 24 horas seguintes à última mensagem do cliente para você. A partir da 1.001ª no mês, a Meta cobra cada uma, e a franquia não utilizada não é acumulada. Isso pesa mais no desenho da integração do que parece à primeira vista. Um fluxo de suporte que só responde a quem escreveu continua gratuito até ultrapassar essa franquia e, depois disso, paga por mensagem. Um fluxo que inicia o contato paga por cada template entregue, e desde 1º de outubro de 2026 isso inclui os templates de utilidade enviados dentro de uma janela aberta. Portanto, o custo de uma integração depende de quantas mensagens ela entrega e em qual categoria, não de quantas conversas ela tem. Dois sistemas com o mesmo volume podem ter cobranças da Meta muito diferentes. ### Quem a Meta cobra? A forma de pagamento da sua própria conta do WhatsApp Business, definida no WhatsApp Manager. É uma relação direta entre a empresa e a Meta. As cobranças não passam por um Tech Provider, e é também por isso que um provedor não pode aplicar margem, agrupar ou revender essas cobranças. Quem oferece tarifas de mensagem do WhatsApp com desconto é um revendedor com outro tipo de acordo ou está descrevendo algo diferente das cobranças da Meta. Na prática, uma conta sem forma de pagamento consegue responder até a franquia gratuita mensal acabar e falha no momento em que envia um template ou uma resposta além dela, o que é uma falha confusa até que essa divisão seja entendida. - Presumir que as respostas são sempre gratuitas. Desde 1º de outubro de 2026, a Meta cobra as mensagens de atendimento além de 1.000 por número ao mês, e também os templates de utilidade dentro da janela. - Esperar que a fatura do provedor inclua as cobranças da Meta. Elas são cobradas diretamente e em separado. - Montar fluxos sem forma de pagamento na conta. Os templates não são enviados, e as respostas param quando a franquia gratuita mensal acaba. **Todas as respostas são gratuitas?** Só as primeiras 1.000 mensagens de atendimento por número de telefone comercial a cada mês. Depois disso, a Meta cobra cada uma e, fora da janela de 24 horas, você precisa de um template, que é cobrado na entrega. **A categoria muda o preço?** Sim. A Meta precifica de forma diferente as mensagens de marketing, utilidade, autenticação e atendimento, e a tarifa também depende do país do destinatário. **Um provedor pode me dar uma tarifa melhor?** Não nas cobranças da Meta, porque elas nunca chegam ao provedor. **O que acontece se a minha forma de pagamento falhar?** Os envios que exigem cobrança são interrompidos e retornam o erro 131042. O recebimento não é afetado. --- ## mcp-or-webhook | MCP ou webhook: qual deles você realmente precisa https://easycoexistence.com/pt/docs/mcp-or-webhook O MCP é requisição e resposta: um assistente chama uma ferramenta quando uma pessoa pede. O webhook tem o formato oposto, em que a Meta entrega um evento e o seu sistema decide o que fazer. Nada que reaja automaticamente pode ser construído só com MCP. ### Por que o MCP não consegue responder a um cliente automaticamente? Porque o protocolo não tem mecanismo para ser acordado. Um servidor MCP expõe ferramentas que um cliente chama. A chamada nasce no assistente, que por sua vez está respondendo a uma pessoa. Não existe direção de entrada: nada no fato de um cliente mandar uma mensagem de WhatsApp consegue alcançar um assistente e fazer com que ele aja. Isso vale para todo servidor MCP em todo produto, e não é uma limitação do nosso. Então a pergunta que todo comprador acaba fazendo, se uma IA consegue responder aos clientes de madrugada, tem resposta de webhook, e não de MCP. A Meta entrega a mensagem para um sistema que você mantém, e esse sistema decide o que fazer, o que muito bem pode incluir chamar um modelo. ### Para que cada caminho é genuinamente bom? O MCP é para o trabalho que uma pessoa está fazendo. Qual dos meus números está com problema, manda para este cliente a confirmação dele, cria um template para avisos de pedido, aponta o número deste cliente para o meu servidor. Cada uma dessas coisas começa com alguém pedindo, e cada uma é mais rápida por um assistente do que por um painel. O webhook é para tudo que precisa acontecer sem ninguém presente. Primeira resposta fora do horário, encaminhamento para a pessoa certa, registro num CRM, disparo de um fluxo. A propriedade útil é que o MCP consegue configurar o webhook. O get_connect_link produz o link que um cliente abre, e o set_webhook_destination aponta o número dele para o seu sistema, então um agente pode fazer o onboarding do caminho que ele mesmo não consegue servir. ### Quais ferramentas falam o quê? Assistentes falam MCP: Claude, ChatGPT, Cursor, Claude Code. Plataformas de automação em geral não falam, e a distinção não é a que as pessoas esperam. Make e Zapier rodam servidores MCP próprios, expondo as ações deles para assistentes. Nenhum dos dois age como cliente MCP, então nenhum consegue chamar o nosso. Para eles, a integração é um webhook e uma chamada HTTP. O n8n é a exceção. O MCP Client Tool dele conecta a um servidor remoto e suporta OAuth2, então um nó de agente dentro de um fluxo do n8n pode chamar nossas ferramentas direto. Mesmo ali o fluxo ainda começa com um webhook, porque essa é a única coisa que reage. - Comprar MCP esperando respostas automáticas. Ele age quando é chamado, e nada o chama às 3 da manhã. - Achar que uma plataforma com servidor MCP consegue consumir um. Make e Zapier expõem, eles não consomem. - Construir os dois caminhos para fazer o mesmo trabalho. Eles são para metades diferentes do mesmo sistema. **Um assistente consegue vigiar o meu WhatsApp?** Não. Nada consegue empurrar um evento para dentro de um servidor MCP. Vigiar é webhook, e o webhook pode então chamar um modelo. **Preciso dos dois?** A maioria dos sistemas reais usa os dois: MCP para o trabalho que as pessoas fazem, e o webhook para tudo que acontece sem elas. **O Zapier consegue usar o servidor MCP de vocês?** Não. O Zapier é um servidor MCP e não um cliente, então não tem como chamar o nosso. **E o n8n?** Consegue, pelo MCP Client Tool com OAuth2. Das três, é a plataforma de automação que consegue. --- ## what-changes-in-the-app | O que muda no app do WhatsApp Business depois de conectar https://easycoexistence.com/pt/docs/what-changes-in-the-app Quase nada muda no celular. As mesmas conversas, o mesmo histórico, os mesmos contatos e o mesmo aparelho, e a equipe atende exatamente como antes. O que muda é que a API fica ligada à mesma linha, cada lado vê o que o outro envia, e os grupos ficam de fora da API. ### O que continua exatamente como era? O app, o número, as conversas e a pessoa que responde a elas. O app do WhatsApp Business abre do mesmo jeito, a lista de contatos não muda, e toda conversa passada continua lá. Ninguém entra em lugar novo nenhum, ninguém instala nada, e não há treinamento. Uma empresa que conecta um número numa terça à tarde tem uma quarta de manhã idêntica a todas as quartas de manhã anteriores. Esse é o ponto inteiro, e vale ser concreto sobre isso porque a promessa soa boa demais para empresas a quem já ofereceram migrações antes. ### O que realmente muda? Três coisas, e só uma delas é visível. As mensagens que a API envia aparecem no fio da conversa dentro do app, então quem está no celular vê o quadro inteiro em vez de metade dele. Essa é a visível, e ela é uma melhoria, e não uma perturbação. As mensagens digitadas no app passam a ser visíveis para o software, chegando como eventos smb_message_echoes. Ninguém no celular percebe isso, mas é o que impede que a automação responda por cima de uma pessoa que já respondeu. E as conversas em grupo ficam de fora da API. A equipe pode continuar usando grupos pelo app exatamente como antes; o software simplesmente não consegue ver nem enviar neles, em provedor nenhum. ### O que a empresa precisa continuar fazendo? Abrir o app, coisa que ela ia fazer de qualquer jeito. A Meta desconecta uma conexão de Coexistência depois de cerca de quatorze dias sem atividade no aparelho principal. Para uma empresa que está ativamente atendendo clientes isso nunca aparece. Para um número que fica quieto por sazonalidade, ou um que uma agência guarda para um cliente num mês fraco, aparece. A desconexão é recuperável, então é um incômodo, e não uma perda. A parte que vale planejar está adiante: o destino do webhook é desinstalado junto com a conexão, então reconectar restaura o envio enquanto a entrega no seu próprio servidor, em silêncio, não volta, a menos que seja reaplicada. - Prometer a uma equipe que ela não vai notar nada, e então migrar em vez de conectar. A migração remove o app. - Construir qualquer coisa em torno de conversas em grupo. Elas ficam de fora da API em todo provedor. - Achar que um número quieto permanece conectado. Quatorze dias sem o app ser aberto encerram a conexão. **Minha equipe vai ter que aprender alguma coisa?** Não. Ela continua usando o app do WhatsApp Business exatamente como usa hoje. **Eu perco as conversas antigas?** Não. Elas ficam no app, e cerca de seis meses de histórico podem, opcionalmente, ser compartilhados com a API no onboarding. **Ainda podemos usar grupos?** Pelo app, sim, exatamente como antes. Pela API, não, em provedor nenhum. **E se ninguém abrir o app por duas semanas?** A Meta desconecta o lado da API. Reconectar restaura, e o app em si não é afetado em momento nenhum. --- ## coexistence | Referência de Coexistência https://easycoexistence.com/pt/docs/coexistence A Coexistência roda o app do WhatsApp Business e a Cloud API num mesmo número ao mesmo tempo. Esta página é a referência: o que é, como as mensagens viajam, o que ela não consegue fazer, e como desfazer. O argumento a favor dela mora no guia. ### O que é O modo oficial da Meta para rodar o app do WhatsApp Business e a Cloud API num mesmo número de telefone ao mesmo tempo. Não é uma API separada: é a mesma Cloud API, com um onboarding feito de forma que o app continue funcionando no número depois. ### Por que as equipes usam Quatro motivos respondem por quase toda conexão. - Manter o número que já está impresso em veículos, recibos e num site. - Acrescentar envio pela API, webhooks e templates sem mover ninguém para uma ferramenta nova. - Manter as conversas fora da caixa de entrada compartilhada de um provedor. - Permitir que uma agência mantenha muitos números de clientes, cada um no portfólio do próprio cliente. ### Como a comunicação funciona As duas superfícies veem o mesmo fio de conversa. O que a API envia aparece no app. O que a equipe digita no app chega ao software como um evento smb_message_echoes, que é o que impede a automação de responder por cima de uma pessoa. ### Comportamento de preço A Meta cobra por conversas, e não por mensagens, e lança a cobrança no meio de pagamento da sua própria Conta do WhatsApp Business. Respostas dentro da janela de atendimento de 24 horas são gratuitas. Abrir uma conversa fora dela exige um template e é cobrado. ### Aparelhos vinculados A Coexistência não é um aparelho vinculado e não usa nenhum. Um aparelho vinculado é o cliente comum logado em outro lugar, que é o que as ferramentas não oficiais automatizam e o que os termos do WhatsApp proíbem. Nada aqui usa esse mecanismo. ### Limitações funcionais Fixadas pela Meta, idênticas em todo provedor. - Conversas em grupo não estão disponíveis pela API. - Templates não podem ser enviados pelo app do celular, só pela API. - O throughput de envio é fixo, em vez de crescer com qualidade e nível. - O compartilhamento de histórico de conversas é decidido uma vez, durante o onboarding. ### Elegibilidade O número precisa satisfazer todas estas condições antes de conseguir conectar. - Já estar ativo no app do WhatsApp Business, e não no app comum. - Estar num Portfólio de Negócios ao qual você tenha acesso. - Não estar já conectado ao app de outro provedor. ### Notas operacionais Coisas que são verdade depois de conectar e que é fácil passar batido. - O app precisa ser aberto periodicamente, ou a Meta desconecta o lado da API. - Uma desconexão desinstala o override de webhook junto com o app. - A classificação de qualidade é consultada por polling, e não empurrada, então nada anuncia uma queda. - Um token revogado parece idêntico a um número removido, se não houver uma segunda credencial. ### Ressalva sobre a escolha da conta Durante o Embedded Signup, o Portfólio de Negócios e a Conta do WhatsApp Business são escolhidos em passos separados. Escolher a conta errada vincula o número num lugar que você não pretendia, e movê-lo depois significa desconectar e rodar o fluxo inteiro de novo. ### Decisões sem volta Compartilhar o histórico de conversas existente é perguntado uma vez e não pode ser revisto. A sincronização também precisa começar dentro de 24 horas do onboarding e só pode rodar uma vez. As duas coisas produzem erros pouco familiares em vez de avisos quando são perdidas. ### Desconectar ou reverter Um número pode ser desconectado a qualquer momento, pelo painel ou pelo conector. O app do WhatsApp Business segue exatamente como antes, com as conversas e o histórico intactos, e nada no número em si fica permanentemente alterado por ter estado conectado. - Tratar a Coexistência como uma API diferente. Ela é a Cloud API com um onboarding diferente. - Construir em torno de conversas em grupo. Elas ficam de fora em todo provedor. - Achar que uma reconexão restaura o destino do webhook. Ela não restaura. **Isso é a mesma coisa que a Cloud API?** Sim. A Coexistência é um jeito de fazer onboarding na Cloud API que deixa o app do WhatsApp Business funcionando no número. **Posso desfazer?** Pode. Desconectar deixa o app e as conversas dele exatamente como estavam. **Minha equipe precisa de treinamento?** Não. Ela continua usando o app do WhatsApp Business como usa hoje. **Por que o app não consegue enviar templates?** Templates são um recurso da plataforma, e não do app. Qualquer coisa fora da janela de 24 horas passa pela API. --- ## what-syncs-and-what-does-not | O que sincroniza com a API, e o que não sincroniza https://easycoexistence.com/pt/docs/what-syncs-and-what-does-not Contatos e histórico de mensagens individuais sincronizam com a API, e a partir daí as mensagens espelham nos dois sentidos. Grupos não sincronizam, e as ferramentas próprias do app do WhatsApp Business também não: catálogo, pedidos, status, etiquetas, respostas rápidas, mensagem de saudação e de ausência. ### O que atravessa Duas coisas, e elas são as duas que importam para um software que começa num número que uma empresa usa há anos. - Contatos: todo contato com um número de WhatsApp pode ser sincronizado para a plataforma. - Histórico de mensagens individuais, para que a API não fique cega em relação às conversas que aconteceram antes de ela existir. - Dali em diante, as mensagens espelham nos dois sentidos: o que a API envia aparece no app, e o que a equipe digita no app chega aos seus sistemas. ### O que não atravessa Mais coisas do que as pessoas esperam, e essa é a lista que vale ler antes de prometer qualquer coisa a um cliente. Nada disso é limitação de provedor; é como a plataforma funciona. - Conversas em grupo, que não sincronizam e não são alcançáveis pela API em provedor nenhum. - Ferramentas de negócio: o catálogo, os pedidos e o status. - Ferramentas de mensagem: mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas. - Canais, chamadas de voz e vídeo, e os detalhes do perfil comercial. ### Por que as ferramentas próprias do app ficam para trás Porque elas são recursos do app, e não da plataforma, e a API não tem equivalente delas. Respostas rápidas e etiquetas moram no aparelho. Uma mensagem de ausência é algo que o app envia quando ninguém está olhando para ele. Nada disso existe como conceito de API, então não há para onde essas coisas sincronizarem. A consequência prática é que uma empresa que depende de etiquetas para organizar o trabalho continua usando elas no app, e o software não tem visibilidade nenhuma delas. Se essa organização importa para aquilo que você está construindo, ela precisa ser reconstruída do seu lado, em vez de ser lida de lá. ### A janela que dá para perder A sincronização precisa ser iniciada dentro de 24 horas do onboarding. Perca isso e o número precisa passar por offboarding e onboarding de novo para ter outra chance. Isso é separado da janela de atendimento de 24 horas que governa o envio, e as duas são confundidas o tempo todo. Uma conta a partir da última mensagem do cliente e decide se o texto livre é entregue. Esta conta a partir do onboarding e decide se o histórico ainda pode ser puxado. É também por isso que vale decidir sobre o histórico no dia em que um número conecta, e não quando o trabalho de integração começa, que costuma ser outra semana. - Prometer a um cliente que as etiquetas e as respostas rápidas dele vão aparecer no seu sistema. Elas ficam no app. - Construir qualquer coisa em torno de conversas em grupo. Elas não sincronizam em provedor nenhum. - Deixar a sincronização de histórico para quando a integração estiver pronta. A janela é de 24 horas a partir do onboarding. **As minhas conversas antigas aparecem na API?** O histórico individual sincroniza se você aceitar durante o onboarding. As conversas em grupo não. **O software consegue ver as minhas etiquetas?** Não. Etiquetas são um recurso do app sem equivalente na API, então elas ficam no aparelho. **A equipe perde as respostas rápidas?** Não. Elas continuam funcionando no app exatamente como antes; o software simplesmente não consegue ver. **E se eu perder a janela de 24 horas da sincronização?** O número precisa ser desconectado e conectado de novo, o que roda o onboarding outra vez e abre uma janela nova. --- ## features-disabled-by-coexistence | Quais recursos do WhatsApp param de funcionar depois da Coexistência https://easycoexistence.com/pt/docs/features-disabled-by-coexistence Quatro coisas param de funcionar quando um número é conectado por Coexistência: mensagens temporárias, mensagens de ver uma vez e localização em tempo real são todas desligadas para conversas individuais, e as listas de transmissão são desativadas por completo, com as existentes virando somente leitura em vez de serem apagadas. ### Os quatro Cada um é desligado no nível da plataforma, e não escondido, e cada um tem um motivo ligado ao fato de a API conseguir enxergar a conversa. - Mensagens temporárias: desligadas para todas as conversas individuais. - Mensagens de ver uma vez: desativadas para todas as conversas individuais. - Mensagens de localização em tempo real: desativadas para todas as conversas individuais. - Listas de transmissão: desativadas, e as existentes viram somente leitura em vez de serem removidas. ### Por que justamente esses quatro Porque cada um deles promete algo que a API contradiz. Uma mensagem temporária promete que não vai persistir. Uma mensagem de ver uma vez promete que pode ser vista uma vez. As duas promessas dependem de nada mais guardar uma cópia, e um número conectado está, por definição, entregando essas mensagens para outro sistema. A localização em tempo real é um fluxo contínuo em vez de uma mensagem, e não tem representação na API. As listas de transmissão são um jeito, do lado do app, de enviar para muitas pessoas de uma vez, e a resposta da própria plataforma para isso são os templates, que passam pela API com aprovação. Então nada disso é arbitrário. É a plataforma se recusando a prometer algo que ela não consegue mais cumprir. ### O que isso significa antes de conectar o número de um cliente Pergunte se a empresa usa algum deles, porque descobrir depois é uma conversa ruim. As listas de transmissão são as que pegam empresas de verdade. Uma loja que manda uma mensagem semanal para duzentos clientes por uma lista de transmissão vai perder esse fluxo de trabalho, e o substituto é um template de marketing aprovado, que precisa de um meio de pagamento na conta e da análise da Meta. As mensagens temporárias pegam outro tipo de usuário, normalmente alguém que ligou isso uma vez e esqueceu. A localização em tempo real quase nunca aparece fora de entregas e de serviço em campo. - Conectar um número que depende de listas de transmissão sem avisar a empresa. O substituto é um template, com aprovação e cobrança junto. - Achar que as listas de transmissão existentes são apagadas. Elas viram somente leitura. - Esperar que esses recursos voltem enquanto o número permanece conectado. Eles não voltam. **Posso religar as mensagens temporárias?** Não enquanto o número estiver conectado. Desconectar restaura o comportamento normal do app. **As minhas listas de transmissão existentes são apagadas?** Não. Elas viram somente leitura, então o conteúdo sobrevive e não é possível enviar para elas. **Isso afeta as conversas em grupo?** A desativação está documentada para conversas individuais. Os grupos ficam totalmente fora da API num número em Coexistência. **O que substitui uma lista de transmissão?** Um template de marketing aprovado enviado pela API, que exige um meio de pagamento na sua própria Conta do WhatsApp Business. --- ## number-eligibility | Quais números são elegíveis para Coexistência https://easycoexistence.com/pt/docs/number-eligibility Um número precisa já estar em uso no app do WhatsApp Business, na versão 2.24.17 ou mais nova, dentro de um Portfólio de Negócios que você consiga administrar, e não estar já vinculado a outro provedor. Geografia deixou de ser uma condição. Qualquer outra coisa é recusada durante o onboarding. ### O que o número em si precisa ser Quatro condições, e todas elas são verificadas durante o onboarding da própria Meta, e não por um provedor. - Já estar registrado e em uso no app do WhatsApp Business, e não no app comum do WhatsApp. - Estar rodando a versão 2.24.17 do app ou mais nova no aparelho principal. - Estar dentro de um Portfólio de Negócios da Meta ao qual você tenha acesso de administrador. - Não estar já conectado ao app de outro provedor. ### Onde a Coexistência está disponível Em todo lugar onde o app do WhatsApp Business opera. A documentação atual de onboarding da Meta para usuários do app Business não indica restrição geográfica nenhuma, e o lançamento que começou de forma regional terminou ao longo de 2026, com África do Sul e Nigéria entre os últimos mercados acrescentados. Vale dizer isso sem rodeio porque as listas regionais publicadas durante o lançamento ainda circulam, e várias delas ainda nomeiam como excluídos países que são suportados há meses. Uma empresa que lê uma dessas conclui que não pode usar o recurso, quando pode. A Meta não publica uma lista de países com data, então o teste confiável é o próprio fluxo. Se o número está ativo no app do WhatsApp Business e o Embedded Signup não o recusa por geografia, a Coexistência está disponível para aquele número. ### O que dá errado no onboarding Três falhas respondem pela maioria dos casos, e cada uma tem uma cara diferente. A um número no app comum do WhatsApp a Coexistência nem sequer é oferecida. Ele precisa ser movido antes para o app do WhatsApp Business, que é uma migração que a empresa faz no celular. Um app desatualizado produz um fluxo que começa e não consegue completar o escaneamento. Atualizar e tentar de novo é a correção. E um fluxo fechado no meio deixa o número vinculado à conta mas não registrado, o que parece conectado num painel e falha no primeiro envio com o erro 133010. Rodar o fluxo de novo desde o começo completa a coisa. - Começar o onboarding num número que ainda está no app comum do WhatsApp. Ele precisa ser movido antes para o app Business. - Confiar numa lista de disponibilidade regional do período de lançamento. Várias estão desatualizadas e ainda nomeiam como excluídos países suportados. - Fechar o popup da Meta assim que o número aparece. São os passos depois disso que completam o registro. **Posso usar um telefone fixo ou um número virtual?** Precisa ser um número registrado no app do WhatsApp Business, o que significa que ele tem que conseguir receber a mensagem de registro. **De qual versão do app eu preciso?** 2.24.17 ou mais nova no aparelho que tem o número. **A Coexistência está disponível no meu país?** Quase com certeza. A documentação atual de onboarding da Meta não indica restrição geográfica, e o lançamento regional foi concluído ao longo de 2026. O próprio fluxo é o teste confiável. **O número aparece no painel mas não envia.** O onboarding provavelmente não foi concluído. Isso devolve o erro 133010, e rodar o fluxo de novo resolve. --- ## EasyCoexistence vs 360dialog https://easycoexistence.com/pt/compare/easycoexistence-vs-360dialog A 360dialog e a EasyCoexistence compartilham o modelo de preço: um valor fixo por número conectado, com as taxas de mensagem da Meta faturadas direto para você e sem margem de nenhum dos dois lados. O que muda é o valor, quantas faixas existem, e o que a taxa de fato compra. ### O que você paga por número Os dois cobram por número e nenhum coloca margem nos custos de mensagem da Meta, então isso se resume ao valor e ao que ele compra. - 360dialog:: Três faixas de API de WhatsApp a €49, €99 e €500 por número por mês em setembro de 2026. Há um plano a escolher no cadastro e um limiar a cruzar depois. - EasyCoexistence:: Uma lista de preços, publicada, a partir de R$ 29,90 por número conectado por mês e caindo até R$ 4,90 conforme você adiciona números. Não há trava de recurso em lugar nenhum dela: o vigésimo número de uma agência faz tudo o que o primeiro fazia e custa menos, e não existe conversa de upgrade porque não há para onde subir. ### O que acontece conforme você acrescenta clientes O caso em que o valor por número deixa de ser detalhe de arredondamento. - 360dialog:: Na faixa de entrada deles, vinte números dão €980 por mês antes de a Meta cobrar qualquer coisa. O modelo é coerente; o multiplicador é o que é. - EasyCoexistence:: Vinte números dão R$ 498,00 por mês, cada um conectado no Portfólio de Negócios do próprio cliente, cada um cobrado na própria linha, sem faixa alcançada em quantidade nenhuma. ### Para onde vai o conteúdo das conversas Vale estabelecer antes de tudo, porque não dá para mudar depois. - 360dialog:: A página de preços deles não descreve o caminho de mensagem. Isso não é prova de nada, e é a primeira pergunta a fazer a eles. - EasyCoexistence:: A Meta entrega os eventos de mensagem numa URL que você indica, por um override na assinatura do nosso app à sua conta. Eventos de uma conta sem destino definido caem no nosso callback, onde o handler descarta sem persistir. ### A Coexistência em si Se o app do WhatsApp Business continua funcionando no número depois de conectar. - 360dialog:: A página de preços deles não trata disso. Pergunte direto em vez de confiar numa página de comparação, inclusive esta: recurso não documentado não é recurso ausente. - EasyCoexistence:: É o produto inteiro. O número conecta pelo fluxo de Coexistência da própria Meta, o app segue exatamente como antes, e cada ponta vê o que a outra manda. ### Quando uma relação completa de BSP é o que você quer Um caso, e é real. - 360dialog:: Quando você está comprando uma relação de fornecedor e não uma conexão. São um BSP estabelecido, com histórico longo de operação, presença regional e estruturas de suporte, numa faixa que vai de €49 a €500 por número por mês. - EasyCoexistence:: Um produto focado: suporte por e-mail e uma linha do tempo de conexão mostrando o que aconteceu e quando, a R$ 29,90 por número. É o que precisa quem está construindo a própria interface, e não é uma relação de gerente de conta. ### Qual escolher Se você precisa de um gerente de conta com nome e um caminho de escalonamento operado por pessoas, isso é uma relação de BSP e a deles é uma. Se você está com números de cliente e construindo o software em volta deles, a aritmética decide. O mesmo modelo de cobrança por um quinto do preço, com a conexão vigiada e as mensagens indo para os seus próprios sistemas, é a versão deste produto que escala junto com uma agência em vez de contra ela. - Comparar só o valor mensal. O que a taxa compra difere mais do que o número difere. - Achar que algum dos dois coloca margem nas taxas da Meta. Nenhum coloca; elas são faturadas a você pela Meta. - Ler um recurso não documentado como ausente. Pergunte a eles em vez de confiar numa página de comparação, inclusive esta. **Os preços estão atuais?** São os publicados na página de preços da 360dialog em setembro de 2026, com link acima. Preço muda; confira a fonte antes de decidir. **Algum dos dois coloca margem nas cobranças da Meta?** Não. Os dois repassam, e a Meta fatura direto na sua própria conta do WhatsApp Business. **A 360dialog suporta Coexistência?** A página de preços deles não trata disso. Não é prova de nada, e vale perguntar a eles. **Qual é melhor para uma agência?** Depende de você querer uma plataforma por cliente ou uma conexão por cliente. O custo por número pesa mais conforme a quantidade sobe. --- ## EasyCoexistence vs WATI https://easycoexistence.com/pt/compare/easycoexistence-vs-wati São produtos diferentes, não versões rivais de um só. O WATI vende uma caixa de entrada compartilhada, cobrada por usuário e por contato ativo no mês. A EasyCoexistence vende a conexão em si, cobrada por número, sem caixa de entrada nenhuma. ### Pelo que a conta mensal é de fato Os dois produtos são cobrados em unidades diferentes, e para quem tem mais de um número essa diferença se acumula todo mês. - WATI:: Por usuário e por contato ativo no mês. Os planos publicados vão de três a dez usuários e 500 a 2.500 contatos em setembro de 2026, a partir de 4.999 rupias mensais, então a conta sobe a cada atendente contratado e a cada cliente com quem se fala. - EasyCoexistence:: Um valor fixo por número conectado, sem limite de usuário e sem limite de contato. O vigésimo cliente de uma agência não custa mais que o primeiro, e um mês movimentado custa o mesmo que um parado. ### Onde as conversas dos seus clientes vão parar Essa é a diferença que não dá para desfazer depois, e decorre do que cada produto é. - WATI:: Na plataforma deles. Uma caixa de entrada compartilhada precisa armazenar o conteúdo das mensagens para servir de volta a quem abrir, o que a página de preços deles lista como recurso central de todo plano. - EasyCoexistence:: Em lugar nenhum do nosso lado. A Meta entrega os eventos de mensagem direto numa URL que você indica, e o que chega ao nosso callback de reserva é descartado sem ser persistido. Isso é garantido em código, não declarado numa política. ### Se sua equipe precisa mudar o jeito de trabalhar A pergunta que um dono de negócio faz antes de concordar com qualquer coisa. - WATI:: Os atendentes entram na caixa de entrada deles. É ali que as conversas são atribuídas, etiquetadas e respondidas, o que significa que a equipe sai do celular e entra numa ferramenta nova. - EasyCoexistence:: Ninguém muda de lugar. O app do WhatsApp Business continua funcionando no mesmo número pela Coexistência, com as mesmas conversas e o mesmo histórico, e o software cuida do que você construiu para ele cuidar. ### O que acontece quando você cresce além disso Os dois têm teto. Eles ficam em lugares diferentes. - WATI:: Mais usuários e mais contatos ativos, cada um um degrau pago. A plataforma é o produto, então escalar significa comprar mais dela. - EasyCoexistence:: Não há faixa e não há o que superar. Você está construindo a interface, então o que você escala é o seu próprio sistema, na API documentada da Meta com nada nosso no meio. ### Quando uma caixa de entrada é o que você precisa Um caso, e nomeá-lo é o que torna o resto desta página útil. - WATI:: Uma equipe de suporte de oito pessoas dividindo conversas dentro da plataforma deles, num plano que começa em 4.999 rupias por mês para três usuários e 500 contatos ativos, com cada usuário adicional cobrado por cima. - EasyCoexistence:: Outro trabalho. Aqui não há caixa de entrada nem tela de atendente, porque a interface é a parte que você ou seu cliente já têm. ### Qual escolher Se uma equipe de atendentes vai entrar todo dia e as conversas são o trabalho em si, compre a caixa de entrada. O WATI construiu uma e ela faz o que promete, a partir de 4.999 rupias por mês antes de contar números. Para todo o resto, que é a maioria de quem lê isto, a caixa de entrada é a parte que você paga e não usa. Uma agência com números de cliente está comprando assentos que ninguém abre. Um desenvolvedor construindo a interface está colocando um concorrente entre o produto dele e a API da Meta. Um negócio pequeno está sendo convidado a sair de um celular que já funciona. A EasyCoexistence é a conexão por baixo, a R$ 29,90 por número e caindo até R$ 4,90 conforme você adiciona números, com as conversas indo para os seus sistemas e a equipe ficando com o app que já conhece. - Comparar os valores mensais direto. Um inclui caixa de entrada e usuários; o outro não. - Escolher uma conexão quando a equipe precisa de caixa de entrada. Vão ficar insatisfeitos e com razão. - Escolher uma caixa de entrada quando você mesmo está construindo a interface. Você acaba com duas. **O que acontece quando eu passar de 500 contatos?** No plano de entrada deles você sobe de faixa. Com a gente não acontece nada: não há limite de contato em preço nenhum, então um mês com dez mil clientes custa o que custa um mês com dez. **Qual é mais barato?** Até seis números, somos nós, frente ao plano de entrada deles. Esse plano custa 4.999 rupias por mês, cerca de US$ 53, para três usuários e 500 contatos ativos. O nosso é R$ 29,90 por número conectado, ou R$ 24,90 cada a partir de seis números, então seis números saem por R$ 149,40 por mês. Acima disso, a resposta depende das cobranças deles por usuário extra e por faixa de contatos, que sobem com a equipe e com a base de clientes, enquanto o nosso preço sobe só com a quantidade de números. **O WATI suporta Coexistência?** A página de preços deles não trata disso. Pergunte a eles em vez de confiar nesta página. **Vocês têm app de celular?** Não. A equipe usa o app do WhatsApp Business, que é justamente o ponto da Coexistência. --- ## EasyCoexistence vs respond.io https://easycoexistence.com/pt/compare/easycoexistence-vs-respond-io O respond.io é uma plataforma multicanal: caixas de entrada de equipe, fluxos, agentes de IA e disparos, a partir de US$ 79 por mês com limite de usuário e de contato. A EasyCoexistence é a conexão por baixo, cobrada por número, sem nada disso. ### Quanto custa manter Cobrados em unidades diferentes, conforme publicado em setembro de 2026. - respond.io:: A partir de US$ 79 por mês para cinco usuários e 1.000 contatos ativos no mês, subindo até US$ 279. A conta acompanha quantas pessoas atendem e quantos clientes você alcança. - EasyCoexistence:: A partir de R$ 29,90 por número conectado por mês, caindo até R$ 4,90 conforme você adiciona números, sem limite de usuário nem de contato. A conta acompanha quantos números você tem, que é o número que uma agência de fato controla. ### Onde mora o conteúdo das conversas Uma consequência de vender uma caixa de entrada em vez de uma conexão. - respond.io:: Na plataforma deles, coisa que uma caixa de entrada de equipe exige para mostrar histórico. A página de preços deles não detalha retenção, o que vale perguntar se isso importa para você. - EasyCoexistence:: Em lugar nenhum do nosso lado. O override de webhook manda os eventos de mensagem da Meta direto para o seu endpoint, e o que chega ao nosso callback de reserva é descartado sem persistir. ### O que fica entre você e a Meta A pergunta que decide isso para quem constrói software. - respond.io:: A plataforma deles. Você integra contra a abstração deles, os limites de taxa deles, o formato de webhook deles e o calendário de release deles, e o que você constrói é portável só 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 que construir, que é também o que torna ir embora possível. ### O que vigia a conexão Raramente aparece em página de preço, e é a razão deste produto existir. - respond.io:: Não é algo que a página de preços deles trate, e seria errado afirmar uma resposta. Se você tem números de cliente, pergunte especificamente o que acontece quando uma conexão cai em silêncio. - EasyCoexistence:: Classificação de qualidade, nível de mensageria e throughput consultados em agenda. Eventos de conta da Meta tratados pelo nome. Duas credenciais guardadas para um token revogado não ser confundido com número perdido. O override de webhook reaplicado depois que uma reconexão o remove. ### Quando uma plataforma é o que você quer Vale nomear, porque os dois produtos respondem perguntas diferentes. - respond.io:: Quando você quer a plataforma. Os planos publicados deles incluem caixas de entrada de equipe e customizadas, fluxos, disparos, agentes de IA, relatórios, e nas faixas mais altas SSO e múltiplos espaços de trabalho. É multicanal, não só WhatsApp. - EasyCoexistence:: Um escopo diferente por desenho: um número, uma conexão, dezesseis ferramentas MCP e um webhook, com a interface deixada para você. ### Qual escolher São camadas diferentes, não versões rivais de uma coisa só. Se ninguém do seu lado está construindo a interface, e você quer um lugar pronto para os atendentes trabalharem, é uma plataforma que você está procurando. Se você é quem constrói, uma plataforma se instala dentro da sua própria stack como concorrente. Você paga por assento por caixas de entrada que seus usuários nunca veem, por contato por conversas que seu produto já trata, e integra contra uma abstração em vez da API que a Meta documenta e mantém estável. A EasyCoexistence é essa camada por baixo: um valor fixo por número a partir de R$ 29,90, o webhook apontado para o seu sistema, e a conexão vigiada para uma falha silenciosa não virar cliente perdido. - Comparar R$ 29,90 com US$ 79 como se comprassem a mesma coisa. Não compram. - Escolher uma conexão quando você queria um produto. Você vai passar meses reconstruindo uma caixa de entrada. - Achar que qualquer provedor vigia a conexão. Pergunte especificamente; isso raramente está numa página de preço. **Qual é certo para mim?** São camadas diferentes. O respond.io é uma plataforma para trabalhar dentro; isto é a conexão por baixo dela, para equipes que constroem a interface por conta. **Posso migrar deles para vocês?** O número é seu e pode ser conectado por Coexistência. O que você abriria mão é da caixa de entrada e dos fluxos deles. **Vocês têm fluxos ou agentes de IA?** Não. O conector MCP deixa um assistente usar o número, e o webhook deixa o seu próprio sistema reagir. Nenhum dos dois é um construtor de fluxo. **Esses preços estão atuais?** São os publicados em setembro de 2026, com link acima. Confira a fonte antes de decidir. --- ## EasyCoexistence vs Dualhook https://easycoexistence.com/pt/compare/easycoexistence-vs-dualhook Os dois são provedores de Coexistência com a mesma arquitetura central: o app do WhatsApp Business continua funcionando, e os webhooks de mensagem vão da Meta direto para o seu servidor em vez de passar pelo provedor. As diferenças são mais estreitas que as semelhanças e vale conhecê-las. ### O que cada produto é Esta é a comparação mais próxima do site, porque o posicionamento é quase o mesmo. - Dualhook:: Um provedor de Coexistência com a mesma promessa central: manter o app do WhatsApp Business funcionando, rotear os webhooks de mensagem direto da Meta para o seu servidor em vez de guardá-los. A documentação deles chama isso de Webhook Override. - EasyCoexistence:: O mesmo mecanismo, sob o nome que a Meta usa. Nós definimos override_callback_uri na assinatura do nosso app à conta do WhatsApp Business, o que move os campos do caminho de mensagem para o seu endpoint enquanto ficamos com os operacionais. ### Para onde vão as mensagens Os dois roteiam direto. A diferença é o que acontece com os eventos que não são roteados. - Dualhook:: Roteamento direto da Meta sem armazenar mensagem, o que o site deles afirma claramente e que é a mesma arquitetura que usamos. - EasyCoexistence:: Mesmo roteamento. O que podemos acrescentar é o que acontece no caminho de reserva: uma conta sem override entrega no nosso callback padrão, onde o handler descarta esses eventos sem persistir. A afirmação é garantida em código, não declarada numa política. ### A regra dos quatorze dias de inatividade A Meta desconecta uma conexão de Coexistência depois de cerca de quatorze dias sem atividade no aparelho principal. Os dois produtos tratam isso de formas diferentes. - Dualhook:: A documentação deles descreve aviso aos treze dias, com contagem regressiva e e-mails de lembrete. Isso é um lembrete de que o relógio está correndo, que é coisa diferente de saber por que uma conexão de fato caiu. - EasyCoexistence:: Nós observamos a desconexão em si e lemos o campo de motivo da Meta, que distingue PRIMARY_INACTIVITY de BUSINESS_DOWNGRADE, CHANGE_NUMBER e os demais. O motivo é o que separa quinze dias de silêncio de um cliente que realmente foi embora. ### O que uma reconexão quebra A consequência da regra de inatividade que mais custa, e a que vale perguntar a qualquer provedor. - Dualhook:: A documentação deles não trata do que acontece com um override de webhook depois de uma reconexão. Isso não é prova de que não tratem, e é a pergunta que vale fazer direto a eles. - EasyCoexistence:: Uma remoção desinstala o app da conta e o override vai junto, então reconectar restaura envio e monitoramento enquanto a entrega no seu servidor silenciosamente não volta. Nós reaplicamos em toda reconexão, porque isso aconteceu com um número real que voltou limpo e parou de entregar. ### Quanto custa por número Os dois cobram um valor fixo mensal por número conectado em vez de por assento ou por mensagem, e nenhum coloca margem no que a Meta cobra pelas conversas. - Dualhook:: As próprias páginas de comparação deles descrevem um valor fixo mensal a partir de US$ 12 por mês, conforme publicado em setembro de 2026. - EasyCoexistence:: A partir de R$ 29,90 por número conectado por mês, caindo até R$ 4,90 conforme você adiciona números, sem limite de usuário nem de contato. Para uma agência a diferença se acumula a 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 deles é alcançado pela API e pelo painel. - EasyCoexistence:: Dezesseis ferramentas por um servidor MCP remoto com OAuth, então Claude, ChatGPT, Cursor e Claude Code listam números, checam saúde, enviam mensagens e templates, e definem destinos de webhook. Para uma agência fazendo onboarding de clientes por um assistente, é essa a diferença. - Ler um recurso não documentado como ausente. Pergunte a eles; esta página diz onde a documentação deles é silenciosa em vez de adivinhar. - Escolher só por preço. Os dois são valores pequenos perto do que a Meta cobra pelas conversas. - Achar que qualquer provedor reaplica um override de webhook depois de uma reconexão. Pergunte especificamente, seja quem for que você escolher. **É mesmo a mesma arquitetura?** No caminho de mensagem, sim. Os dois usam a capacidade da Meta de sobrescrever onde uma conta do WhatsApp Business entrega os webhooks, então o conteúdo das conversas vai para o seu servidor em vez de passar por um provedor. **Como as duas abordagens da regra de 14 dias diferem?** Eles avisam aos treze dias que o relógio está correndo. Nós lemos o motivo de desconexão da própria Meta, que separa quinze dias de silêncio de um cliente que foi embora, e reaplicamos o override de webhook depois, para a entrega não parar em silêncio. **Onde a EasyCoexistence difere?** Um conector MCP com dezesseis ferramentas, que a documentação deles não descreve, e reaplicar o override de webhook automaticamente depois de uma reconexão removê-lo. **Esta página é justa?** Todo valor aqui vem das páginas publicadas deles e está datado. Leia antes de decidir: uma comparação escrita por um dos lados é evidência, não veredito. --- ## Dá para usar o app do WhatsApp Business e a API no mesmo número? https://easycoexistence.com/pt/whatsapp-business-app-and-api-same-number Sim. A Meta chama isso de Coexistência, e é um recurso oficial, não uma gambiarra. A equipe continua atendendo no app do WhatsApp Business no celular, a Cloud API roda no mesmo número ao mesmo tempo, e as duas pontas veem as mesmas conversas. ### Como um número pode estar nos dois ao mesmo tempo? Porque a Meta criou um modo para isso. Historicamente essa era a escolha que ninguém queria fazer: migrar um número para a API significava que o app do WhatsApp Business parava de funcionar nele, então um negócio com equipe atendendo no celular precisava escolher entre as pessoas que já conheciam os clientes e a automação que queria acrescentar. A Coexistência elimina a escolha. O número é registrado na Meta como número de API enquanto o app do WhatsApp Business segue vinculado a ele. Uma mensagem do cliente chega no app do celular e no seu webhook, nas duas pontas, e uma resposta enviada de qualquer lado aparece na conversa. Nada está sendo simulado ou contornado: o app e a API são dois caminhos autorizados para o mesmo número. ### O que muda de verdade no celular? Menos do que as pessoas esperam, e vale conhecer as diferenças antes de conectar. A equipe segue como antes: mesmo app, mesmas conversas, mesmos contatos, mesmo número. O que some são quatro recursos que a Meta desliga em qualquer número em Coexistência: mensagens temporárias, mídia de visualização única, localização em tempo real e listas de transmissão. Os grupos continuam utilizáveis no app, mas ficam fora da API, então a automação não os enxerga. Existe também uma sincronização quando o número conecta pela primeira vez, que copia o histórico recente para a API não começar às cegas. Ela cobre as mensagens recentes, não o histórico inteiro do número, e tudo o que for mais antigo continua no celular, onde sempre esteve. ### Quebra alguma coisa se mudarmos de ideia? Não, e vale dizer com todas as letras porque é o medo que impede as pessoas de testar. As conversas moram no celular e sempre moraram. Desconectar o número da API deixa o app do WhatsApp Business funcionando exatamente como antes, com os históricos intactos, porque nada foi movido para lugar nenhum. A API foi acrescentada ao lado do app, não no lugar dele. O número também permanece o tempo todo no Portfólio de Negócios da própria empresa na Meta. Um provedor o conecta na condição de Tech Provider, que é uma permissão e não propriedade, então remover o provedor deixa o número onde estava em vez de levá-lo junto. ### O que é preciso para funcionar? Três coisas, e duas você já tem. O número precisa estar no app do WhatsApp Business, não no WhatsApp comum, e não pode já estar registrado na Cloud API em outro lugar. Além disso, é preciso um Meta Tech Provider para conduzir o onboarding, porque a Coexistência não pode ser ativada sozinha por um painel da Meta: a conexão é feita pelo app aprovado de um provedor. É aí que entramos. O Embedded Signup da própria Meta escolhe o portfólio, a conta e o número, um código é lido no app do WhatsApp Business para confirmar, e o número conecta em minutos. O app segue funcionando o tempo todo, inclusive enquanto a conexão é feita. - Achar que é preciso escolher. A Coexistência existe justamente para não precisar. - Esperar grupos pela API. Eles ficam no app e estão fora da API em qualquer provedor. - Esperar uma opção no painel da Meta. O onboarding de Coexistência passa por um Tech Provider. **Isso é oficial?** Sim. A Coexistência é recurso e termo da própria Meta. Não é ponte, dispositivo vinculado nem gambiarra. **A equipe vai notar diferença?** Só que quatro recursos sumiram: mensagens temporárias, visualização única, localização em tempo real e listas de transmissão. O resto fica igual. **Perco meu histórico de conversas?** Não. Ele fica no celular e continua lá. O histórico recente também é copiado para a API quando o número conecta. **Dá para desfazer?** Sim. Desconecte o número e o app segue exatamente como antes, com as conversas intactas. --- ## Como conectar o WhatsApp a uma API sem perder suas conversas https://easycoexistence.com/pt/connect-whatsapp-without-losing-chats Suas conversas moram no celular e conectar à API não as move. A Coexistência acrescenta a Cloud API ao lado do app do WhatsApp Business em vez de substituí-lo, então as conversas ficam onde estão e o app continua funcionando. ### Por que conectar à API costumava fazer perder as conversas? Porque o caminho antigo era uma migração, não um acréscimo. Registrar um número na Cloud API o tirava do app do WhatsApp Business, e o app era onde toda conversa morava. O número voltava como endpoint de API, sem histórico e sem app, e é por isso que tantos negócios olharam a API uma vez e desistiram. Esse custo era real e foi o maior motivo isolado para pequenos negócios ficarem fora da API oficial. Também empurrou gente para gateways não oficiais, que mantinham o app funcionando fingindo ser um dispositivo vinculado e, em troca, colocavam o número sob risco de banimento. ### O que a Coexistência faz de diferente? Ela acrescenta a API sem remover o app. O número é registrado na Meta como número de API enquanto o app do WhatsApp Business segue vinculado a ele, então os dois funcionam ao mesmo tempo no mesmo número. As conversas nunca se movem. Estão no celular, no app, exatamente onde estavam antes, e continuam lá independente do que aconteça com a conexão de API depois. Quando o número conecta pela primeira vez, a Meta sincroniza o histórico recente para o lado da API, para que uma automação ou um agente tenha contexto de uma conversa em andamento em vez de responder às cegas, mas isso é uma cópia adiante, não uma transferência. Nada sai do aparelho. Uma mensagem de cliente depois disso chega nos dois lugares: no app do celular e no seu webhook. A equipe responde no app se quiser, seu sistema responde se for o caso, e os dois aparecem na mesma conversa. ### O que exatamente sincroniza, e o que não? O histórico recente de mensagens sincroniza, dentro de uma janela após a conexão. É suficiente para uma automação ou um agente ter contexto de uma conversa em andamento. O que não sincroniza é tudo o que for mais antigo, mídia anterior à conexão e conversas em grupo. Nada disso se perde. Está no celular, no app, legível pela sua equipe exatamente como antes. Só não é copiado para o lado da API, porque a sincronização é um ponto de partida para automação, não um arquivo histórico. Se você precisa do histórico completo em outro lugar, exporte do app. Isso é um trabalho separado de conectar o número, e vale não confundir os dois. ### O que acontece se desconectarmos depois? O app continua e as conversas seguem lá, porque elas nunca saíram. Desconectar remove o lado de API do número. O app do WhatsApp Business segue funcionando com cada conversa intacta, e o negócio volta exatamente ao ponto de partida, sem nada para restaurar. Essa é a rede de segurança que vale entender antes de começar: a decisão é reversível de um jeito que a migração antiga nunca foi. O número também permanece o tempo todo no seu próprio Portfólio de Negócios da Meta. Um provedor o conecta como Tech Provider, que é uma permissão que você concede e pode retirar, então sair de um provedor não significa recuperar um número das mãos dele. - Exportar tudo antes por medo. As conversas não vão a lugar nenhum. - Esperar o histórico completo do lado da API. A sincronização é contexto recente, não arquivo. - Usar gateway não oficial para manter o app funcionando. A Coexistência faz isso sem risco de banimento. **Vou perder meu histórico de conversas?** Não. Ele está no celular e fica lá. Conectar acrescenta a API ao lado do app em vez de substituí-lo. **O histórico antigo aparece no meu sistema?** O histórico recente sincroniza depois de conectar. Mensagens e mídia mais antigas ficam no celular. **A equipe pode continuar usando o app?** Pode, exatamente como antes. É esse o ponto da Coexistência. **E se eu desconectar?** O app continua com cada conversa intacta, porque nada foi movido. --- ## O jeito mais barato de ter a API do WhatsApp Business https://easycoexistence.com/pt/cheapest-whatsapp-business-api A API em si é gratuita. O que você paga é a Meta pelas conversas e um provedor pelo acesso. A parte da Meta é igual em qualquer lugar, então a única variável que vale otimizar é a taxa do provedor, e o formato mais barato é valor fixo por número sem margem. ### Pelo que você está pagando, de verdade? Duas coisas separadas, e confundir as duas é por que as comparações de preço nesta categoria dão errado. A primeira é a precificação de conversas da Meta. A Meta cobra por conversa e por categoria, com valores que variam por país, e conversas de atendimento dentro da janela de 24 horas se comportam diferente das iniciadas pelo negócio. Esse custo existe independente de por quem você compra, porque é da Meta, e costuma ser o número maior. A segunda é o que um provedor cobra pelo acesso. Isso é decisão comercial dele, e é a única parte da conta que você realmente muda escolhendo diferente. Quem compara provedores por custo total sem separar as duas está comparando ruído. ### Onde o dinheiro vaza? Na margem, e é fácil não ver porque é pouco por mensagem. Vários provedores somam uma taxa por mensagem à da Meta. A Twilio publica US$ 0,005 por mensagem, entrando e saindo. A Gupshup publica US$ 0,001. Outros cotam um valor combinado com a taxa da Meta já embutida, o que significa que a margem é real e não pode ser conferida contra a tabela publicada da Meta. Um décimo de centavo não é nada até multiplicar. A cem mil mensagens por mês, o valor publicado da Gupshup dá US$ 100 e o da Twilio dá US$ 500, todo mês, em cima do que a Meta cobra. São esses os números que valem uma planilha antes de escolher por feature. ### Qual é o formato mais barato? Valor fixo por número conectado, com a conta da Meta indo direto para você e sem ninguém encostar nela. Esse formato tem duas propriedades que os outros não têm. O custo para de se mexer assim que o número conecta, então crescer não custa mais. E a fatura da Meta continua auditável, porque ninguém embutiu a própria taxa nela, o que permite conferir o que você paga à Meta contra a tabela publicada pela Meta. Nosso preço é a partir de R$ 29,90 por número conectado por mês, caindo até R$ 4,90 conforme você adiciona números, sem nada por mensagem. Ao valor publicado da Twilio isso já sai mais barato acima de cerca de 1.800 mensagens por mês, e a diferença só cresce. Plataformas por assento são outra conta: cobram por pessoa e não por mensagem, então o ponto de virada depende do tamanho da equipe. ### A opção mais barata é a certa? Não automaticamente, e vale ser honesto sobre quando não é. Se você quer uma caixa de entrada compartilhada, ferramenta de campanha e análise num produto só, onde sua equipe trabalha o dia inteiro, uma plataforma por assento está vendendo algo real e a taxa compra isso. Pagar menos para nós e depois construir aquilo por conta não é economia. A opção mais barata é a certa quando você já tem um sistema. Um negócio com CRM, helpdesk, ferramenta de automação ou agente de IA não precisa de um segundo lugar para ler mensagens; precisa que o WhatsApp chegue no primeiro. Para esse trabalho, pagar por número e nada por mensagem é o mínimo que dá para pagar continuando na API oficial. - Comparar provedores sem separar o custo de conversa da Meta da taxa do provedor. - Ler um valor combinado por mensagem como se não tivesse margem. Significa que a margem não está discriminada. - Escolher a taxa mais barata quando na verdade você precisa da caixa de entrada que a plataforma vende. **A API do WhatsApp Business é gratuita?** O acesso é. A Meta cobra pelas conversas, e provedores cobram pelo acesso por cima. A parte da Meta é igual em todo lugar. **Qual é o provedor mais barato?** O formato mais barato é valor fixo por número sem margem. O nosso começa em R$ 29,90 por número e cai até R$ 4,90 conforme você adiciona números. **Provedor mais barato significa API pior?** Não. A Cloud API é da Meta em todos os casos. Um provedor muda o que fica na frente dela e o quanto cobra. **Quando um provedor mais caro vale a pena?** Quando você quer o produto que ele vende, como uma caixa de entrada compartilhada onde sua equipe trabalha o dia todo. --- ## Componentes do template: cabeçalho, corpo, rodapé e botões https://easycoexistence.com/pt/docs/template-components Um template é montado com até quatro componentes: um cabeçalho, um corpo, um rodapé e botões. Só o cabeçalho e o corpo aceitam variáveis, e cada componente tem limites que decidem o que a mensagem pode dizer antes mesmo de a Meta revisar. ### Cabeçalho Opcional, e de um entre quatro tipos: texto, imagem, vídeo ou documento. Um cabeçalho de texto tem limite de sessenta caracteres e aceita uma única variável. Um cabeçalho de mídia carrega um arquivo fornecido no momento do envio, e é assim que um recibo ou um ingresso é anexado. - Cabeçalho de texto: 60 caracteres, no máximo uma variável. - Cabeçalho de mídia: imagem, vídeo ou documento, fornecido a cada envio. - Apenas um cabeçalho por template. - Existe um cabeçalho de localização disponível 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, então a primeira é preenchida pelo primeiro parâmetro que você enviar. A Meta rejeita corpos que são quase só variável com pouco texto fixo, porque um template que quase não diz nada por conta própria é indistinguível de um campo aberto para conteúdo arbitrário. Escreva uma frase de verdade em volta dos marcadores. ### Rodapé Opcional, sessenta caracteres, texto fixo sem nenhuma variável. Ele aparece menor e mais acinzentado que o corpo, o que o torna certo para um aviso permanente e errado para qualquer coisa de que a mensagem dependa. Um uso comum é uma linha para sair da lista em templates de marketing, o que também ajuda a reputação do template diante dos destinatários. ### Botões Até dez no total, em três tipos, e a combinação decide bastante sobre a aprovação. - Resposta rápida: envia de volta para você uma resposta de texto fixo quando é tocado. - Chamada para ação: abre uma URL ou disca um número de telefone. - Botões de URL aceitam uma variável, anexada ao fim de uma URL base fixa. - Copiar código: dá ao destinatário um código para copiar, usado em autenticação. ### Por que a estrutura importa antes da revisão A Meta revisa o template como um todo, e a maior parte das rejeições é estrutural, e não sobre a redação. Um corpo que é quase inteiramente variáveis, um botão de URL apontando para algo sem relação com o negócio, ou uma mensagem de marketing submetida sob a categoria de utilidade são todos rejeitados pela estrutura. Acertar o formato primeiro torna a revisão da redação simples, e um template rejeitado por política devolve o erro 132007, e não algo que nomeie a causa real. - Escrever um corpo que é quase só marcadores. A Meta rejeita templates com texto fixo de menos. - Esperar variáveis no rodapé. Ele é texto fixo, sem exceções. - Submeter uma mensagem de marketing sob a categoria de utilidade. A redação não vai salvar a categoria errada. **Quais partes aceitam variáveis?** O cabeçalho, no máximo uma, e o corpo, várias. Os rodapés nunca aceitam, e os botões de URL aceitam um valor anexado. **Qual é o tamanho máximo do corpo?** 1024 caracteres, o que o torna o componente mais longo por uma margem enorme. **Quantos botões são permitidos?** Até dez no total, com limites dentro de cada tipo. **Por que meu template foi rejeitado?** Na maioria das vezes por estrutura, e não por redação: palavras fixas de menos, ou a categoria errada. Isso devolve o erro 132007. --- ## O ciclo de vida do status do template https://easycoexistence.com/pt/docs/template-status-lifecycle Um template percorre uma sequência de estados, e a aprovação é o meio dessa sequência, não o fim. Um template aprovado pode ser pausado por qualidade, reativado, pausado de novo e por fim desativado em definitivo, tudo isso sem que ninguém encoste nele. ### Os estados Na ordem em que um template normalmente os encontra. - PENDING: submetido e aguardando revisão. - APPROVED: pronto para ser usado em envios. - REJECTED: recusado na revisão, normalmente por estrutura ou categoria. - PAUSED: temporariamente inutilizável depois de uma queda de qualidade. - DISABLED: inutilizável em definitivo, o fim da linha. ### Como um template é pausado Não por nada que você faça. Os destinatários bloqueiam ou denunciam as mensagens enviadas com ele, a classificação de qualidade do próprio template cai de verde para amarelo e depois para vermelho, e a Meta o pausa para interromper a queda. Uma pausa é temporária e se desfaz sozinha. O que importa é o que vem depois: pausas repetidas escalam, e um template que insiste em voltar ao vermelho acaba desativado em definitivo, em vez de pausado mais uma vez. ### Os dois webhooks Os dois são necessários para enxergar o ciclo inteiro, e assinar 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 se movendo entre verde, amarelo e vermelho. - O webhook de qualidade é o aviso antecipado; o de status é a consequência. - Nenhum dos dois vem ligado por padrão, então os dois precisam ser assinados. ### Por que o amarelo é o momento de agir Quando um template é pausado, o envio com ele já falha e uma campanha já está quebrada. O amarelo é o estado em que ele ainda funciona e a queda já está visível. Agir no amarelo significa olhar para o público além da redação. Um template bem escrito enviado para quem não esperava por ele coleta bloqueios tão rápido quanto um mal escrito, e reescrever o texto mantendo a mesma lista não muda nada. ### O que a edição provoca Um template aprovado pode ser editado, o que o manda de volta para a revisão. Isso é útil e tem uma consequência que as pessoas encontram em produção: se a edição mudar o número de variáveis, todo envio feito por uma integração não atualizada passa a falhar com o erro 132012. Trate a contagem de variáveis de um template como parte do contrato da integração, e não como um texto que alguém do marketing é dono. - Tratar a aprovação como permanente. Um template aprovado pode ser pausado e por fim desativado. - Assinar o webhook de status e não o de qualidade. O campo de qualidade é o aviso antecipado. - Editar as variáveis de um template sem conferir o código que faz o envio. **Um template aprovado continua aprovado?** Não necessariamente. Retorno negativo sustentado pode pausá-lo e por fim desativá-lo em definitivo. **Qual é a diferença entre pausado e desativado?** Uma pausa se desfaz sozinha. Desativado é permanente e o template não pode ser usado de novo. **Como eu vejo isso chegando?** Assine o webhook de qualidade de template. Ele reporta a mudança para amarelo enquanto o template ainda funciona. **Por que os envios começaram a falhar depois de uma edição?** Se a edição mudou a contagem de variáveis, a integração não atualizada agora manda o número errado de parâmetros e recebe o erro 132012. --- ## Enviando um template com variáveis https://easycoexistence.com/pt/docs/sending-a-template-with-variables As variáveis de template são posicionais, não nomeadas. Você envia uma lista de parâmetros por componente, em ordem, e a contagem tem que bater exatamente com o que o template define. Três erros diferentes nascem de errar isso, e cada um aponta para um engano distinto. ### Como os parâmetros são associados Por posição, e não por nome. O primeiro parâmetro da lista do corpo preenche o primeiro marcador, o segundo preenche o segundo, e assim por diante. Não existe forma de nomear uma variável, e trocar dois parâmetros de lugar produz uma mensagem que é enviada com sucesso e com os valores nos lugares errados. Esse último caso é o perigoso, porque nada falha. Um cliente recebe uma confirmação de pedido com a data onde deveria estar o valor, e nenhum erro é registrado em lugar nenhum. ### Componentes são listas separadas Uma variável de cabeçalho e uma variável de corpo não compartilham a mesma lista. Cada componente carrega os próprios parâmetros, e juntá-los produz uma divergência de contagem. - Os parâmetros de cabeçalho vão num componente de cabeçalho, e existe no máximo um. - Os parâmetros de corpo vão num componente de corpo, em ordem. - Os parâmetros de URL de botão vão num componente de botão, indexados por botão. - Enviar uma lista única e achatada com todos eles devolve o erro 132000. ### Acertando o idioma Um template é identificado por nome e idioma juntos, então o mesmo nome em dois idiomas são dois templates. Enviar en onde o template foi criado como en_US não faz fallback: falha com o erro 132001, que se lê como se o template não existisse. Liste os templates do número e copie a string de idioma exata, em vez de supor o formato dela. Este é o erro de template mais comum de todos e o menos descritivo. ### Parâmetros tipados A maior parte dos parâmetros é texto simples. Alguns não são, e enviá-los como texto falha com o erro 132012. - Parâmetros de moeda carregam um valor, um código de moeda e uma string de fallback. - Parâmetros de data e hora carregam um objeto estruturado com um fallback. - Parâmetros de cabeçalho de mídia carregam um id de mídia ou um link, não um nome de arquivo. - A string de fallback é o que aparece se o app do destinatário não conseguir formatar o valor. ### O que cada erro significa As três falhas são distinguíveis, o que poupa muita adivinhação se forem registradas separadamente em vez de agrupadas como um erro de template. O erro 132001 significa que o par de nome e idioma não resolveu, então confira o idioma primeiro. O erro 132000 significa que a contagem está errada, então compare com a definição do próprio template. O erro 132012 significa que o formato de um valor está errado, o que normalmente é um parâmetro tipado enviado como string simples. - Supor que en faz fallback para en_US. Não faz, e o erro se lê como template inexistente. - Juntar os parâmetros de cabeçalho e de corpo numa lista só. Eles são componentes separados. - Enviar uma moeda ou uma data como texto simples. Parâmetros tipados têm um formato definido. **As variáveis de template são nomeadas?** Não. Elas são posicionais, então a ordem dos parâmetros é todo o contrato. **Por que meu template não existe?** Normalmente é o código de idioma. Um template é identificado por nome e idioma juntos, e não há fallback. **E se eu enviar parâmetros demais?** Erro 132000. Parâmetros demais falham do mesmo jeito que parâmetros de menos. **Como eu envio um valor em dinheiro?** Como um parâmetro de moeda, com um valor, um código de moeda e uma string de fallback, e não como texto simples. --- ## Limites de taxa e throughput de mensagens https://easycoexistence.com/pt/docs/rate-limits-and-throughput São 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 no Portfólio de Negócios, o throughput restringe as mensagens por segundo, o limite por par restringe as mensagens para uma única pessoa e o limite de gerenciamento restringe as chamadas de API que não são mensagens. ### Nível de mensagens Quantos clientes únicos você pode alcançar com mensagens fora da janela de atendimento em 24 horas móveis. Desde 7 de outubro de 2025, ele é definido por Portfólio de Negócios e compartilhado por todos os números dele, e sobe automaticamente conforme a qualidade se mantém e o volume cresce. - Os limites sobem em degraus: 250, 2.000, 10.000, 100.000 e destinatários únicos ilimitados por dia. - Só contam as entregas feitas fora da janela de atendimento. - As respostas dentro da janela de atendimento não contam. - Uma queda de qualidade não faz mais o limite voltar a descer, mas impede que ele cresça. ### 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 throughput ao enviar uma rajada. Em um número com Coexistência, esse é o limite que mais surpreende, porque o teto é menor do que em um número comum da Cloud API. Esse teto é da Meta e vale para todo provedor de Coexistência, então nenhum provedor consegue aumentá-lo. ### Limites por destinatário Um teto separado para quantas mensagens circulam entre o seu número e um destinatário em uma janela curta, informado pelo erro 131056. Ele existe para evitar que uma pessoa seja inundada de mensagens, então pode ocorrer em uma conta de baixo volume. A causa quase sempre é automática: um loop de repetição, um handler de webhook acionado duas vezes para o mesmo evento ou um bot que divide uma resposta em várias mensagens curtas. ### Limites de chamadas de gerenciamento Não tem nada a ver com mensagens. Ler números, listar templates e consultar o status contam contra um limite separado da conta, informado pelo erro 80007. O que o esgota é o polling. Consultar o status a cada trinta segundos são milhares de chamadas por dia sobre dados que mudam poucas vezes por mês, e o webhook elimina a necessidade de quase todas elas. ### O que aumenta um limite Qualidade e histórico, não pagamento. Não existe plano para comprar nem provedor que possa liberar um teto em seu nome. - Mantenha uma classificação de qualidade verde; os bloqueios feitos por destinatários são o que a reduzem. - Envie o volume de forma constante, em vez de em rajadas. - Conclua a verificação do negócio, um dos caminhos de 250 para 2.000. - Use 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 geram quatro erros diferentes. - Consultar o status em intervalos curtos. Isso consome o limite de gerenciamento com dados que raramente mudam. - Esperar pagar por um limite maior. Os limites sobem com a qualidade e o histórico. **Por que estou com limite de taxa mesmo com baixo volume?** Provavelmente é o limite por destinatário, erro 131056, que restringe as mensagens para uma única pessoa, independentemente do total da sua conta. **Posso pagar por um limite de mensagens maior?** Não. Os limites sobem automaticamente com a qualidade e o histórico de envios. **O throughput é menor na Coexistência?** Sim. A Meta o limita a um valor menor do que em um número comum da Cloud API, e nenhum provedor consegue aumentá-lo. **O que conta para o limite de gerenciamento?** Chamadas de leitura e de configuração: listar números, templates e status. O webhook evita quase todas elas. --- ## Enviando mensagens interativas: botões e listas https://easycoexistence.com/pt/docs/sending-interactive-messages As mensagens interativas dão ao destinatário botões ou uma lista para tocar em vez de digitar. Existem dois tipos, botões de resposta e mensagens de lista, e ambos têm limites pequenos e fixos que decidem o desenho da conversa mais do que qualquer outra coisa. ### Botões de resposta Até três botões embaixo de uma mensagem. O destinatário toca em um e a resposta chega no seu webhook como uma mensagem de entrada comum carregando o id do botão, então você faz a correspondência pelo id e não pelo rótulo. Os títulos têm limite de vinte caracteres, o que é mais curto do que parece e é a restrição que normalmente obriga a reescrever. - Máximo de três botões por mensagem. - Título limitado a 20 caracteres. - Cada botão carrega um id escolhido por você, devolvido na resposta. - Cabeçalho, corpo e rodapé opcionais em volta deles. ### Mensagens de lista Um único botão que abre um menu de até dez linhas, agrupadas em até dez seções. Cada linha tem um título, uma descrição opcional e um id. Use quando três botões não bastarem, e lembre que o destinatário precisa abrir a lista antes de ver qualquer coisa dentro dela, então o rótulo do botão é que carrega o peso. - Até 10 linhas no total, distribuídas em até 10 seções. - Título da linha limitado a 24 caracteres, descrição a 72. - Uma lista por mensagem, e ela não pode ser combinada com botões. - Não está disponível em mensagens de template de todas as categorias. ### Como a resposta chega Pelo mesmo webhook de mensagens de qualquer outra mensagem de entrada, com um objeto interativo nomeando o id do botão ou da linha. Não é preciso assinar nada à parte. Faça a correspondência pelo id, e não pelo título. Os títulos são reescritos por quem edita o texto, e um handler que compara texto quebra silenciosamente na primeira vez em que alguém corrigir um erro de digitação. ### O que a Coexistência muda Nada nos botões e nas listas em si. Eles são mensagens comuns da Cloud API e funcionam num número em Coexistência do mesmo jeito que em qualquer outro. O que muda é onde a resposta cai: o toque do cliente chega tanto no app do WhatsApp Business no celular quanto no seu webhook, porque um número em Coexistência entrega nos dois. Um handler que responde automaticamente deveria levar em conta que um humano pode responder a mesma mensagem pelo app. - Fazer a correspondência das respostas pelo título do botão. Títulos são editados; ids não. - Projetar para mais de três botões. O limite é rígido e não existe contorno. - Esquecer que um humano pode responder ao mesmo toque pelo app do WhatsApp Business. **Quantos botões eu posso enviar?** Três. É um limite rígido da plataforma, sem contorno possível. **O que volta quando alguém toca?** Uma mensagem de entrada comum no webhook de mensagens, carregando o id que você atribuiu àquele botão ou àquela linha. **Posso combinar botões e uma lista?** Não. Uma mensagem leva um ou a outra. **Isso custa mais caro?** Não. São mensagens comuns, precificadas pela Meta do mesmo jeito que qualquer outra naquela conversa. --- ## Enviando mídia: imagens, vídeo, áudio e documentos https://easycoexistence.com/pt/docs/sending-media-messages A mídia é enviada de duas formas: subindo o arquivo primeiro e referenciando o id devolvido, ou dando à Meta um link público para buscar. Subir o arquivo é mais confiável, e os limites de tamanho variam por tipo de um jeito que pega as pessoas de surpresa. ### Os limites, por tipo Diferentes para cada um, e ultrapassar qualquer um deles devolve o erro 131053, em vez de algo descritivo. - Imagens: 5 MB. JPEG e PNG. - Vídeo: 16 MB. MP4 e 3GPP, com vídeo em H.264 e áudio em AAC. - Áudio: 16 MB. AAC, AMR, MP3, áudio MP4 e OGG com Opus. - Documentos: 100 MB. A maioria dos tipos comuns de documento, incluindo PDF e formatos do Office. - Figurinhas: 100 KB animadas, 500 KB estáticas, apenas WebP. ### Subir o arquivo ou linkar Duas formas de enviar o mesmo arquivo, e elas falham de maneiras diferentes. Subir envia o arquivo para a Meta primeiro e devolve um id de mídia que você referencia no envio. Linkar dá à Meta uma URL para buscar na hora do envio. O caminho do link parece mais simples e acrescenta um modo de falha que você não enxerga: uma URL que abre no seu navegador pode ser inalcançável a partir da infraestrutura da Meta por causa de geografia, de uma regra de firewall ou de um cookie de sessão que o seu navegador já guarda. Suba o arquivo. É uma requisição a mais e elimina uma classe inteira de falhas. ### Recebendo mídia A mídia de entrada chega como um id de mídia, e não como bytes. Seu handler busca o arquivo separadamente usando esse id. - Busque logo. Os ids não continuam válidos indefinidamente. - Uma busca que falha devolve o erro 131052, que normalmente significa que o upload do remetente ficou incompleto. - Guarde o arquivo por sua conta se for precisar dele depois. A Meta não é um arquivo morto. - Registre a mensagem mesmo quando a busca de mídia falhar, para que o texto e o contexto sobrevivam. ### O que a Coexistência muda A mídia num número em Coexistência funciona exatamente como em qualquer outro número da Cloud API, com os mesmos limites. A única diferença que vale conhecer é o histórico. Quando um número se conecta pela primeira vez, a Meta sincroniza as mensagens recentes do app do WhatsApp Business, e essa sincronização cobre o texto das mensagens, em vez de ser um arquivo completo de mídia. A mídia anterior à conexão continua no celular, onde sempre esteve. - Mandar um link porque parece mais simples. A rede da Meta não é o seu navegador. - Buscar a mídia de entrada horas depois. Os ids de mídia expiram. - Exportar vídeo sem conferir o codec. Os padrões dos softwares de edição muitas vezes não são suportados. **Qual é o maior arquivo que eu posso enviar?** 100 MB, e apenas para documentos. Vídeo e áudio param em 16 MB e imagens em 5 MB. **Devo subir o arquivo ou mandar uma URL?** Suba o arquivo. Isso elimina a alcançabilidade como causa de falha. **Por quanto tempo um id de mídia é válido?** Não é indefinidamente, e é por isso que a mídia de entrada deve ser buscada assim que o evento chega. **A mídia antiga sincroniza quando eu conecto?** Não. A sincronização de histórico cobre o conteúdo das mensagens recentes; a mídia anterior à conexão fica no celular. --- ## Reações a mensagens: enviando e recebendo emoji https://easycoexistence.com/pt/docs/message-reactions Uma reação anexa um único emoji a uma mensagem existente. Enviar uma significa referenciar o id da mensagem e o emoji, e remover uma significa enviar a mesma reação com a string de emoji vazia, em vez de chamar uma exclusão. ### Enviando uma reação Uma mensagem do tipo reaction, carregando o id da mensagem que está sendo reagida e um único emoji. Enviar uma segunda reação para a mesma mensagem substitui a primeira, em vez de somar a ela, porque um remetente só pode ter uma reação por mensagem. O id da mensagem precisa ser um que o seu número consiga enxergar: uma mensagem de entrada daquele cliente, ou uma que você enviou para ele. ### Removendo uma reação A parte que surpreende as pessoas. Não existe chamada de exclusão. Você envia a mesma mensagem de reação com o campo de emoji definido como uma string vazia, e isso limpa a reação. Um handler escrito para esperar um evento de remoção vai esperar para sempre. O que chega é uma reação com emoji vazio, que tem o mesmo formato de uma reação nova e precisa ser lida como remoção por meio da verificação do campo. ### Recebendo reações As reações de entrada chegam pelo webhook de mensagens como uma mensagem do tipo reaction, nomeando o id da mensagem à qual se anexam e o emoji. - Assine o campo messages; não existe um campo separado para reações. - Um emoji vazio significa que o cliente removeu a reação dele. - O id de mensagem referenciado é de algo que você enviou ou recebeu antes. - As reações não reabrem a janela de atendimento de 24 horas. ### A janela continua valendo Uma reação é uma mensagem, então enviar uma exige que a janela de atendimento de 24 horas esteja aberta. Reagir à mensagem de um cliente de três dias atrás devolve o erro 131047, exatamente como aconteceria com uma mensagem de texto. Receber uma reação de um cliente reabre sim a janela, porque qualquer mensagem de entrada reabre. Isso vale conhecer para automações: um joinha na sua última mensagem é um sinal válido de que agora você pode responder livremente. - Procurar um endpoint de exclusão. A remoção é 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 atendimento. Ela falha como qualquer outra mensagem. **Como eu removo uma reação?** Envie a mesma mensagem de reação com uma string de emoji vazia. Não existe chamada de exclusão. **As reações custam alguma coisa?** Não. Elas não abrem uma conversa cobrável. **Posso reagir a qualquer mensagem?** Só a mensagens que o seu número enviou ou recebeu, e só dentro da janela de atendimento de 24 horas. **A reação de um cliente reabre a janela?** Reabre. Qualquer mensagem de entrada vinda dele reabre, inclusive uma reação. --- ## Enviando mensagens de localização e de contato https://easycoexistence.com/pt/docs/sending-location-and-contacts As mensagens de localização enviam um pino com nome e endereço opcionais. As mensagens de contato enviam um ou mais cartões de contato. Ambas são simples, e o limite que vale conhecer é que a localização em tempo real, que se atualiza conforme a pessoa se move, não está disponível num número em Coexistência. ### Mensagens de localização Latitude e longitude, com um nome e um endereço opcionais exibidos embaixo do pino. O destinatário vê uma prévia de mapa e pode abri-la no próprio aplicativo de mapas dele. Fornecer o nome e o endereço vale o esforço. Sem eles, o pino mostra coordenadas, o que não diz nada ao cliente sobre se ele está olhando para a unidade certa. ### Recebendo uma localização Um cliente compartilhando a localização dele chega pelo webhook de mensagens como uma mensagem do tipo location, com coordenadas e, quando o app do cliente as fornece, um nome e um endereço. - As coordenadas estão sempre presentes; o nome e o endereço não. - Uma localização compartilhada é uma mensagem, então ela reabre a janela de atendimento de 24 horas. - Trate as coordenadas como aproximadas. A precisão dos celulares varia. - Guarde o que você precisar. A Meta não é um histórico de localização. ### Mensagens de contato Um ou mais cartões de contato numa única mensagem, cada um carregando os campos de um vCard: nomes, telefones, e-mails, endereços, organização e data de nascimento. O destinatário pode salvar o cartão direto. Útil para entregar ao cliente os dados da pessoa certa, em vez de digitar um número dentro de um chat, onde ele chega como texto sem formatação e precisa ser copiado à mão. ### O que a Coexistência remove A localização em tempo real é um dos quatro recursos do WhatsApp que a Meta desliga num número quando a Coexistência está ativa, ao lado das mensagens temporárias, da mídia de visualização única e das listas de transmissão. Tentar enviar uma devolve o erro 131051, tipo de mensagem não suportado, que se lê como um engano de formatação e não é. Nenhum provedor consegue habilitar isso: a restrição é da Meta e vale para todo número em Coexistência. Os pinos de localização estáticos não são afetados e funcionam normalmente. - Enviar um pino sem nome nem endereço. Só coordenadas não dizem nada ao cliente. - Construir em cima da localização em tempo real. Ela está desativada em todo número em Coexistência. - Ler o erro 131051 como um defeito de formatação quando o tipo é genuinamente indisponível. **Posso enviar localização em tempo real?** Num número em Coexistência, não. A Meta desativa isso e nenhum provedor consegue religar. **Os pinos de localização estáticos funcionam?** Funcionam, normalmente, com nome e endereço opcionais exibidos embaixo da prévia do mapa. **Quantos contatos cabem numa mensagem?** Vários. Cada um carrega os campos padrão do vCard e pode ser salvo direto pelo destinatário. **Uma localização compartilhada reabre a janela de atendimento?** Reabre. Ela é uma mensagem de entrada como qualquer outra. --- ## EasyCoexistence vs AiSensy https://easycoexistence.com/pt/compare/easycoexistence-vs-aisensy A AiSensy é uma plataforma de marketing e chatbot de WhatsApp vendida em planos mensais, popular entre negócios de ecommerce indianos. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer um produto para trabalhar dentro. ### O que cada produto é Não estão disputando a mesma compra, e ser claro sobre isso torna a comparação útil. - AiSensy:: Uma plataforma de engajamento no WhatsApp construída em torno de campanhas de disparo, fluxos de chatbot e uma caixa de entrada de equipe, vendida em planos mensais por faixa, com limites de contato e de atendente, a partir de 1.500 rupias por mês. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para a sua equipe se mudar. ### Para quem o produto foi desenhado Os dois conectam WhatsApp. O trabalho diário que cada um espera que você faça é diferente. - AiSensy:: Um time de marketing rodando campanhas de disparo e funis de chatbot, que quer o construtor de campanha, as listas de contato e a análise num lugar só e está contente em trabalhar ali dentro. - EasyCoexistence:: Um negócio ou desenvolvedor que já tem um sistema. Nós colocamos as mensagens de WhatsApp dentro dele e mantemos a conexão viva, e depois saímos da frente. Se você quer campanhas, rode onde os dados dos seus clientes já estão. ### Manter o app no celular A coisa específica para a qual a Coexistência existe, e a pergunta que vale fazer a qualquer plataforma. - AiSensy:: O produto deles é a caixa de entrada da plataforma, então a expectativa é que as conversas sejam tratadas ali e não no app do WhatsApp Business num celular. - EasyCoexistence:: O app do WhatsApp Business continua funcionando exatamente como antes. A equipe atende pelo celular, a API vê as mesmas conversas, e nenhum dos lados precisa parar. É esse o recurso inteiro. ### Para quem o bill acompanha A diferença estrutural, e a que decide o total conforme você cresce. - AiSensy:: Uma assinatura moldada em torno de usuários e faixas de plano, então a conta acompanha o tamanho da equipe e os recursos liberados, paga usando ou não os assentos. - EasyCoexistence:: Um número conectado. Acrescentar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são acrescentados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar de qualquer coisa que guarda suas conversas. - AiSensy:: A caixa de entrada, o histórico de contatos e as automações moram na plataforma. É isso que faz elas funcionarem, e é também o que torna sair um projeto de migração. - EasyCoexistence:: Nada seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegavam, e o número fica no Portfólio de Negócios do próprio cliente na Meta, então nos remover deixa ele exatamente onde estava. - Comparar preço por assento com preço por número sem contar os dois para o seu formato. - Pagar por uma caixa de entrada quando sua equipe já trabalha num CRM. - Achar que a conexão de WhatsApp é diferente. A Cloud API por baixo é da Meta nos dois casos. **Qual é mais barato?** Depende do formato. Uma equipe de cinco numa caixa de entrada pode preferir assentos. Um negócio com números e um sistema existente paga muito menos por número com a gente. **Perco uma caixa de entrada compartilhada?** Você nunca se muda para uma. As mensagens chegam na ferramenta que sua equipe já usa, que é onde ela já trabalha. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como é cobrada. **Eu ganho campanhas de disparo?** Não da nossa parte, e você não paga por elas. As mensagens chegam no seu próprio sistema, então as campanhas rodam onde os dados dos seus clientes já estão. --- ## EasyCoexistence vs Interakt https://easycoexistence.com/pt/compare/easycoexistence-vs-interakt A Interakt é uma plataforma de comércio e atendimento no WhatsApp vendida em planos mensais com limite por atendente. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer um produto para trabalhar dentro. ### O que cada produto é Não estão disputando a mesma compra, e ser claro sobre isso torna a comparação útil. - Interakt:: Uma plataforma de comércio no WhatsApp com integração de catálogo, notificação de pedido, caixa de entrada compartilhada e automação, vendida em planos mensais com limite de atendente e de contato, a partir de 3.499 rupias por trimestre. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para a sua equipe se mudar. ### Onde mora a lógica de comércio A bifurcação real para uma loja online, e ela é sobre onde seu catálogo já está. - Interakt:: Dentro da plataforma, conectada à sua loja, o que é conveniente se você quer notificação de pedido e mensagem de catálogo configuradas num lugar só, sem desenvolvimento. - EasyCoexistence:: Dentro da sua loja. Nós entregamos os eventos de WhatsApp no seu backend, então as notificações de pedido são enviadas pelo sistema que já sabe o que é um pedido. Nada precisa ser sincronizado para dentro de um segundo produto. ### O que uma agência paga Onde cobrança por atendente e cobrança por número divergem mais. - Interakt:: Planos com limite de atendente e de contato, então um negócio gerenciando números para vários clientes está comprando assentos e cotas por conta. - EasyCoexistence:: Uma conta guarda quantos números de cliente você quiser, cada um cobrado como conexão a uma tarifa que cai com o volume. Não há atendente para contar nem cota de contato para estourar. ### Para quem o bill acompanha A diferença estrutural, e a que decide o total conforme você cresce. - Interakt:: Uma assinatura moldada em torno de usuários e faixas de plano, então a conta acompanha o tamanho da equipe e os recursos liberados, paga usando ou não os assentos. - EasyCoexistence:: Um número conectado. Acrescentar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são acrescentados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar de qualquer coisa que guarda suas conversas. - Interakt:: A caixa de entrada, o histórico de contatos e as automações moram na plataforma. É isso que faz elas funcionarem, e é também o que torna sair um projeto de migração. - EasyCoexistence:: Nada seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegavam, e o número fica no Portfólio de Negócios do próprio cliente na Meta, então nos remover deixa ele exatamente onde estava. - Comparar preço por assento com preço por número sem contar os dois para o seu formato. - Pagar por uma caixa de entrada quando sua equipe já trabalha num CRM. - Achar que a conexão de WhatsApp é diferente. A Cloud API por baixo é da Meta nos dois casos. **Qual é mais barato?** Depende do formato. Uma equipe de cinco numa caixa de entrada pode preferir assentos. Um negócio com números e um sistema existente paga muito menos por número com a gente. **Perco uma caixa de entrada compartilhada?** Você nunca se muda para uma. As mensagens chegam na ferramenta que sua equipe já usa, que é onde ela já trabalha. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como é cobrada. **Dá para fazer mensagem de catálogo?** Pela Cloud API no seu próprio número, dá, enviada pelo seu próprio sistema. Nós não construímos um catálogo para você porque sua loja já tem um. --- ## EasyCoexistence vs DoubleTick https://easycoexistence.com/pt/compare/easycoexistence-vs-doubletick O DoubleTick é uma plataforma de vendas no WhatsApp vendida por usuário, construída em torno de uma caixa de entrada compartilhada com foco em celular. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer um produto para trabalhar dentro. ### O que cada produto é Não estão disputando a mesma compra, e ser claro sobre isso torna a comparação útil. - DoubleTick:: Uma plataforma de vendas no WhatsApp construída em torno de uma caixa de entrada compartilhada no celular, envio em massa e compartilhamento de catálogo, cobrada por assento de usuário e voltada a equipes de venda que trabalham pelo telefone. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para a sua equipe se mudar. ### Como a equipe de vendas trabalha no dia a dia A decisão de compra por baixo dos dois produtos. - DoubleTick:: No app deles, onde moram a caixa de entrada compartilhada, o catálogo e o envio em massa, num plano que começa por volta de 2.500 rupias por mês e é cobrado por usuário, então a conta acompanha quantos vendedores você tem. - EasyCoexistence:: No CRM que a equipe já usa. Nós entregamos a conversa nele, então um vendedor vê o WhatsApp ao lado do registro do negócio em vez de num app separado que ele precisa lembrar de abrir. ### Quanto custa um segundo número Comum numa operação de vendas com mais de uma linha. - DoubleTick:: Assentos são a unidade cobrada, então um segundo número fica ao lado de uma assinatura por usuário que cresce com a equipe. - EasyCoexistence:: O segundo número é simplesmente o segundo número, na tarifa publicada, caindo conforme mais são acrescentados. O tamanho da equipe não entra na conta. ### Para quem o bill acompanha A diferença estrutural, e a que decide o total conforme você cresce. - DoubleTick:: Uma assinatura moldada em torno de usuários e faixas de plano, então a conta acompanha o tamanho da equipe e os recursos liberados, paga usando ou não os assentos. - EasyCoexistence:: Um número conectado. Acrescentar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são acrescentados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar de qualquer coisa que guarda suas conversas. - DoubleTick:: A caixa de entrada, o histórico de contatos e as automações moram na plataforma. É isso que faz elas funcionarem, e é também o que torna sair um projeto de migração. - EasyCoexistence:: Nada seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegavam, e o número fica no Portfólio de Negócios do próprio cliente na Meta, então nos remover deixa ele exatamente onde estava. - Comparar preço por assento com preço por número sem contar os dois para o seu formato. - Pagar por uma caixa de entrada quando sua equipe já trabalha num CRM. - Achar que a conexão de WhatsApp é diferente. A Cloud API por baixo é da Meta nos dois casos. **Qual é mais barato?** Depende do formato. Uma equipe de cinco numa caixa de entrada pode preferir assentos. Um negócio com números e um sistema existente paga muito menos por número com a gente. **Perco uma caixa de entrada compartilhada?** Você nunca se muda para uma. As mensagens chegam na ferramenta que sua equipe já usa, que é onde ela já trabalha. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como é cobrada. **Tem app de celular?** O nosso é infraestrutura, então o app que sua equipe usa é o que ela já tem. O app do WhatsApp Business também continua funcionando no celular o tempo todo. --- ## EasyCoexistence vs Zoko https://easycoexistence.com/pt/compare/easycoexistence-vs-zoko O Zoko é uma plataforma de comércio no WhatsApp para lojas Shopify, vendida em planos mensais. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer um produto para trabalhar dentro. ### O que cada produto é Não estão disputando a mesma compra, e ser claro sobre isso torna a comparação útil. - Zoko:: Uma plataforma de comércio no WhatsApp construída bem em torno do Shopify, cobrindo catálogo, recuperação de carrinho abandonado, fluxos de pedido e caixa de entrada compartilhada, vendida em planos mensais que não são exibidos publicamente. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para a sua equipe se mudar. ### Se você é uma loja Shopify A resposta honesta, porque é genuinamente outra compra. - Zoko:: Feito exatamente para isso. Recuperação de carrinho, catálogo e fluxos de pedido são configurados em vez de desenvolvidos, o que vale dinheiro de verdade se o Shopify é o seu negócio inteiro e você quer aquilo funcionando esta semana. - EasyCoexistence:: A camada por baixo, a partir de R$ 29,90 por número. Se sua loja não é Shopify, ou a lógica mora no seu próprio backend, nós entregamos os eventos de WhatsApp nele e deixamos o seu sistema decidir o que uma mensagem significa. Não há nada para configurar em torno de uma plataforma que não temos. ### O que acontece quando a loja não é o negócio inteiro O caso em que uma plataforma nativa de vitrine deixa de encaixar. - Zoko:: Profundidade num ecossistema só, que é a troca que um especialista faz e a razão de funcionar tão bem lá dentro. - EasyCoexistence:: Indiferença ao ecossistema. O webhook vai para o seu endpoint, então a mesma conexão serve uma loja Shopify, um backend próprio, um fluxo no n8n ou um agente de IA sem mudar nada em como o número está conectado. ### Para quem o bill acompanha A diferença estrutural, e a que decide o total conforme você cresce. - Zoko:: Uma assinatura moldada em torno de usuários e faixas de plano, então a conta acompanha o tamanho da equipe e os recursos liberados, paga usando ou não os assentos. - EasyCoexistence:: Um número conectado. Acrescentar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são acrescentados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar de qualquer coisa que guarda suas conversas. - Zoko:: A caixa de entrada, o histórico de contatos e as automações moram na plataforma. É isso que faz elas funcionarem, e é também o que torna sair um projeto de migração. - EasyCoexistence:: Nada seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegavam, e o número fica no Portfólio de Negócios do próprio cliente na Meta, então nos remover deixa ele exatamente onde estava. - Comparar preço por assento com preço por número sem contar os dois para o seu formato. - Pagar por uma caixa de entrada quando sua equipe já trabalha num CRM. - Achar que a conexão de WhatsApp é diferente. A Cloud API por baixo é da Meta nos dois casos. **Qual é mais barato?** Depende do formato. Uma equipe de cinco numa caixa de entrada pode preferir assentos. Um negócio com números e um sistema existente paga muito menos por número com a gente. **Perco uma caixa de entrada compartilhada?** Você nunca se muda para uma. As mensagens chegam na ferramenta que sua equipe já usa, que é onde ela já trabalha. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como é cobrada. **Eu uso Shopify. Devo usar o Zoko?** Se você quer recuperação de carrinho e fluxos de catálogo configurados em vez de construídos, eles encaixam bem nisso. Se a sua lógica mora no seu próprio sistema, nós colocamos o WhatsApp nele por R$ 29,90 por número. --- ## EasyCoexistence vs Trengo https://easycoexistence.com/pt/compare/easycoexistence-vs-trengo A Trengo é uma caixa de entrada multicanal de time cobrindo WhatsApp, e-mail, voz e chat, cobrada por usuário. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer ou não um produto para trabalhar dentro dele. ### O que cada produto é Eles não estão disputando a mesma compra, e deixar isso claro é o que torna a comparação realmente útil. - Trengo:: Uma caixa de entrada multicanal de time unificando WhatsApp, e-mail, chat ao vivo, voz e redes sociais numa visão só, cobrada por assento de usuário e mirando times de suporte que cuidam de vários canais. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para o seu time se mudar para dentro. ### Uma caixa de entrada para todos os canais Essa é a promessa central deles, e é uma boa promessa para o time certo. - Trengo:: E-mail, WhatsApp, chat e voz num lugar só, com atribuição compartilhada e regras. Para um time de suporte se afogando em abas, essa consolidação é o produto, e ela funciona. - EasyCoexistence:: Nós fazemos um canal e não pedimos que você consolide nada. Se o seu helpdesk já cuida de e-mail e chat, o WhatsApp chega lá por um webhook e o seu time nunca precisa aprender uma segunda ferramenta. ### O que você paga quando o time cresce Preço por assento tem um formato próprio, e vale enxergar esse formato antes de contratar mais gente. - Trengo:: Por usuário, então cada nova contratação de suporte soma na conta mensal, encoste ela no WhatsApp ou não encoste em nada. - EasyCoexistence:: Por número. Um time de suporte de dois e um time de suporte de vinte pagam exatamente o mesmo, porque a unidade cobrável é a conexão e não a pessoa. ### O que a conta acompanha Essa é a diferença estrutural, e é a que decide o total conforme a sua operação cresce. - Trengo:: Uma assinatura desenhada em torno de usuários e níveis de plano, então a conta acompanha o tamanho do time e os recursos liberados, paga usando os assentos ou não. - EasyCoexistence:: Um número conectado. Somar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são adicionados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar isso de qualquer coisa que guarde as suas conversas dentro dela. - Trengo:: A caixa de entrada, o histórico de contato e as automações moram na plataforma. É isso que faz tudo aquilo funcionar, e é também isso que transforma a saída num projeto de migração. - EasyCoexistence:: Nada que é seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegaram, e o número fica no Portfólio de Negócios do próprio cliente, então nos remover deixa o número exatamente onde ele estava. - Comparar um preço por assento com um preço por número sem contar os dois para o formato da sua própria operação. - Pagar por uma caixa de entrada quando o seu time já trabalha o dia inteiro dentro de um CRM. - Supor que a conexão de WhatsApp é diferente. A Cloud API por baixo é a da Meta nos dois casos. **Qual sai mais barato?** Depende do formato. Um time de cinco numa caixa só pode preferir assentos. Um negócio com números e um sistema já em uso paga bem menos por número conosco. **Eu perco a caixa de entrada compartilhada?** Você nunca se muda para dentro de uma. As mensagens chegam na ferramenta que o seu time já usa, que é onde ele já trabalha todo dia. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como aquilo é cobrado de você. **Também preciso de e-mail e chat. Vocês cobrem?** Não, e não cobramos por eles. Nós conectamos o WhatsApp ao helpdesk que já cuida dos seus outros canais. --- ## EasyCoexistence vs Rasayel https://easycoexistence.com/pt/compare/easycoexistence-vs-rasayel A Rasayel é uma caixa de entrada de vendas com WhatsApp em primeiro lugar e integrações de CRM, cobrada por usuário. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer ou não um produto para trabalhar dentro dele. ### O que cada produto é Eles não estão disputando a mesma compra, e deixar isso claro é o que torna a comparação realmente útil. - Rasayel:: Uma caixa de entrada compartilhada com WhatsApp em primeiro lugar, feita para times de vendas, com integrações de mão dupla em CRMs como HubSpot e Pipedrive, cobrada por assento de usuário. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para o seu time se mudar para dentro. ### Colocar o WhatsApp dentro do CRM Essa é a sobreposição mais próxima entre os dois produtos, e vale ser preciso ao descrevê-la. - Rasayel:: A caixa de entrada deles sincroniza as conversas no CRM, então um vendedor trabalha num lugar ou no outro e o registro acompanha. É um produto de verdade, com engenharia de verdade por trás dele. - EasyCoexistence:: A mensagem vai para o seu CRM direto da Meta, sem nenhuma caixa de entrada no meio para sincronizar. Existe uma cópia da conversa em vez de duas, e não há nada para reconciliar quando uma sincronização falha. ### Pelo que exatamente você está pagando Os dois entregam o WhatsApp dentro de um CRM. A conta é que é calculada de um jeito diferente. - Rasayel:: Assentos, porque a caixa de entrada é o produto e cada vendedor precisa de um assento para conseguir trabalhar dentro dela. - EasyCoexistence:: A conexão. O seu time de vendas inteiro lê o WhatsApp dentro do CRM que ele já paga, e nós cobramos por número, independente de quantos vendedores existirem ali. ### O que a conta acompanha Essa é a diferença estrutural, e é a que decide o total conforme a sua operação cresce. - Rasayel:: Uma assinatura desenhada em torno de usuários e níveis de plano, então a conta acompanha o tamanho do time e os recursos liberados, paga usando os assentos ou não. - EasyCoexistence:: Um número conectado. Somar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são adicionados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar isso de qualquer coisa que guarde as suas conversas dentro dela. - Rasayel:: A caixa de entrada, o histórico de contato e as automações moram na plataforma. É isso que faz tudo aquilo funcionar, e é também isso que transforma a saída num projeto de migração. - EasyCoexistence:: Nada que é seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegaram, e o número fica no Portfólio de Negócios do próprio cliente, então nos remover deixa o número exatamente onde ele estava. - Comparar um preço por assento com um preço por número sem contar os dois para o formato da sua própria operação. - Pagar por uma caixa de entrada quando o seu time já trabalha o dia inteiro dentro de um CRM. - Supor que a conexão de WhatsApp é diferente. A Cloud API por baixo é a da Meta nos dois casos. **Qual sai mais barato?** Depende do formato. Um time de cinco numa caixa só pode preferir assentos. Um negócio com números e um sistema já em uso paga bem menos por número conosco. **Eu perco a caixa de entrada compartilhada?** Você nunca se muda para dentro de uma. As mensagens chegam na ferramenta que o seu time já usa, que é onde ele já trabalha todo dia. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como aquilo é cobrado de você. **Vocês integram com o HubSpot?** Nós entregamos o webhook da Meta em qualquer endpoint, então um CRM com webhook de entrada, ou uma ferramenta de workflow na frente dele, recebe a conversa direto. --- ## EasyCoexistence vs Callbell https://easycoexistence.com/pt/compare/easycoexistence-vs-callbell O Callbell é uma caixa de entrada multiagente de WhatsApp voltada a equipes pequenas, cobrada por usuário. A EasyCoexistence é infraestrutura: conecta um número pelo recurso de Coexistência da própria Meta, entrega as mensagens dele no sistema que você já usa, e cobra por número conectado. Qual sai mais barato depende de você querer um produto para trabalhar dentro. ### O que cada produto é Não estão disputando a mesma compra, e ser claro sobre isso torna a comparação útil. - Callbell:: Uma caixa de entrada multiagente de WhatsApp para equipes pequenas, com fluxos de chatbot e automação básica, cobrada por assento de usuário e popular entre negócios pequenos na América Latina e no sul da Europa. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, e os eventos de mensagem vão da Meta direto para o seu CRM, helpdesk, automação ou agente de IA. Não há produto nenhum para a sua equipe se mudar. ### O caso da equipe pequena Onde o preço deles é mais razoável, e onde a comparação fica mais apertada. - Callbell:: Dois ou três atendentes dividindo um número, com uma caixa de entrada simples e nenhum CRM para integrar. O preço publicado deles é por usuário por mês com o WhatsApp como adicional pago por cima, então até esse formato pequeno carrega uma conta de assento e uma de canal. - EasyCoexistence:: O mesmo negócio, se já tiver um sistema. Uma lojinha rodando pedidos numa planilha ou num backend simples coloca o WhatsApp dentro por menos do que custa um assento, e a equipe continua atendendo pelo app do WhatsApp Business como sempre. ### Várias unidades, uma conta só O caso que separa os dois com clareza. - Callbell:: Cada número e cada atendente fazem parte da assinatura, então uma rede de lojas está comprando assentos e números juntos. - EasyCoexistence:: Cada unidade é uma conexão na tarifa publicada, caindo conforme mais são acrescentadas. Dez lojas com dez números e quarenta funcionários pagam por dez números. ### Para quem o bill acompanha A diferença estrutural, e a que decide o total conforme você cresce. - Callbell:: Uma assinatura moldada em torno de usuários e faixas de plano, então a conta acompanha o tamanho da equipe e os recursos liberados, paga usando ou não os assentos. - EasyCoexistence:: Um número conectado. Acrescentar um colega não custa nada porque não existem assentos, e a tarifa por número cai conforme números são acrescentados, de R$ 29,90 até R$ 4,90. O quadragésimo número de uma agência faz tudo o que o primeiro fazia e custa menos. ### O que acontece se você sair Vale perguntar de qualquer coisa que guarda suas conversas. - Callbell:: A caixa de entrada, o histórico de contatos e as automações moram na plataforma. É isso que faz elas funcionarem, e é também o que torna sair um projeto de migração. - EasyCoexistence:: Nada seu está dentro de nós. As mensagens foram entregues no seu próprio sistema conforme chegavam, e o número fica no Portfólio de Negócios do próprio cliente na Meta, então nos remover deixa ele exatamente onde estava. - Comparar preço por assento com preço por número sem contar os dois para o seu formato. - Pagar por uma caixa de entrada quando sua equipe já trabalha num CRM. - Achar que a conexão de WhatsApp é diferente. A Cloud API por baixo é da Meta nos dois casos. **Qual é mais barato?** Depende do formato. Uma equipe de cinco numa caixa de entrada pode preferir assentos. Um negócio com números e um sistema existente paga muito menos por número com a gente. **Perco uma caixa de entrada compartilhada?** Você nunca se muda para uma. As mensagens chegam na ferramenta que sua equipe já usa, que é onde ela já trabalha. **A conexão de WhatsApp é diferente?** Não. É a Cloud API da Meta dos dois jeitos. O que muda é o que fica na frente dela e como é cobrada. **O Callbell é mais barato para dois atendentes?** Possivelmente, para um número e nenhum sistema existente. Acrescente uma segunda unidade ou um CRM e a cobrança por número passa na frente rápido. --- ## EasyCoexistence vs Baileys https://easycoexistence.com/pt/compare/easycoexistence-vs-baileys O Baileys é uma biblioteca open-source que conecta ao WhatsApp implementando o protocolo de dispositivo vinculado diretamente. Funciona, é gratuita ou barata, e carrega um risco que a rota oficial não tem: os termos comerciais do WhatsApp não preveem mensagens automatizadas por uma sessão de dispositivo vinculado, e um número usado assim pode ser restringido ou banido sem aviso. A EasyCoexistence conecta o mesmo número pelo recurso de Coexistência da própria Meta. ### Como cada um alcança o WhatsApp A comparação inteira está aqui, e todo o resto decorre disso. - Baileys:: Uma biblioteca TypeScript implementando o protocolo de dispositivo vinculado do WhatsApp sobre websocket. Ela entra do jeito que o cliente web entra, lendo um QR code, e depois segura a sessão por conta. Nenhuma aprovação da Meta está envolvida porque a Meta não é consultada. - EasyCoexistence:: A Cloud API da Meta, com credenciais que a Meta emitiu para a conta do WhatsApp Business do próprio cliente, por Coexistência. O número é registrado na Meta como número de API e o app do WhatsApp Business segue funcionando no celular ao mesmo tempo. ### O que acontece quando dá errado Os dois quebram às vezes. O que muda é se existe alguém a quem recorrer. - Baileys:: Um projeto de comunidade no GitHub. Quando o WhatsApp muda o protocolo a biblioteca precisa correr atrás, e sua integração fica fora do ar até lá. Não há contrato de suporte nem apelação de banimento. - EasyCoexistence:: Uma conexão na infraestrutura da própria Meta, monitorada continuamente. Quando ela cai, lemos o motivo de desconexão da própria Meta, então quatorze dias de inatividade se distingue de uma remoção real, e você é avisado antes de um cliente notar. ### Quanto custa, honestamente A rota não oficial costuma parecer gratuita, e a comparação não é realmente sobre a licença. - Baileys:: Gratuita como biblioteca, mais um servidor para rodá-la, uma sessão para manter viva e um engenheiro que a entenda. O custo é manutenção e risco, não licença. - EasyCoexistence:: A partir de R$ 29,90 por número conectado por mês, com hospedagem, monitoramento e o conector MCP inclusos. Não há servidor para rodar, sessão para re-vincular nem nada para reconstruir quando o protocolo muda. ### O que cada um consegue fazer de fato A parte honesta, e a razão de os projetos não oficiais existirem. - Baileys:: Mais que a API oficial em alguns aspectos: grupos, conversas pessoais, presença e confirmações de leitura no nível do protocolo. Esse alcance é a razão de ela existir. - EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, mídia e mensagens interativas, com webhooks entregues pela Meta. Grupos ficam fora da API e respostas livres precisam da janela de 24 horas aberta. Essas são regras da Meta, e valem para todo provedor oficial. ### Quem deve escolher o quê Existe caso real para cada um, e depende inteiramente de quanto o número vale. - Um projeto pessoal num número que você não se importaria de perder: a rota não oficial é gratuita e capaz. - Um número em que um negócio atende clientes: a rota oficial, porque um banimento encerra a linha comercial. - Qualquer coisa com número de cliente: oficial, porque o risco não é seu para correr. - Onde o app do WhatsApp Business precisa continuar funcionando no celular: Coexistência, que é o que fazemos. - Testar uma ponte não oficial no número do negócio. Banimentos chegam sem aviso e sem apelação. - Ler anos de funcionamento como segurança. A aplicação é periódica, não contínua. - Achar que um banimento afeta só a API. Ele leva o perfil do WhatsApp Business junto. **O Baileys funciona mesmo?** Funciona, e é por isso que é popular. A pergunta não é se funciona, é o que acontece com o número quando o WhatsApp notar. **Um número pode ser banido por isso?** Pode. Os termos comerciais do WhatsApp não preveem acesso não oficial, e a aplicação não dá aviso nem apelação. **Meu app do WhatsApp Business para de funcionar com vocês?** Não. É esse o ponto da Coexistência: o app do celular continua funcionando enquanto a Cloud API roda no mesmo número. **O Baileys é ilegal?** Não é crime. É uma rota que os termos comerciais do WhatsApp não preveem, e a consequência é aplicação contra o número, não ação judicial. --- ## EasyCoexistence vs WPPConnect https://easycoexistence.com/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, e carrega um risco que a rota oficial não tem: os termos comerciais do WhatsApp não preveem mensagens automatizadas por uma sessão de dispositivo vinculado, e um número usado assim pode ser restringido ou banido sem aviso. A EasyCoexistence conecta o mesmo número pelo recurso de Coexistência da própria Meta. ### Como cada um alcança o WhatsApp A comparação inteira está aqui, e todo o resto decorre disso. - WPPConnect:: Um projeto de automação de navegador que dirige o WhatsApp Web numa sessão headless, com um invólucro REST por cima. O número é vinculado por QR code e a sessão mora no perfil do navegador, então o WhatsApp vê um dispositivo vinculado e não um cliente de API. - EasyCoexistence:: A Cloud API da Meta, com credenciais que a Meta emitiu para a conta do WhatsApp Business do próprio cliente, por Coexistência. O número é registrado na Meta como número de API e o app do WhatsApp Business segue funcionando no celular ao mesmo tempo. ### O que acontece quando dá errado Os dois quebram às vezes. O que muda é se existe alguém a quem recorrer. - WPPConnect:: Uma comunidade open-source, ativa e atenta, mas sem obrigação com ninguém. Uma mudança no WhatsApp Web pode quebrar o tratamento de sessão, e um banimento não tem caminho de apelação porque o acesso nunca foi autorizado. - EasyCoexistence:: Uma conexão na infraestrutura da própria Meta, monitorada continuamente. Quando ela cai, lemos o motivo de desconexão da própria Meta, então quatorze dias de inatividade se distingue de uma remoção real, e você é avisado antes de um cliente notar. ### Quanto custa, honestamente A rota não oficial costuma parecer gratuita, e a comparação não é realmente sobre a licença. - WPPConnect:: Gratuito, mais um servidor capaz de rodar um navegador continuamente, memória para cada sessão e alguém para reiniciar quando uma sessão morre. Configurações com vários números multiplicam isso. - EasyCoexistence:: A partir de R$ 29,90 por número conectado por mês, com hospedagem, monitoramento e o conector MCP inclusos. Não há servidor para rodar, sessão para re-vincular nem nada para reconstruir quando o protocolo muda. ### O que cada um consegue fazer de fato A parte honesta, e a razão de os projetos não oficiais existirem. - WPPConnect:: O que o WhatsApp Web consegue fazer, incluindo grupos e conversas pessoais, que é genuinamente mais amplo que a API oficial. Também é mais lento e mais pesado, porque há um navegador no caminho. - EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, mídia e mensagens interativas, com webhooks entregues pela Meta. Grupos ficam fora da API e respostas livres precisam da janela de 24 horas aberta. Essas são regras da Meta, e valem para todo provedor oficial. ### Quem deve escolher o quê Existe caso real para cada um, e depende inteiramente de quanto o número vale. - Um projeto pessoal num número que você não se importaria de perder: a rota não oficial é gratuita e capaz. - Um número em que um negócio atende clientes: a rota oficial, porque um banimento encerra a linha comercial. - Qualquer coisa com número de cliente: oficial, porque o risco não é seu para correr. - Onde o app do WhatsApp Business precisa continuar funcionando no celular: Coexistência, que é o que fazemos. - Testar uma ponte não oficial no número do negócio. Banimentos chegam sem aviso e sem apelação. - Ler anos de funcionamento como segurança. A aplicação é periódica, não contínua. - Achar que um banimento afeta só a API. Ele leva o perfil do WhatsApp Business junto. **O WPPConnect funciona mesmo?** Funciona, e é por isso que é popular. A pergunta não é se funciona, é o que acontece com o número quando o WhatsApp notar. **Um número pode ser banido por isso?** Pode. Os termos comerciais do WhatsApp não preveem acesso não oficial, e a aplicação não dá aviso nem apelação. **Meu app do WhatsApp Business para de funcionar com vocês?** Não. É esse o ponto da Coexistência: o app do celular continua funcionando enquanto a Cloud API roda no mesmo número. **Por que ele é popular no Brasil?** Chegou cedo, a documentação é em português e é gratuito, o que o tornou o padrão para uma geração de integrações locais. --- ## EasyCoexistence vs Evolution API https://easycoexistence.com/pt/compare/easycoexistence-vs-evolution-api A Evolution API é uma API REST open-source que embrulha bibliotecas não oficiais do WhatsApp atrás de uma interface limpa. Funciona, é gratuita ou barata, e carrega um risco que a rota oficial não tem: os termos comerciais do WhatsApp não preveem mensagens automatizadas por uma sessão de dispositivo vinculado, e um número usado assim pode ser restringido ou banido sem aviso. A EasyCoexistence conecta o mesmo número pelo recurso de Coexistência da própria Meta. ### Como cada um alcança o WhatsApp A comparação inteira está aqui, e todo o resto decorre disso. - Evolution API:: Uma API REST auto-hospedada com gerenciador, que embrulha bibliotecas de dispositivo vinculado atrás de uma interface limpa, com painel, suporte a múltiplas instâncias e webhooks. A experiência de desenvolvimento é boa, e por baixo cada instância continua sendo um dispositivo vinculado por QR. - EasyCoexistence:: A Cloud API da Meta, com credenciais que a Meta emitiu para a conta do WhatsApp Business do próprio cliente, por Coexistência. O número é registrado na Meta como número de API e o app do WhatsApp Business segue funcionando no celular ao mesmo tempo. ### O que acontece quando dá errado Os dois quebram às vezes. O que muda é se existe alguém a quem recorrer. - Evolution API:: Um projeto open-source ativo com comunidade grande. A interface é estável, mas o que ela embrulha não é autorizado, então um número banido por acesso não oficial se foi, por melhor que o invólucro seja construído. - EasyCoexistence:: Uma conexão na infraestrutura da própria Meta, monitorada continuamente. Quando ela cai, lemos o motivo de desconexão da própria Meta, então quatorze dias de inatividade se distingue de uma remoção real, e você é avisado antes de um cliente notar. ### Quanto custa, honestamente A rota não oficial costuma parecer gratuita, e a comparação não é realmente sobre a licença. - Evolution API:: Gratuita de licença, auto-hospedada, então o custo real é a infraestrutura e a pessoa que mantém. O acabamento torna barato começar e não muda o que está por baixo. - EasyCoexistence:: A partir de R$ 29,90 por número conectado por mês, com hospedagem, monitoramento e o conector MCP inclusos. Não há servidor para rodar, sessão para re-vincular nem nada para reconstruir quando o protocolo muda. ### O que cada um consegue fazer de fato A parte honesta, e a razão de os projetos não oficiais existirem. - Evolution API:: Enviar e receber, mídia, grupos, várias instâncias de uma implantação só, com webhooks e um painel utilizável. Para um desenvolvedor é a opção não oficial mais agradável disponível. - EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, mídia e mensagens interativas, com webhooks entregues pela Meta. Grupos ficam fora da API e respostas livres precisam da janela de 24 horas aberta. Essas são regras da Meta, e valem para todo provedor oficial. ### Quem deve escolher o quê Existe caso real para cada um, e depende inteiramente de quanto o número vale. - Um projeto pessoal num número que você não se importaria de perder: a rota não oficial é gratuita e capaz. - Um número em que um negócio atende clientes: a rota oficial, porque um banimento encerra a linha comercial. - Qualquer coisa com número de cliente: oficial, porque o risco não é seu para correr. - Onde o app do WhatsApp Business precisa continuar funcionando no celular: Coexistência, que é o que fazemos. - Testar uma ponte não oficial no número do negócio. Banimentos chegam sem aviso e sem apelação. - Ler anos de funcionamento como segurança. A aplicação é periódica, não contínua. - Achar que um banimento afeta só a API. Ele leva o perfil do WhatsApp Business junto. **A Evolution API funciona mesmo?** Funciona, e é por isso que é popular. A pergunta não é se funciona, é o que acontece com o número quando o WhatsApp notar. **Um número pode ser banido por isso?** Pode. Os termos comerciais do WhatsApp não preveem acesso não oficial, e a aplicação não dá aviso nem apelação. **Meu app do WhatsApp Business para de funcionar com vocês?** Não. É esse o ponto da Coexistência: o app do celular continua funcionando enquanto a Cloud API roda no mesmo número. **Parece profissional. É mais seguro?** Não. A interface é melhor que a da maioria; o que ela embrulha é o mesmo acesso de dispositivo vinculado, e a aplicação age sobre o número, não sobre o invólucro. --- ## EasyCoexistence vs Whapi https://easycoexistence.com/pt/compare/easycoexistence-vs-whapi O Whapi é um serviço hospedado que vende acesso ao WhatsApp por um gateway não oficial. Funciona, é gratuito ou barato, e carrega um risco que a rota oficial não tem: um número alcançado assim está em violação dos termos do WhatsApp e pode ser banido sem aviso. A EasyCoexistence conecta o mesmo número pelo recurso de Coexistência da própria Meta. ### Como cada um alcança o WhatsApp A comparação inteira está aqui, e todo o resto decorre disso. - Whapi:: Um gateway hospedado com API REST e plano pago. A conveniência é real: sem servidor para rodar e sem biblioteca para manter. Por baixo, o número continua vinculado como dispositivo em vez de registrado na Meta como número de API. - EasyCoexistence:: A Cloud API da Meta, com credenciais que a Meta emitiu para a conta do WhatsApp Business do próprio cliente, por Coexistência. O número é registrado na Meta como número de API e o app do WhatsApp Business segue funcionando no celular ao mesmo tempo. ### O que acontece quando dá errado Os dois quebram às vezes. O que muda é se existe alguém a quem recorrer. - Whapi:: Um provedor comercial com suporte, que é mais do que uma biblioteca open-source oferece. O que o suporte não consegue é reverter um banimento, porque o acesso nunca foi autorizado pela Meta e não existe apelação para isso. - EasyCoexistence:: Uma conexão na infraestrutura da própria Meta, monitorada continuamente. Quando ela cai, lemos o motivo de desconexão da própria Meta, então quatorze dias de inatividade se distingue de uma remoção real, e você é avisado antes de um cliente notar. ### Quanto custa, honestamente A rota não oficial costuma parecer gratuita, e a comparação não é realmente sobre a licença. - Whapi:: Uma mensalidade, então não é a opção barata que a rota open-source é. Você paga por conveniência enquanto mantém o risco que as ferramentas gratuitas carregam. - EasyCoexistence:: A partir de R$ 29,90 por número conectado por mês, com hospedagem, monitoramento e o conector MCP inclusos. Não há servidor para rodar, sessão para re-vincular nem nada para reconstruir quando o protocolo muda. ### O que cada um consegue fazer de fato A parte honesta, e a razão de os projetos não oficiais existirem. - Whapi:: Enviar e receber, mídia, grupos e conversas pessoais, por uma API REST arrumada e sem infraestrutura para rodar. Recurso a recurso é mais amplo que a API oficial. - EasyCoexistence:: Tudo o que a Cloud API permite: enviar e receber mensagens, templates, mídia e mensagens interativas, com webhooks entregues pela Meta. Grupos ficam fora da API e respostas livres precisam da janela de 24 horas aberta. Essas são regras da Meta, e valem para todo provedor oficial. ### Quem deve escolher o quê Existe caso real para cada um, e depende inteiramente de quanto o número vale. - Um projeto pessoal num número que você não se importaria de perder: a rota não oficial é gratuita e capaz. - Um número em que um negócio atende clientes: a rota oficial, porque um banimento encerra a linha comercial. - Qualquer coisa com número de cliente: oficial, porque o risco não é seu para correr. - Onde o app do WhatsApp Business precisa continuar funcionando no celular: Coexistência, que é o que fazemos. - Testar uma ponte não oficial no número do negócio. Banimentos chegam sem aviso e sem apelação. - Ler anos de funcionamento como segurança. A aplicação é periódica, não contínua. - Achar que um banimento afeta só a API. Ele leva o perfil do WhatsApp Business junto. **O Whapi funciona mesmo?** Funciona, e é por isso que é popular. A pergunta não é se funciona, é o que acontece com o número quando o WhatsApp notar. **Um número pode ser banido por isso?** Pode. Acesso não oficial viola os termos comerciais do WhatsApp, e a aplicação não dá aviso nem apelação. **Meu app do WhatsApp Business para de funcionar com vocês?** Não. É esse o ponto da Coexistência: o app do celular continua funcionando enquanto a Cloud API roda no mesmo número. **É pago, então é aprovado pela Meta?** Não. Pagar a um terceiro não torna o acesso autorizado. A aprovação vem da Meta emitir credenciais para o número, que é o que a Coexistência faz. --- ## Os melhores provedores de Coexistência do WhatsApp https://easycoexistence.com/pt/compare/best-whatsapp-coexistence-providers Uma lista curta, porque a Coexistência é mais nova que a indústria de API de WhatsApp e a maioria dos provedores ainda não suporta. Estes são os que suportam, com quanto cada um cobra e o tipo de negócio para o qual cada um foi construído. ### 1. EasyCoexistence, para um negócio ou agência que quer a conexão e nada mais Estamos em primeiro na nossa própria lista, então leia o resto e confira as fontes. O argumento é estreito e verificável: o menor preço de entrada publicado aqui, um modelo por número sem assentos e sem faixas de plano, eventos de mensagem entregues da Meta direto no seu próprio sistema em vez de numa outra caixa de entrada, monitoramento contínuo que lê o motivo de desconexão da própria Meta, e um conector MCP para um assistente de IA tocar a coisa inteira. - A partir de R$ 29,90 por número conectado por mês, caindo até R$ 4,90 conforme você adiciona números. - Sem assentos, sem contrato, sem taxa de instalação, três dias grátis. - Zero margem: a Meta cobra as conversas do cliente diretamente. - Dezesseis ferramentas MCP por OAuth para Claude, ChatGPT, Cursor e Claude Code. ### 2. YCloud, para um time que quer uma plataforma em volta A alternativa mais próxima em posicionamento: eles suportam Coexistência abertamente e se comprometem com zero margem nas mensagens de WhatsApp, que são as duas coisas que mais importam. A diferença é a conta. Os planos pagos deles começam em US$ 39 por mês, estruturados por assento de usuário, canais e créditos de IA, antes de um único número ser contado. O nosso começa em US$ 9 (R$ 29,90) por número conectado sem assentos e sem créditos, então um negócio com um a três números paga uma fração, e uma agência com quarenta paga uma tarifa que cai para US$ 5 (R$ 19,90). ### 3. SleekFlow, para um time que vive numa caixa de entrada compartilhada Eles listam Coexistência entre as soluções e o produto é uma caixa de entrada omnicanal com campanhas e automações, cobrada por assento de usuário com quantidade mínima de assentos e um adicional para números extras de WhatsApp. Esse formato serve a um time de vendas ou suporte que quer todo mundo trabalhando num lugar só. Serve mal a um negócio com várias unidades, porque assentos e adicionais por número escalam os dois contra você. ### 4. 8x8, para uma empresa que já compra comunicação A documentação de Coexistência deles é a mais clara de qualquer provedor e vale a leitura seja qual for a sua escolha, inclusive a nossa. O produto é CPaaS corporativo vendido junto com contact center e voz, por times de conta e acordos comerciais, que é o encaixe certo se você já está consolidando gasto de comunicação. Para um número e um webhook é um caminho pesado para chegar lá. ### 5. Dualhook, um especialista direto A mesma arquitetura que usamos: Coexistência com roteamento de webhook direto da Meta, sem armazenar mensagem, a preço publicado. O valor publicado deles é US$ 12 por número contra os nossos US$ 9 (R$ 29,90), eles avisam aos treze dias que o relógio está correndo em vez de ler o motivo de desconexão da própria Meta, e a documentação deles não descreve um conector MCP. ### O que perguntar a qualquer um deles antes de assinar Quatro perguntas que separam os provedores desta lista, e que uma página de vendas não responde sozinha. - O número fica no meu próprio Portfólio de Negócios da Meta, e a Meta me cobra diretamente? - Vocês acrescentam algo por mensagem, e isso vem discriminado separado da taxa da Meta? - Vocês reaplicam o override de webhook depois de uma reconexão, ou a entrega para em silêncio? - O que vocês fazem quanto à regra de quatorze dias de inatividade, e vocês leem o motivo de desconexão da Meta? - Escolher por quantidade de recursos. Coexistência é mecanismo da Meta, então a plataforma por baixo é idêntica em todo lugar. - Achar que um provedor suporta Coexistência porque suporta WhatsApp. A maioria ainda não suporta. - Comparar preço por assento com preço por número sem contar os dois para o seu formato. **Por que vocês estão em primeiro na própria lista?** Porque achamos que o argumento se sustenta: o menor preço de entrada publicado aqui, sem assentos, zero margem e monitoramento incluso. Todo valor tem fonte, então confira. **Quais provedores suportam Coexistência?** Muito menos do que os que suportam WhatsApp em geral. Os desta lista declaram isso nos próprios sites; a maior parte da indústria de API de WhatsApp ainda não oferece. **O provedor muda o que a Coexistência consegue fazer?** Não. O recurso é da Meta, então os limites são idênticos em todo lugar: os mesmos quatro recursos desligados, a mesma regra de quatorze dias, nada de grupos. **Qual é a opção mais barata?** A nossa, no preço de entrada publicado, e a diferença aumenta com os números porque a nossa tarifa por número cai enquanto preço por assento e por plano não cai. --- ## Os melhores provedores da Cloud API do WhatsApp https://easycoexistence.com/pt/compare/best-whatsapp-cloud-api-providers Todo provedor aqui conecta a mesma Cloud API, porque ela é da Meta e existe só uma. O que muda é como cobram, e isso os divide em três grupos com clareza: uma taxa por mensagem, uma taxa por assento, ou uma taxa por número conectado. ### Os três modelos de preço, que é a escolha real Listas de recursos se confundem umas com as outras porque a API por baixo é idêntica. Como a conta é calculada não se confunde, e decide quanto você paga conforme o negócio cresce. - Por mensagem: uma taxa em cada mensagem, então o custo sobe exatamente conforme o negócio dá certo. - Por assento: uma taxa por usuário, então o custo sobe conforme a equipe cresce e é paga entrando ele ou não. - Por número: uma taxa por conexão, que para de se mexer assim que o número conecta. ### Provedores que cobram por mensagem O grupo CPaaS. A Twilio publica US$ 0,005 por mensagem entrando e saindo em cima das taxas da Meta. A Gupshup publica um padrão de US$ 0,001 por mensagem. A Bird cota um valor combinado com a taxa da Meta já dentro, então a margem é real e não pode ser conferida contra a tabela publicada da Meta. A Infobip cota por país de destino, via vendas. Os quatro são plataformas capazes, e os quatro tornam sua conta de plataforma uma função do seu volume de mensagem. ### Provedores que cobram por assento O grupo caixa de entrada. SleekFlow, Wati e Respond.io vendem uma caixa de entrada compartilhada com campanhas e automação, cobrada por usuário com faixas de plano e, em vários casos, um adicional por número de WhatsApp. Essa é a compra certa se você quer sua equipe trabalhando dentro de um produto o dia inteiro. É a errada se sua equipe já tem um CRM, porque você paga pela segunda caixa de entrada independente de alguém abrir. ### Provedores que cobram por número O grupo infraestrutura, e o menor. A EasyCoexistence cobra a partir de R$ 29,90 por número conectado por mês, caindo até R$ 4,90 conforme você adiciona números, sem nada por mensagem e sem assentos. A Dualhook é o outro especialista com preço publicado por número, a US$ 12. O modelo serve a um negócio que já tem um sistema e quer o WhatsApp chegando nele, e a uma agência com muitos números de cliente, onde uma tarifa por número que cai se acumula a favor. ### Onde os modelos se cruzam Vale calcular em vez de supor, e a aritmética é curta. - A US$ 0,005 por mensagem, uma taxa por número de R$ 29,90 sai mais barata acima de umas 1.800 mensagens por mês. - A US$ 0,001 por mensagem, o cruzamento fica em torno de 9.000 mensagens por mês. - Um modelo por assento cruza por quantidade de gente, não por volume, então conte assentos contra números. - As taxas de conversa da própria Meta são iguais em todo modelo e não são o que está sendo comparado. ### O que nenhum deles muda Vale saber antes que uma comparação de recursos te convença de alguma coisa. - A Cloud API é da Meta, então confiabilidade e capacidade são da plataforma, não do provedor. - Aprovação de template é decisão da Meta, e nenhum provedor acelera. - Classificação de qualidade e nível de mensageria são definidos pela Meta a partir do comportamento de quem recebe. - Coexistência, onde é suportada, tem limites idênticos em todo lugar porque o recurso é da Meta. - Comparar recursos de vitrine. A API por baixo é a mesma da Meta em todos os casos. - Ignorar o volume de cruzamento. Um décimo de centavo não é nada até você multiplicar por um ano. - Achar que um valor combinado por mensagem não tem margem. Significa que a margem não está discriminada. **A Cloud API de um provedor é mais rápida que a de outro?** Não. É a API da Meta em todos os casos. Um provedor só consegue mudar o que fica na frente dela e quanto cobra. **Qual modelo é o mais barato?** Por número, acima de volume modesto. Ao valor publicado da Twilio o cruzamento fica em torno de 1.800 mensagens por mês; ao da Gupshup, em torno de 9.000. **Eu preciso de um provedor?** Para alcançar a Cloud API num número que já roda o app do WhatsApp Business, sim: o onboarding de Coexistência exige um Meta Tech Provider. **Quem me cobra pelas mensagens?** A Meta, se o seu provedor não revender. Com a gente a Meta fatura você direto e nunca marcamos nada. --- ## Os melhores servidores MCP de WhatsApp https://easycoexistence.com/pt/compare/best-whatsapp-mcp-servers Procure um servidor MCP de WhatsApp e a maioria dos resultados são projetos open-source que entram no WhatsApp como dispositivo vinculado. Eles funcionam, e colocam o número em risco. A distinção que importa não é feature, é se o servidor fala com a API oficial da Meta. ### A divisão que importa Todo servidor MCP de WhatsApp cai de um lado de uma linha só, e a linha não é sobre ferramenta. - Oficial: o servidor chama a Cloud API da Meta com credenciais que a Meta emitiu. Autorizado, e o número está seguro. - Não oficial: o servidor dirige uma biblioteca que entra como dispositivo vinculado, do mesmo jeito que o cliente web. - A rota não oficial não precisa de aprovação da Meta, e é por isso que é comum em projetos open-source. - Ela também é contra os termos do WhatsApp, e números são banidos por isso sem apelação e sem aviso. ### Os projetos open-source que você vai encontrar A maioria dos servidores MCP de WhatsApp no GitHub é construída sobre bibliotecas como Baileys, WPPConnect ou Venom, que fazem engenharia reversa do protocolo de dispositivo vinculado. São genuinamente inteligentes, gratuitos, e dão a um assistente acesso a conversas pessoais e grupos que a API oficial não expõe. O custo é a conta: um número banido assim leva o perfil do WhatsApp Business junto, e não há canal de suporte para argumentar. Para um número pessoal que alguém aceita perder, essa troca pode fazer sentido. Para o número em que um negócio atende clientes, não faz. ### O que rodar um deles envolve de fato A diferença prática, além do risco, e a que as pessoas encontram no segundo dia. - Um processo de servidor local, normalmente num notebook, que precisa ficar rodando para o assistente funcionar. - Uma leitura de QR para vincular o dispositivo, repetida toda vez que a sessão cai. - Credenciais num arquivo de configuração local, que é onde um token de API passa a morar. - Nenhuma conexão entre o seu assistente e o número quando o notebook dorme. ### EasyCoexistence, a rota oficial Um servidor MCP remoto por OAuth, então não há nada para instalar e nenhum token em arquivo de configuração. Dezesseis ferramentas cobrem o que as pessoas de fato pedem a um assistente: listar números, checar a saúde de um número, ler credenciais de API, enviar mensagem, listar, criar e enviar templates, consultar status de template, apontar o webhook para o seu sistema, buscar na documentação e iniciar uma nova conexão. Outras cinco configuram a Partner API: status da configuração, chave de API, URL de eventos e links de conexão hospedados. Roda com o seu notebook aberto ou não, porque é hospedado, e o número por baixo está na Cloud API oficial da Meta por Coexistência, então o app do WhatsApp Business continua funcionando e nada fica em risco. ### O que a rota oficial não consegue fazer Dito com todas as letras, porque é a razão de os projetos não oficiais existirem e você deve saber antes de escolher. - Grupos estão fora da Cloud API por completo, em todo provedor oficial. - Conversas pessoais de uma conta comum do WhatsApp não são alcançáveis. - Respostas livres só funcionam dentro da janela de atendimento de 24 horas; fora dela, um template aprovado abre a conversa. - Essas são regras da Meta e não nossas, e nenhum provedor oficial consegue levantá-las. - Julgar um servidor MCP pela quantidade de ferramentas. A pergunta é se ele fala com a API da Meta ou finge ser um celular. - Testar uma ponte não oficial no número do negócio. Banimentos chegam sem aviso e sem apelação. - Achar que um servidor local é privado. Um token num arquivo de configuração no notebook é o arranjo mais frágil. **Os servidores MCP de WhatsApp open-source são seguros?** Eles funcionam, e entram como dispositivo vinculado, o que é contra os termos do WhatsApp. Números são banidos por isso sem aviso. **Um servidor MCP oficial consegue ler meus grupos?** Não. Grupos estão fora da Cloud API da Meta em todo provedor oficial, inclusive o nosso. **Preciso instalar alguma coisa?** Não. O nosso é um servidor remoto por OAuth, então você adiciona um endpoint e faz login. Nada roda na sua máquina. **Quais assistentes conseguem usar?** Qualquer cliente MCP. Claude, ChatGPT, Cursor e Claude Code são os que documentamos. --- ## EasyCoexistence vs Twilio https://easycoexistence.com/pt/compare/easycoexistence-vs-twilio A Twilio é uma plataforma de comunicação genérica que revende WhatsApp entre vários canais, com uma taxa publicada por mensagem em cima da da Meta. A EasyCoexistence faz uma coisa: conecta um número do app do WhatsApp Business por Coexistência e cobra um valor fixo por número. ### Para que serve cada um Os produtos miram problemas diferentes, e essa é a primeira coisa que vale deixar clara. - Twilio:: Uma plataforma de comunicação cobrindo SMS, voz, e-mail e WhatsApp, feita para times de engenharia montando mensageria em vários canais. WhatsApp é um canal entre muitos, cobrado do mesmo jeito que o resto: por mensagem. - EasyCoexistence:: Uma especialista em Coexistência. O app do WhatsApp Business no celular continua funcionando, a Cloud API roda no mesmo número, os eventos de mensagem vão para o seu próprio endpoint, e nós vigiamos a conexão. Um trabalho, feito por inteiro. ### O que o preço faz conforme você cresce Esta é a diferença que se acumula, e é aritmética, não opinião. - Twilio:: US$ 0,005 por mensagem, entrando e saindo, em cima do que a Meta cobrar. A taxa escala com cada conversa, então o custo da plataforma é função de quão bem o negócio está indo. - EasyCoexistence:: Um valor fixo por número conectado. Dez mil mensagens no mês custam o mesmo que dez. O sucesso torna a plataforma mais barata por mensagem, não mais cara, e em volume o preço por número também cai. ### Quem detém a conta do WhatsApp Onde o número e a relação com a Meta moram decide com que facilidade cada lado consegue sair. - Twilio:: Os números entram pelos senders da Twilio, e a relação de mensageria roda pela infraestrutura da Twilio, que é também onde fica a relação de cobrança. - EasyCoexistence:: O número fica no Portfólio de Negócios do próprio cliente, na conta do WhatsApp Business dele, com a Meta faturando as conversas direto para ele. Nós somos o Tech Provider que conectou, e nos remover não leva o número junto. ### Para onde vão as mensagens Os dois entregam mensagens recebidas num servidor que você controla. O que muda é o caminho e o que fica em cima dele. - Twilio:: As mensagens recebidas chegam no seu webhook passando pela Twilio, que processa e cobra cada uma no caminho. - EasyCoexistence:: Nós definimos o override_callback_uri da própria Meta na conta do WhatsApp Business, então os eventos de mensagem vão da Meta direto para o seu endpoint. Eles não passam por nós, não armazenamos, e não há nada no caminho para medir. ### Acessar a partir de um assistente de IA A pergunta mais nova, e a que uma plataforma genérica tem menos motivo para responder. - Twilio:: Uma API REST completa com SDKs nas principais linguagens, medida nos US$ 0,005 por mensagem publicados por eles, então a integração que você escreve é cobrada toda vez que envia ou recebe. - EasyCoexistence:: A mesma API por baixo, mais um conector MCP remoto com dezesseis ferramentas por OAuth, então Claude, ChatGPT, Cursor e Claude Code listam números, checam saúde, enviam mensagens e definem destinos de webhook sem ninguém escrever um cliente. - Comparar só a taxa de vitrine. Uma cobrança por mensagem e uma por número se cruzam num volume que vale calcular antes. - Achar que plataforma grande significa conexão de WhatsApp melhor. A Cloud API por baixo é da própria Meta nos dois casos. - Ignorar quem a Meta fatura. Um provedor entre você e a fatura da Meta é um provedor que consegue colocar margem nela. **A Twilio é mais barata em volume baixo?** Abaixo de umas duas mil mensagens por mês a taxa por mensagem é pequena. Acima disso, um valor fixo por número ganha e continua ganhando conforme o volume cresce. **A Twilio faz Coexistência?** A página de preços de WhatsApp deles não trata disso. Coexistência é para o que fomos construídos, então o app do WhatsApp Business continua funcionando no mesmo número. **A API é diferente?** Não. A Cloud API por baixo é da própria Meta nos dois casos. O que muda é quem fica no caminho, quanto cobra e quem a Meta fatura. **Posso mover um número depois?** Com a gente, pode: o número fica no seu próprio Portfólio de Negócios, então nos remover deixa ele exatamente onde estava. --- ## EasyCoexistence vs Gupshup https://easycoexistence.com/pt/compare/easycoexistence-vs-gupshup A Gupshup é uma plataforma de mensageria conversacional que cobra uma taxa publicada por mensagem em cima dos custos de conversa da Meta. A EasyCoexistence cobra um valor fixo mensal por número conectado e não acrescenta nada à conta de mensagem, que é a diferença que se acumula com o volume. ### O formato da conta Um décimo de centavo parece nada, e em escala é a conversa inteira. - Gupshup:: Uma taxa padrão de US$ 0,001 por mensagem em cima da da Meta, aplicada tanto a mensagens de template quanto de sessão. A cem mil mensagens por mês isso dá cem dólares de taxa de plataforma antes dos custos da Meta. - EasyCoexistence:: Nada por mensagem. Cem mil mensagens custam o que dez custam, porque a taxa segue o número e não o tráfego. Quanto mais movimentado o número, menos a nossa taxa pesa por conversa. ### Em torno do que o produto é construído Os dois conectam WhatsApp. Eles estão organizados em torno de trabalhos diferentes. - Gupshup:: Uma plataforma conversacional com construção de bots, ferramental de campanha e uma lista ampla de canais, mirando empresas que rodam programas de saída em escala. - EasyCoexistence:: Infraestrutura de Coexistência. O app do WhatsApp Business continua funcionando no celular, a Cloud API roda no mesmo número, e os eventos de mensagem chegam a qualquer sistema ou agente de IA que você já usa. Não pedimos que você mude seu time de lugar nenhum. ### Onde moram os dados da conversa A pergunta que decide quanto do seu negócio roda dentro do produto de outra pessoa. - Gupshup:: As mensagens correm pela plataforma, que é o que torna possíveis o construtor de bots, as ferramentas de campanha e a analítica. Essa é uma troca razoável se você quer essas coisas. - EasyCoexistence:: Os eventos de mensagem vão da Meta direto para o seu endpoint pelo override de webhook da própria Meta. Nunca vemos o conteúdo das conversas, o que significa que não há nada de seu para extrair se você sair e nada no caminho para medir. ### Conectar um número que já tem o app O problema específico para o qual a Coexistência existe. - Gupshup:: A página de preços publicada deles não trata de Coexistência. Isso não é prova de que não suportem, e é a pergunta certa a fazer diretamente a eles. - EasyCoexistence:: Este é o produto inteiro. Um número que já roda o app do WhatsApp Business conecta pelo Embedded Signup da própria Meta, mantém o app funcionando, e ganha a Cloud API no mesmo número em minutos. - Ler US$ 0,001 como desprezível. Multiplique por um ano de volume real antes de decidir. - Pagar por ferramental de campanha que você não vai usar. Uma taxa de plataforma cobre o produto inteiro, usado ou não. - Supor que qualquer provedor suporta Coexistência. Pergunte especificamente, seja quem for que você escolher. **Quanto custa de fato a taxa por mensagem?** A cem mil mensagens por mês, os US$ 0,001 publicados pela Gupshup dão US$ 100 de taxa de plataforma. A nossa taxa para um número é R$ 29,90 em qualquer volume. **A Gupshup suporta Coexistência?** A página de preços deles não menciona isso. Coexistência é a totalidade daquilo que nós fazemos. **Eu perco recursos de campanha com vocês?** Não somos uma ferramenta de campanha e não cobramos como uma. As mensagens chegam ao seu próprio sistema, então as campanhas rodam onde você já as roda. **Quem paga a Meta?** O cliente paga, diretamente, na conta do WhatsApp Business dele. Nunca colocamos margem numa cobrança da Meta. --- ## EasyCoexistence vs Infobip https://easycoexistence.com/pt/compare/easycoexistence-vs-infobip A Infobip é uma plataforma de comunicação corporativa cujo preço de WhatsApp é cotado por país e combinado através de vendas. A EasyCoexistence publica o seu preço, começa com três dias grátis e conecta um número sem nenhuma conversa, o que é um produto diferente para um comprador diferente. ### Para quem cada produto é construído Nenhum dos dois é um produto pior. Eles são vendidos para pessoas diferentes, e isso decide quase todo o resto. - Infobip:: CPaaS corporativo, com roteamento omnicanal, ferramental de central de atendimento e relações globais com operadoras, vendido por times de conta a organizações com processos de compras e compromissos de volume. - EasyCoexistence:: Um pequeno negócio ou agência que já tem um número do WhatsApp Business e quer ele na Cloud API esta tarde. Cadastre, conecte, pronto. Não há com quem falar porque não há nada a negociar. ### O que dá para descobrir antes de se comprometer A diferença mais prática, e a que as pessoas sentem primeiro. - Infobip:: As tarifas são cotadas por país de destino e combinadas com vendas, o que é normal em CPaaS corporativo e serve a compradores negociando volume anual. - EasyCoexistence:: A lista de preços inteira está na página de preços, na sua moeda, com as faixas de volume visíveis. Você consegue calcular a sua conta antes de criar uma conta, e os primeiros três dias não custam nada. ### Tempo da decisão até um número funcionando Para um negócio com um número e um problema real, esta é a comparação que importa. - Infobip:: Uma implantação corporativa, que traz suporte dedicado e ajuda de configuração de que as grandes implantações genuinamente precisam. - EasyCoexistence:: Minutos. O Embedded Signup da própria Meta escolhe o portfólio, a conta e o número, o app do WhatsApp Business continua funcionando o tempo todo, e o monitoramento começa imediatamente. ### O que acontece quando a conexão quebra Toda conexão de Coexistência acaba tendo um dia ruim. O que muda é quem percebe. - Infobip:: Canais de suporte corporativo e um time de conta, que é o modelo certo quando há um contrato e um contato nomeado por trás dele. - EasyCoexistence:: Nós vigiamos a conexão continuamente e lemos o motivo de desconexão da própria Meta, então um número derrubado por catorze dias de inatividade é distinguível de um cliente que de fato saiu. O alerta chega antes de o cliente perceber. - Comparar um CPaaS corporativo com uma ferramenta por número só pelos recursos. Eles respondem perguntas diferentes. - Começar um ciclo de compras por causa de um número. Custa mais em tempo do que a ferramenta custa num ano. - Supor que uma cotação vai ganhar de um preço publicado em volume pequeno. Raramente ganha. **Por que a Infobip não publica um preço fixo?** O preço deles é cotado por país de destino, o que serve a compradores corporativos negociando volume. O nosso é publicado porque o nosso comprador quer decidir hoje. **A Infobip é melhor para uma grande empresa?** Eles são construídos para esse comprador, com alcance global de operadoras e times de conta. Para um negócio conectando os próprios números, nós somos o caminho mais rápido e mais barato. **Preciso falar com alguém para começar?** Não. Três dias grátis no primeiro número conectado, e o número conecta pelo Embedded Signup da própria Meta. **Quem me cobra pelas mensagens?** A Meta cobra, diretamente, na sua própria conta do WhatsApp Business. Nós nunca ficamos em cima dessa fatura. --- ## EasyCoexistence vs YCloud https://easycoexistence.com/pt/compare/easycoexistence-vs-ycloud A YCloud suporta Coexistência e, como nós, não acrescenta margem às tarifas de mensagem da Meta. A diferença é o que você está comprando: os planos pagos deles são assinaturas de plataforma com assentos, canais e créditos de IA, enquanto o nosso é infraestrutura cobrada por número conectado. ### No que os dois acertam Vale dizer com todas as letras, porque estreita a comparação para aquilo que de fato difere. - YCloud:: Coexistência é suportada e declarada abertamente, e a página de preços deles se compromete com zero margem nas mensagens de WhatsApp. Nas duas coisas que mais importam num provedor, eles estão do lado certo das duas. - EasyCoexistence:: Os mesmos dois compromissos. Coexistência pelo fluxo da própria Meta, e nada acrescentado a uma mensagem da Meta. Onde nós diferimos é em tudo o que fica em volta disso. ### O que a assinatura de fato compra Esta é a bifurcação de verdade, e é ela que decide qual dos dois é mais barato para você. - YCloud:: Uma plataforma. Os planos pagos deles começam em US$ 39 por mês e são diferenciados por assentos de usuário, canais e créditos de IA, que é o formato certo se você quer um time trabalhando dentro do produto deles. - EasyCoexistence:: Infraestrutura. A partir de R$ 29,90 por número conectado, sem assentos para contar, sem faixas de canal e sem créditos para acabar. Um negócio com um número paga por um número, e uma agência com quarenta paga uma tarifa que cai por número. ### Onde as conversas param Os dois conectam a mesma Cloud API. O que acontece com as mensagens depois é a decisão de projeto. - YCloud:: A plataforma deles, onde moram a caixa de entrada, as campanhas e os créditos de IA, a partir de US$ 39 por mês antes de qualquer número ser contado. O seu time trabalha ali porque é ali que as mensagens estão. - EasyCoexistence:: O seu sistema. Nós definimos o override de webhook da própria Meta para que os eventos de mensagem vão da Meta direto para o seu endpoint, ou para o seu agente de IA por MCP. Nada para migrar para dentro, nada para migrar para fora, e nenhuma segunda caixa de entrada para o seu time conferir. ### O que uma agência paga conforme cresce O caso em que os dois modelos divergem com mais força. - YCloud:: Faixas de plano com contagem de assentos, então crescer é uma série de decisões de upgrade conforme mais gente e mais canais são adicionados. - EasyCoexistence:: Uma tarifa por número que cai conforme números são adicionados, de R$ 29,90 até R$ 4,90. Não existe conversa de upgrade porque não há para o que fazer upgrade: o quadragésimo número faz tudo o que o primeiro fazia, por menos. ### Acessar a partir de um assistente de IA A parte que as faixas de plano de nenhuma das plataformas descrevem, e a que está virando a pergunta. - YCloud:: Créditos de IA fazem parte da estrutura de planos deles, o que aponta para recursos de IA construídos dentro do produto deles. - EasyCoexistence:: Um conector MCP remoto com dezesseis ferramentas por OAuth. Claude, ChatGPT, Cursor e Claude Code conseguem listar números, checar a saúde da conexão, enviar mensagens e templates, e definir destinos de webhook diretamente, sem cliente para escrever e sem créditos para comprar. - Comparar um plano por assento com uma taxa por número sem antes contar os seus assentos e os seus números. - Pagar por uma caixa de entrada quando o seu time já tem uma. Uma taxa de plataforma cobre ela, você abrindo ou não. - Supor que recursos de IA e um conector MCP são a mesma coisa. Um roda dentro do produto deles; o outro roda dentro do seu. **Os dois acrescentam mesmo zero margem?** Sim. A página de preços da YCloud declara zero margem e nós também. Isso faz da taxa de plataforma, e não da taxa por mensagem, a coisa a comparar. **Qual é mais barato?** Para um a quatro números, o nosso: quatro números custam R$ 119,60 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 cai até R$ 4,90 por número conforme você adiciona números, com a faixa de plano que os seus assentos e canais exigem. **Eu perco uma caixa de entrada com vocês?** Você nunca precisou se mudar para dentro de uma. As mensagens chegam ao seu próprio sistema ou agente de IA, que é onde o seu time já trabalha. **A YCloud tem um conector MCP?** A página de preços deles descreve créditos de IA dentro da plataforma deles, e não um servidor MCP. O nosso é dezesseis ferramentas por OAuth, utilizáveis de qualquer cliente MCP. --- ## EasyCoexistence vs SleekFlow https://easycoexistence.com/pt/compare/easycoexistence-vs-sleekflow A SleekFlow é uma plataforma de mensageria omnicanal vendida por assento de usuário, com um mínimo de assentos e taxas adicionais por número de WhatsApp. A EasyCoexistence cobra por número conectado e não tem o conceito de assento, então a conta segue os números que você tem, e não o tamanho do seu time. ### Pelo que você está de fato pagando Os dois modelos de preço respondem perguntas diferentes, e um deles pergunta pelo seu organograma. - SleekFlow:: Uma plataforma de caixa de entrada compartilhada e campanhas cobrada por assento de usuário através de faixas de plano, o que faz sentido quando o produto é onde o seu time passa o dia. - EasyCoexistence:: Uma conexão. A unidade é um número conectado, não uma pessoa, então adicionar um colega não custa nada e a conta não muda quando o time cresce ou encolhe. ### Onde o seu time trabalha A decisão por baixo do modelo de preço, e a mais difícil de reverter. - SleekFlow:: Dentro da SleekFlow. Esse é o produto: uma caixa de entrada, automações e campanhas num lugar só, o que é genuinamente útil para um time que quer isso. - EasyCoexistence:: Onde eles já trabalham. Os eventos de mensagem vão da Meta direto para o seu CRM, help desk, ferramenta interna ou agente de IA pelo override de webhook da própria Meta. Ninguém aprende uma caixa de entrada nova e nada precisa ser migrado. ### Adicionar um segundo ou terceiro número Comum num negócio com mais de uma unidade, e onde os modelos divergem com força. - SleekFlow:: Números adicionais de WhatsApp são um adicional ao lado do plano por assento, então um segundo número é uma segunda decisão em cima da assinatura. - EasyCoexistence:: O segundo número é simplesmente o segundo número, na tarifa publicada, caindo conforme mais são adicionados. Vinte números numa conta não precisam de mudança de plano nem de conversa nenhuma. ### O que acontece se você parar de pagar Vale perguntar isso a qualquer produto que segura as suas conversas. - SleekFlow:: A caixa de entrada, o histórico e as automações moram na plataforma, que é o que os faz funcionar e também o que transforma a saída numa migração. - EasyCoexistence:: Não há nada de seu dentro de nós para migrar. As mensagens foram entregues no seu sistema conforme chegaram e o número está no seu próprio Portfólio de Negócios da Meta, então nos remover deixa o número exatamente onde estava. - Comparar um preço por assento com um preço por número sem contar os dois. Três assentos e um número dão uma conta muito diferente de um assento e três números. - Pagar por uma caixa de entrada que o seu time não vai abrir. Taxas de assento valem por assento, usado ou não. - Esquecer do adicional por número ao modelar um negócio com várias unidades. **Qual é mais barato?** O nosso. Um time de cinco pessoas numa caixa de entrada compartilhada está comprando outro produto, com preço por pessoa; um negócio com números e um CRM que já existe paga muito menos por número com a gente. **Eu ganho uma caixa de entrada compartilhada?** Não, e você também não paga por uma. As mensagens chegam ao seu próprio sistema, que é onde o seu time já trabalha hoje. **E no caso de várias unidades?** Cada número é cobrado na tarifa publicada, caindo conforme você adiciona mais. Não há mudança de plano nem adicional para negociar. **Meus dados ficam presos?** Com a gente, não. As mensagens vão direto da Meta para o seu endpoint e o número continua no seu próprio Portfólio de Negócios. --- ## EasyCoexistence vs Bird https://easycoexistence.com/pt/compare/easycoexistence-vs-bird A Bird cobra WhatsApp por mensagem entregue, com a taxa da própria Meta embutida dentro da tarifa cotada. A EasyCoexistence cobra um valor fixo por número conectado e nunca aparece na conta de mensagem, então o que a Meta cobra continua visível e separado. ### O que uma tarifa combinada esconde Não é desonesto, e está declarado abertamente na página deles. Ainda assim muda o que você consegue conferir. - Bird:: Uma tarifa por mensagem entregue, com a parte da Meta já dentro dela. A página deles explica que a Bird cobra a taxa de envio durante o processamento e registra a parte da Meta a partir do recibo de entrega. - EasyCoexistence:: Duas contas separadas que nunca se misturam. A Meta fatura o cliente pelas conversas na conta do WhatsApp Business dele, e nós faturamos pela conexão. Você consegue auditar qualquer uma das duas contra a fonte dela porque elas nunca foram combinadas. ### O que acontece quando a Meta muda as tarifas dela A Meta revisa o preço de conversa periodicamente, e os dois modelos repassam isso de formas diferentes. - Bird:: Uma tarifa combinada precisa ser revisada quando a tarifa por baixo se mexe, o que é uma mudança no número que foi cotado para você. - EasyCoexistence:: Nada do nosso lado se mexe. A mudança da Meta aparece na fatura da Meta do cliente, na tarifa da própria Meta, na data em que a Meta a aplica. A nossa taxa é pela conexão e não tem relação nenhuma com o que uma mensagem custa. ### Em torno do que cada produto é organizado Os dois enviam mensagens de WhatsApp. Eles não estão competindo pelo mesmo trabalho. - Bird:: Uma plataforma de marketing e relacionamento com o cliente através de e-mail, SMS e WhatsApp, feita para times rodando campanhas em escala por vários canais. - EasyCoexistence:: Infraestrutura de Coexistência para um número que já roda o app do WhatsApp Business. O app continua funcionando, a Cloud API roda ao lado dele, e os eventos chegam ao seu próprio sistema. Um número, um trabalho, feito direito. ### A quem a conversa pertence A pergunta estrutural que está por baixo dos dois modelos de preço. - Bird:: As mensagens são processadas e cobradas conforme passam pela plataforma, que é o que torna possível o ferramental de campanha e de analítica. - EasyCoexistence:: Os eventos de mensagem vão da Meta direto para o seu endpoint pelo override da própria Meta. Eles não passam por nós e nós não armazenamos, que é justamente por isso que não há nada por mensagem para nós cobrarmos. - Comparar uma tarifa combinada com a tarifa publicada da Meta como se fossem o mesmo número. Uma contém a outra. - Achar que um preço embutido significa que não há margem. Significa que a margem não está discriminada. - Escolher uma plataforma de campanha para um trabalho que é um número e um webhook. **O preço da Bird é desonesto?** Não. Eles declaram com clareza que a taxa da Meta está incluída. O ponto é que uma tarifa combinada não pode ser conferida contra a tarifa publicada pela própria Meta. **Quem me fatura pelas mensagens com vocês?** A Meta fatura, diretamente, na sua própria conta do WhatsApp Business. Nós nunca colocamos margem nem revendemos uma cobrança da Meta. **E se a Meta aumentar as tarifas dela?** Isso aparece na sua fatura da Meta, na tarifa da Meta. A nossa taxa não é afetada porque não está atrelada a mensagens. **A Bird suporta Coexistência?** A página de preços de WhatsApp deles não trata disso. É a totalidade daquilo que nós fazemos. --- ## EasyCoexistence vs Zenvia https://easycoexistence.com/pt/compare/easycoexistence-vs-zenvia A Zenvia vende planos mensais de software com pacotes de canal separados e uma taxa de ativação para habilitar o WhatsApp. A EasyCoexistence cobra uma única taxa publicada por número conectado, sem plano, sem pacote e sem custo de ativação, o que é outra ordem de grandeza para um pequeno negócio. ### Como a conta é montada A diferença estrutural, e a que decide o total que você vai pagar. - Zenvia:: Um plano mensal de software, mais um pacote de canal dimensionado ao volume esperado, mais uma taxa de ativação quando o canal de WhatsApp é habilitado. Três decisões e três linhas, o que serve a uma empresa com uma operação de marketing para tocar. - EasyCoexistence:: Uma linha. Uma taxa publicada por número conectado, caindo conforme números são adicionados, sem plano por cima, sem pacote ao lado e sem nada a pagar para começar. Os custos de conversa da Meta vão para o cliente vindos da Meta, separadamente e na tarifa da própria Meta. ### Para que cada um foi construído Os dois são produtos sérios. Eles miram empresas diferentes. - Zenvia:: Uma plataforma de experiência do cliente com campanhas multicanal, jornadas e uma grande base corporativa brasileira, vendida a empresas que rodam programas estruturados de comunicação. - EasyCoexistence:: Um negócio que já tem um número do WhatsApp Business num celular e quer ele na Cloud API sem perder o app. O app continua funcionando, a API roda no mesmo número, e as mensagens chegam ao sistema que o negócio já usa. ### O que acontece conforme o volume cresce Os dois modelos andam em direções opostas. - Zenvia:: Os pacotes de canal são dimensionados ao volume, então crescer significa subir de pacote, e a faixa de plano pode subir junto. - EasyCoexistence:: A tarifa por número cai conforme números são adicionados, e o volume de mensagens não entra na conta em momento nenhum. Um número que envia cem mil mensagens custa o que custa um número parado. ### Tempo até um número funcionando Para um pequeno negócio isso é muitas vezes a decisão inteira. - Zenvia:: Uma implantação comercial com uma etapa de ativação para o canal de WhatsApp, que traz um suporte do qual implantações maiores se beneficiam. - EasyCoexistence:: Minutos, pelo Embedded Signup da própria Meta, com três dias grátis a partir do primeiro número conectado. O app do WhatsApp Business continua funcionando o tempo todo e o monitoramento começa assim que o número conecta. - Comparar só o preço do plano. O pacote de canal e a taxa de ativação fazem parte do total. - Comprar uma plataforma de campanha para resolver um problema de conexão. - Supor que os custos de conversa da Meta estão incluídos em algum lugar. Eles são do cliente, na conta dele. **Posso pagar em reais?** Pode. O preço é publicado em reais e em dólares, e a moeda fica fixa naquela que a sua primeira assinatura usar. **Existe taxa de ativação?** Não. Três dias grátis, depois a taxa por número. Não há nada a pagar para habilitar WhatsApp num número. **Eu perco ferramental de campanha?** Não somos uma plataforma de campanha e não cobramos como uma. As mensagens chegam ao seu próprio sistema, então as campanhas rodam onde você já as roda. **Quem paga a Meta pelas conversas?** O cliente paga, diretamente, na conta do WhatsApp Business dele. Nunca colocamos margem numa cobrança da Meta. --- ## EasyCoexistence vs 8x8 https://easycoexistence.com/pt/compare/easycoexistence-vs-8x8 A 8x8 é uma provedora de comunicação empresarial cuja documentação de Coexistência está entre as mais claras disponíveis hoje, e é por isso que ela é tão citada. A EasyCoexistence foi feita para o negócio que lê essa documentação e quer um número conectado ainda hoje, sem passar por um processo de venda empresarial. ### Onde os dois se sobrepõem O terreno técnico é compartilhado entre os dois, e vale dizer isso antes de tratar das diferenças. - 8x8:: A documentação de Coexistência deles é precisa e incomumente clara sobre as restrições, inclusive sobre quais recursos do WhatsApp são desligados assim que um número é conectado. É uma referência genuinamente útil. - EasyCoexistence:: As mesmas restrições, porque elas são da Meta e não de um provedor qualquer. Nós também as documentamos, e construímos o produto para conviver com elas: a regra dos quatorze dias de inatividade, a janela de sincronização, os recursos que somem. ### Sair da leitura e chegar ao número conectado Essa é exatamente a distância que a documentação, por melhor que seja, não fecha sozinha. - 8x8:: Um CPaaS empresarial com times de conta, produtos de contact center e serviços de operadora, vendido para organizações que têm processos de compras. O onboarding vem com a ajuda de que grandes implantações precisam. - EasyCoexistence:: Você se cadastra e conecta. O Embedded Signup da própria Meta escolhe o portfólio, a conta e o número, o app do WhatsApp Business continua funcionando, e os primeiros três dias não custam nada. Não há reunião nenhuma para agendar. ### O que você já sabe antes de assumir o compromisso Aqui está a diferença prática para um pequeno negócio ou para uma agência que atende vários clientes. - 8x8:: O preço é combinado comercialmente, o que é padrão para CPaaS empresarial e é o certo para compradores que negociam volume de voz, contact center e mensageria de uma vez só. - EasyCoexistence:: A lista de preços inteira é publicada, na sua moeda, com as faixas de volume à vista. Uma agência com quarenta números calcula a própria conta antes mesmo de criar uma conta conosco. ### Depois que o número está conectado Conexões de Coexistência caem em silêncio, e essa é justamente a parte que a maioria das comparações pula. - 8x8:: Suporte empresarial e uma relação de conta dedicada, que é o modelo correto quando existe um contrato por trás sustentando aquilo. - EasyCoexistence:: Monitoramento contínuo que lê o motivo de desconexão da própria Meta, então quatorze dias de inatividade é distinguível de um cliente que foi embora, mais um conector MCP com dezesseis ferramentas para um assistente checar a saúde e reconectar sem ninguém abrir um painel. - Ler uma boa documentação como se ela fosse o produto. Os documentos descrevem o mecanismo da Meta, que todo provedor compartilha igualmente. - Começar um processo de compra empresarial inteiro só para conectar um único número. - Supor que algum provedor vigia a conexão depois que ela é feita. Pergunte isso especificamente, seja quem for que você escolher. **A documentação da 8x8 é precisa?** Sim, e nós a citamos. As restrições que ela descreve são da Meta, então valem para todo provedor de Coexistência, nós inclusive. **Quais recursos param de funcionar sob Coexistência?** Quatro, segundo a documentação da 8x8 e a nossa: mensagens temporárias, mídia de visualização única, localização em tempo real e listas de transmissão. Conversas em grupo ficam fora da API por inteiro. **Preciso de um contrato empresarial?** Conosco não. Três dias grátis, um preço publicado e um número conectado em poucos minutos, sem nenhuma negociação no meio. **O que acontece se a conexão cair?** Nós lemos o motivo de desconexão da Meta e avisamos você. Isso distingue a regra dos quatorze dias de inatividade de uma saída real do cliente. --- ## “Este número de telefone não é elegível” no cadastro da Coexistência https://easycoexistence.com/pt/docs/coexistence-error-number-not-eligible O popup de cadastro da Meta informa que um número não é elegível quando a conta do app do WhatsApp Business vinculada a ele não passa pelas verificações da Meta para conexão à plataforma. O motivo documentado pela Meta é atividade insuficiente no app. A solução é usar o app de forma real e contínua nesse número e executar o fluxo novamente. ### O que a mensagem realmente diz? O popup mostra a mensagem no idioma em que é exibido. Em inglês, aparece como "This phone number isn't eligible for registration or migration". Em espanhol, aparece 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 lista 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". Qualquer que seja o idioma, o significado é o mesmo. O fluxo chegou à etapa do número de telefone, a Meta analisou a conta do app do WhatsApp Business registrada nesse número e recusou a conexão com a API. Nada foi alterado no telefone, e o app continua funcionando exatamente como antes. ### Por que a Meta recusa um número aparentemente elegível? A resolução da própria Meta para 3441045 é curta: é necessária mais atividade no app do WhatsApp Business para ajudar a determinar a elegibilidade. A Meta não publica um limite, um número de dias ou uma quantidade de mensagens. Portanto, qualquer número visto em outro lugar é uma observação de um provedor, não uma regra da Meta. Em termos simples, isso aponta para contas com pouco uso real: um número cadastrado recentemente ou que quase não teve conversas verdadeiras. Duas outras recusas parecem semelhantes, mas não são a mesma coisa. O código 3441042 significa que o recurso não está disponível para números dessa região. Já na API, 2388091 e 2388093 informam que um número não é elegível para receber ou verificar um código de cadastro porque não está sendo migrado. Isso pertence ao fluxo de migração, não à Coexistência. ### O que fazer antes de tentar novamente? Use o número normalmente no app do WhatsApp Business: mantenha conversas reais com clientes, enviando e recebendo mensagens, por um período significativo. Evite excluir a conta ou cadastrar o número novamente enquanto espera, pois a verificação da Meta considera a atividade dessa conta, e começar de novo deixa menos dados para análise. Confira também o básico. O app precisa ser o app do WhatsApp Business, não o WhatsApp para consumidores, estar na versão 2.24.17 ou mais recente, e o número não pode estar conectado a outro provedor de API. Esses casos geram mensagens próprias, explicadas em páginas separadas. Depois, execute o fluxo novamente desde o início. A Meta avalia a elegibilidade em cada tentativa, então uma nova tentativa após atividade real é o único teste que importa. - Repetir o fluxo várias vezes seguidas. A Meta avalia a elegibilidade, e tentativas repetidas podem atingir limites de taxa. - Cadastrar o número novamente em uma instalação nova para começar do zero. A verificação da Meta considera a atividade, e um cadastro novo não tem nenhuma. - Supor que o provedor possa colocar o número em uma lista de permissões. Nenhum provedor pode substituir a decisão de elegibilidade da Meta. **Meu número foi banido?** Não. Esta mensagem trata da conexão do número com a API. O app do WhatsApp Business continua funcionando no telefone exatamente como antes. **Quanto tempo devo esperar antes de tentar novamente?** A Meta não publica um período fixo. A correção documentada é ter mais atividade real no app do WhatsApp Business, então espere até que o número esteja em uso genuíno. **Por que a mensagem menciona migração?** O mesmo popup também trata da transferência de números entre contas. A recusa abrange os dois fluxos, por isso o texto menciona ambos. **Outro provedor daria uma resposta diferente?** Não. Todos os provedores usam o mesmo Embedded Signup da Meta, e a verificação de elegibilidade é feita pela Meta. --- ## "Este número de telefone já está registrado em uma conta do WhatsApp" https://easycoexistence.com/pt/docs/coexistence-error-number-already-registered O popup de cadastro da Meta aparece quando o número já está registrado em algum lugar que impede a etapa em andamento: WhatsApp para consumidores, uma conta da WhatsApp Business API ou uma conta em outra plataforma. Primeiro, é preciso desconectar o número dessa conta. Depois da desconexão, a Meta informa que pode levar alguns minutos até o número ficar disponível novamente. ### O que a documentação da Meta diz que esta mensagem significa? A referência de erros do Embedded Signup da Meta lista 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." Ela acrescenta que o número pode levar até 3 minutos para ficar disponível. A explicação da Meta é que o número de telefone já está registrado na plataforma. Ela cita o WhatsApp Messenger, o app do WhatsApp Business e a WhatsApp Business API. A solução sugerida é cancelar o registro do número ou usar outro. O popup aparece no idioma do usuário, portanto a mesma recusa pode surgir em italiano, espanhol ou português, com o mesmo significado. ### Por que um cadastro de Coexistência encontraria esse erro? A Coexistência existe para conectar um número que já está registrado no app do WhatsApp Business. Portanto, o registro em si não é o problema. A mensagem aparece quando o fluxo não está no caminho de Coexistência ou quando o registro é de um tipo incompatível. Três situações produzem esse erro. O número está no WhatsApp para consumidores, e não no app do WhatsApp Business, que a Coexistência não consegue conectar. O fluxo executado é um cadastro padrão de número novo, em vez da opção de conectar uma conta existente do app do WhatsApp Business, então a Meta trata o número como um cadastro novo. Ou o número está registrado diretamente na WhatsApp Business API, fora do app. Cada situação exige uma correção diferente, por isso a mensagem, sozinha, não basta para decidir o que fazer. ### Como liberar o número e repetir a tentativa? Relacione a correção ao local onde o número está registrado. Se estiver no WhatsApp para consumidores, transfira-o primeiro para o app do WhatsApp Business no telefone. Se estiver no app do WhatsApp Business e o popup ainda mostrar esta mensagem, verifique se o fluxo ofereceu a opção de conectar uma conta existente do app do WhatsApp Business. Sem essa tela, o fluxo está errado. Se estiver registrado na API por meio de outra plataforma, desconecte-o nessa plataforma. Depois da desconexão, aguarde alguns minutos, conforme a observação da Meta. Em seguida, volte ao popup e insira o número novamente. Se o popup tiver sido fechado, reinicie o fluxo desde o começo, em vez de reutilizar uma janela antiga. - Repetir a tentativa com o mesmo número imediatamente após desconectá-lo. A Meta informa que a disponibilidade pode levar até três minutos. - Executar um cadastro padrão de número novo para um número do app. A Coexistência precisa do fluxo que oferece conectar a conta existente do app do WhatsApp Business. - Excluir a conta do app do WhatsApp Business para limpar o erro. Isso remove justamente o registro que a Coexistência conecta. **De qual conta existente a Meta está falando?** O popup não informa. É a conta em que o número está registrado atualmente: WhatsApp para consumidores, o app do WhatsApp Business no fluxo errado ou a API por meio de outra plataforma. **Vou perder minhas conversas se desconectar?** A desconexão de uma plataforma é feita no app do WhatsApp Business em Configurações, Conta, Plataforma de Negócios. É uma ação diferente de excluir a conta do app, o que não resolve o problema. **Vi esta mensagem em italiano. É o mesmo erro?** Sim. O popup é localizado, então a mesma recusa aparece no idioma usado pela sessão. **Um provedor precisa fazer alguma coisa?** Somente se o número estiver conectado por esse provedor. Nesse caso, a desconexão deve ser feita nele antes que o novo fluxo possa ser concluído. --- ## "Falha ao solicitar código: nossos servidores estão temporariamente indisponíveis" https://easycoexistence.com/pt/docs/coexistence-error-request-code-unavailable "Falha ao solicitar código: nossos servidores estão temporariamente indisponíveis. Aguarde 1 hora antes de tentar novamente" aparece quando um código de verificação é solicitado para um número durante o cadastro e a Meta não envia nenhum. A instrução da mensagem é a solução: pare de solicitar códigos, aguarde a hora completa e repita uma vez em um fluxo novo. ### Isso é uma indisponibilidade da Meta? Pode ser, mas as mensagens documentadas semelhantes apontam para outro lugar. A referência de erros do Embedded Signup da Meta não lista exatamente esse texto. Ela lista uma família de recusas de códigos de verificação que funciona da mesma forma: "You have requested your code too many times", os códigos 2494158 e 2388367 para solicitações repetidas e 2593037 para um erro ao solicitar o código. Em todos os casos, a pessoa deve voltar mais tarde. Também existe um problema real de plataforma. No lado da API, 133004 significa que um servidor está temporariamente indisponível, e a orientação da Meta é verificar a página de status da WhatsApp Business Platform antes de repetir. Se a página de status não mostrar nenhum incidente, trate a mensagem como um limite de solicitações de código para esse número e respeite a hora indicada. ### Por que um código é solicitado para um número de Coexistência? No fluxo de Coexistência, o número já está cadastrado no app do WhatsApp Business, e a Meta orienta os parceiros a pular a etapa de cadastro do número por esse motivo. O fluxo documentado pela Meta verifica a titularidade pelo próprio app: a empresa recebe uma mensagem da conta oficial Facebook Business no app do WhatsApp Business, toca em Connect e conclui a verificação ali. Portanto, uma solicitação de código que falha repetidamente é um sinal para conferir em qual fluxo o pop-up está. Se a tela para conectar uma conta existente do app do WhatsApp Business nunca apareceu, o fluxo está tratando o número como um novo cadastro e solicitando um código por SMS ou voz. É nesse ponto que esses limites entram em ação. ### Como repetir sem piorar a situação? Aguarde a hora completa solicitada pela mensagem, sem pedir outro código nesse intervalo. A Meta diz que o sistema limita quantas vezes um código pode ser solicitado em determinado período, portanto as solicitações feitas durante a espera prejudicam você. Quando a hora passar, feche o pop-up antigo e reinicie o fluxo, em vez de pressionar para reenviar em uma janela deixada aberta. Escolha a opção de conectar a conta existente do app do WhatsApp Business, mantenha o telefone com o número desbloqueado e por perto e conclua a verificação no app assim que ela chegar. Se um código incorreto foi inserido várias vezes, a orientação da Meta é diferente: o sistema permite um número limitado de tentativas de verificação e informa que é preciso esperar cerca de 12 horas antes de repetir. - Pressionar para reenviar repetidamente durante a hora. A Meta limita a frequência com que um código pode ser solicitado. - Presumir que a indisponibilidade é permanente e trocar de número. A mensagem informa uma espera temporária. - Executar um cadastro de novo número para um número do app. A Coexistência verifica pelo app do WhatsApp Business, não por um novo cadastro via SMS. **Esperar mais de uma hora ajuda?** Uma hora é o tempo indicado pela mensagem. Esperar mais não faz mal, mas solicitar códigos durante essa hora faz. **Meu provedor pode redefinir o limite?** Não. Os limites de códigos de verificação são aplicados pela Meta ao número, e nenhum provedor pode removê-los. **O app do WhatsApp Business foi afetado?** Não. O app continua funcionando no telefone. A recusa diz respeito apenas à etapa de cadastro no navegador. **Como saber se é uma indisponibilidade real?** Verifique a página de status da WhatsApp Business Platform da Meta. Se não houver nenhum incidente, trate a mensagem como um limite de solicitações de código. --- ## A leitura do QR Code da Coexistência falha no app do WhatsApp Business https://easycoexistence.com/pt/docs/coexistence-error-qr-code-pairing-failed Quando a leitura do código falha durante o cadastro da Coexistência, as causas a verificar estão no telefone: app do WhatsApp Business desatualizado, leitura feita pelo app ou dispositivo errado, ou algum aviso após a leitura deixado sem resposta. Para corrigir, atualize o app, leia o código pelo app do WhatsApp Business no telefone que tem o número e conclua todos os avisos. ### O que deve acontecer no telefone? A documentação da Meta descreve o lado do telefone em quatro etapas. A empresa recebe uma mensagem da conta oficial Facebook Business dentro do app do WhatsApp Business e toca em Connect. Depois, toca em Connect to the Business Platform. Em seguida, toca em Confirm, escolhendo se deseja compartilhar o histórico de conversas. Por fim, conclui a etapa do código de verificação e retorna ao navegador para finalizar o fluxo. O código exibido no navegador inicia essa conversa no app. Por isso, uma leitura que não faz nada ou um telefone que mostra um erro no momento da leitura indica que uma dessas etapas não conseguiu começar. Tudo o que veio antes, no navegador, já funcionou. ### Por que a leitura falha? Vale verificar quatro causas, nesta ordem. O app está desatualizado. A Meta exige a versão 2.24.17 ou mais recente do app do WhatsApp Business e tem um erro do Embedded Signup, 4563015, que apenas informa para atualizar o app para a versão mais recente. O app errado fez a leitura. O código precisa ser processado pelo app do WhatsApp Business que contém o número, no telefone principal. O WhatsApp para consumidores, o app de câmera do telefone ou um dispositivo conectado, como WhatsApp Web ou Desktop, não são a mesma coisa. Os avisos não foram concluídos. A leitura apenas abre a etapa; tocar em Connect, Connect to the Business Platform e Confirm é o que permite avançar. A janela pop-up foi fechada. Se a janela do navegador desapareceu, o fluxo que o telefone estava concluindo também foi encerrado. ### Como repetir o processo corretamente? Primeiro, atualize o app do WhatsApp Business pela loja de apps e abra-o novamente. Verifique se o telefone em mãos é o que contém o número e se está desbloqueado e conectado à internet. Depois, reinicie o cadastro desde o início no navegador, escolha a opção de conectar a conta existente do app do WhatsApp Business e mantenha a janela pop-up aberta enquanto usa o telefone. Processe o código dentro do app do WhatsApp Business, responda a cada aviso exibido e retorne ao navegador para finalizar. Após a conexão, espere que os dispositivos conectados sejam desconectados. A Meta remove todos os apps complementares quando o número se conecta à API, e eles podem ser conectados novamente depois. - Ler o código com o app de câmera do telefone. O código precisa ser processado pelo app do WhatsApp Business que contém o número. - Fechar a janela pop-up do navegador enquanto usa o telefone. A etapa no telefone precisa do fluxo que a iniciou. - Considerar os dispositivos conectados desconectados como uma falha. A Meta remove os apps complementares durante a conexão, e eles podem ser conectados novamente. **Outra pessoa pode fazer a leitura para a empresa?** Somente usando o telefone que contém o número. A etapa acontece no app do WhatsApp Business desse dispositivo. **Posso usar o WhatsApp Web para ler o código?** Não. Dispositivos conectados são complementos da conta. A etapa no telefone pertence ao app do WhatsApp Business do telefone principal. **Uma leitura malsucedida altera algo no telefone?** Não. Até o fluxo ser concluído, o número não está conectado e o app continua funcionando como antes. **Meu app diz que está atualizado. O que faço agora?** Verifique se o número da versão é 2.24.17 ou mais recente, reinicie o fluxo desde o início e conclua todos os avisos. --- ## Cadastro da Coexistência bloqueado por um Portfólio de Negócios antigo https://easycoexistence.com/pt/docs/coexistence-error-inaccessible-business-portfolio Se o número estiver vinculado a um Portfólio de Negócios da Meta diferente daquele selecionado no popup de cadastro, a Meta o recusa e informa que o número não está associado à empresa selecionada. O número precisa ser desvinculado dentro do outro portfólio, o que exige alguém com acesso de administrador, ou o fluxo precisa ser executado nesse portfólio. ### O que a Meta informa quando isso acontece? A referência de erros do Embedded Signup da Meta lista 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 Portfólio de Negócios escolhido na primeira tela do popup. A mensagem significa que a Meta já associa o número a um portfólio diferente. Esse vínculo pode vir de uma configuração anterior: uma agência que conectou o número, o Business Manager de um ex-funcionário ou uma conta antiga do WhatsApp criada para anúncios. Muitas vezes, a pessoa que executa o fluxo hoje nem sabe que isso existe. ### Como desvincular o número do outro portfólio? A solução documentada pela Meta tem duas partes, ambas realizadas dentro do portfólio que atualmente contém o número. Primeiro, remova a conta do WhatsApp vinculada ao número: Meta Business Suite, Settings, Accounts, WhatsApp Accounts, Remove Account. Depois, exclua o próprio número de telefone no WhatsApp Manager, na aba Phone Numbers. As duas etapas acontecem dentro desse portfólio, portanto exigem alguém com acesso de administrador. A Meta já exige permissão de administrador apenas para criar contas do WhatsApp Business em um portfólio. Quando o número estiver livre, execute o cadastro novamente e selecione o portfólio que você controla. ### E se ninguém conseguir acessar o portfólio antigo? Nesse caso, as opções realistas se reduzem a duas. Recupere o acesso primeiro. Quem criou o portfólio, ou qualquer administrador que ainda tenha acesso, pode adicionar a pessoa atual como administradora. Se o portfólio estiver com uma agência, isso significa pedir que ela conceda acesso ou faça a desvinculação. Como alternativa, execute o fluxo dentro do portfólio antigo assim que recuperar o acesso, em vez de retirar o número dele. A Coexistência mantém as contas convertidas no próprio portfólio do cliente, portanto o portfólio em que o fluxo for executado será aquele em que o número ficará depois. Escolha o que a empresa ainda controlará daqui a um ano. - Criar um portfólio novo e repetir a tentativa. O número continua vinculado ao antigo, então a mesma recusa volta a ocorrer. - Excluir a conta do app do WhatsApp Business para romper o vínculo. O vínculo é mantido do lado da Meta, dentro do outro portfólio. - Deixar o número em um portfólio que a empresa não controla. Quem o administra controla a conexão. **O suporte da Meta pode mover o número para mim?** A correção documentada pela Meta para o código 3441041 é desvincular o número dentro do outro portfólio, por alguém com acesso a ele. A Meta não descreve a movimentação do número em seu nome. **Como descubro qual portfólio contém o número?** A mensagem da Meta não informa isso. Verifique todos os portfólios que alguém da empresa já usou, inclusive os configurados por uma agência. **A desvinculação interrompe o app do WhatsApp Business?** As etapas removem a conta do WhatsApp e o número desse portfólio no Meta Business Suite e no WhatsApp Manager. Elas não acontecem no app do telefone. **Isso é igual a o número estar em outro provedor?** Não. Isso é uma conexão com o app de outro parceiro. Aqui, o número pertence a um portfólio diferente. --- ## A opção "Conecte seu app do WhatsApp Business existente" não aparece https://easycoexistence.com/pt/docs/coexistence-error-option-not-showing A opção de conectar uma conta existente do WhatsApp Business aparece somente quando a plataforma que inicia o Embedded Signup da Meta a habilitou no código. Sem essa configuração, o pop-up mostra a tela padrão de seleção de conta e trata o número como um novo cadastro. A empresa não pode ativá-la; a plataforma precisa fazer isso. ### Quem controla a exibição da opção? A plataforma que inicia o pop-up. A documentação da Meta orienta os parceiros a adicionar uma propriedade featureType definida como whatsapp_business_app_onboarding ao iniciar o Embedded Signup. A Meta também fornece este teste: se a tela de seleção de conta foi substituída por uma que oferece conectar uma conta existente do WhatsApp Business, o recurso está habilitado. Assim, quando a empresa vê as telas comuns, escolhe ou cria uma conta do WhatsApp Business e informa um número para cadastrar, o pop-up foi iniciado sem essa configuração. Nada nas configurações da própria empresa na Meta altera isso. A empresa só pode mudar para um link de cadastro de uma plataforma que tenha habilitado o recurso. ### Por que uma plataforma pode não oferecer essa opção? A Meta lista requisitos do lado da plataforma antes que o recurso possa ser habilitado. A plataforma já deve ser um Solution Partner ou Tech Provider, saber usar a Cloud API, ter um callback de webhook capaz de aceitar e processar webhooks e executar o Embedded Signup com registro de sessão. Uma ferramenta auto-hospedada ou uma integração criada em um app de desenvolvedor que não seja um Tech Provider não atende ao primeiro requisito. Nesse caso, uma mudança de configuração do lado da empresa não pode recuperar a opção. A solução é usar uma plataforma que tenha realizado esse trabalho. A outra lacuna são as versões. O Embedded Signup v2 e v3 serão descontinuados em 15 de outubro de 2026, e a Meta orienta os parceiros a migrar para a v4 antes dessa data. ### E se a opção aparecer, mas a conta não puder ser escolhida? Essa é uma recusa diferente, originada na conta, não na plataforma. A referência de erros da Meta lista 3441047: o recurso não está disponível para contas que usam mensagens de marketing, e a empresa precisa selecionar outra conta do WhatsApp Business. O código 3441042 significa que o recurso não está disponível para números daquela região. Um app abaixo da versão 2.24.17 é recusado com uma solicitação para atualizar para a versão mais recente. Cada caso apresenta sua própria mensagem no pop-up. Uma opção ausente, sem nenhuma mensagem, aponta novamente para a forma como o fluxo foi iniciado. - Procurar uma opção de Coexistência nas configurações da empresa na Meta. A opção é definida por quem inicia o pop-up. - Concluir o fluxo padrão mesmo assim. Sem a opção, a Meta trata o número como um novo cadastro, o que não é Coexistência. - Presumir que uma integração antiga do Embedded Signup ainda atende aos requisitos. A Meta descontinua o v2 e o v3 em 15 de outubro de 2026. **A empresa pode habilitar a Coexistência por conta própria?** Não no pop-up. A opção é definida pela plataforma que inicia o Embedded Signup, por meio da configuração featureType. **Como sei se a opção está habilitada?** O teste da própria Meta é este: a tela de seleção de conta é substituída por uma que oferece conectar sua conta existente do WhatsApp Business. **A empresa precisa de um portfólio verificado?** Os requisitos listados pela Meta para essa opção estão do lado da plataforma que inicia o fluxo, além de a empresa usar a versão 2.24.17 ou mais recente do app. **É uma restrição regional?** Uma recusa regional aparece com sua própria mensagem, usando o código 3441042. Uma opção ausente sem mensagem aponta para a forma como o fluxo foi iniciado. --- ## "Atualize seu app do WhatsApp Business" durante o cadastro da Coexistência https://easycoexistence.com/pt/docs/coexistence-error-business-app-outdated A Coexistência exige que o app do WhatsApp Business esteja na versão 2.24.17 ou mais recente no celular que possui o número. Abaixo disso, a janela de cadastro da Meta recusa o número e solicita a atualização do app para a versão mais recente. Atualizar pela loja de aplicativos e executar o fluxo novamente desde o início resolve o problema. ### 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 solução é exatamente essa: atualizar o app para a versão mais recente. O requisito por trás disso está na documentação de integração da Coexistência da Meta: o cliente empresarial deve usar o app do WhatsApp Business na versão 2.24.17 ou superior. A mensagem solicita a versão mais recente, em vez da mínima, e atualizar para a versão disponível mais recente atende aos dois requisitos. ### Qual dispositivo precisa ser atualizado? O celular principal: o dispositivo em que o número está registrado no app do WhatsApp Business. É esse app que a Meta verifica e é ele que executa a etapa do celular no fluxo. Atualizar o WhatsApp Web, o app para computador ou um tablet conectado à conta não conta, porque são dispositivos complementares, e não o registro em si. A documentação da Meta também informa que os clientes complementares são desvinculados quando o número se conecta à API, e que o WhatsApp para Windows e o WhatsApp para WearOS não são compatíveis depois disso. Em uma configuração com agência, a pessoa que executa o fluxo no navegador muitas vezes não está com o celular. Por isso, confirme essa etapa com o responsável pela empresa antes de começar. ### Como conferir a versão e repetir o cadastro? No celular que possui o número, localize a versão instalada do app do WhatsApp Business, nas informações de ajuda do próprio app ou na página dele na loja de aplicativos. Se estiver abaixo de 2.24.17, ou se a loja oferecer uma atualização, instale-a. Depois da atualização, feche e reabra o app para garantir que a nova versão esteja em execução. Em seguida, inicie o fluxo de cadastro novamente desde o começo no navegador, em vez de retomar uma janela que já exibiu a recusa, e escolha a opção de conectar a conta existente do app do WhatsApp Business. A atualização acontece na loja de aplicativos, não na janela de cadastro. Portanto, essa etapa cabe a quem está com o celular. Confirme com essa pessoa o novo número da 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 o app para computador. A Meta verifica o app do WhatsApp Business no celular principal. - Atualizar o WhatsApp comum em um celular que tem os dois apps. O app Business é uma instalação separada, com sua própria versão. - Repetir o processo na mesma janela depois da atualização. Inicie o fluxo novamente para que a verificação use a nova versão. **A versão 2.24.17 é suficiente ou preciso da mais recente?** A versão mínima informada pela Meta é 2.24.17. O texto do erro solicita a versão mais recente, então fazer a atualização completa atende aos dois requisitos. **A atualização apaga alguma conversa?** Uma atualização substitui a versão do app no mesmo registro. Isso não equivale a excluir a conta ou registrar o número novamente, ações que devem ser evitadas. **A versão continua sendo importante depois da conexão?** O requisito da Meta é indicado para a integração. Ainda assim, manter o app atualizado é recomendável, porque o celular continua fazendo parte da conexão. **Isso é o mesmo que o número não ser elegível?** Não. A elegibilidade diz respeito à atividade da conta. Este caso envolve exclusivamente a versão do app no celular. --- ## Erro de Coexistência: número já conectado a outro provedor https://easycoexistence.com/pt/docs/coexistence-error-number-on-another-provider O fluxo de Coexistência da Meta não conecta um número do app do WhatsApp Business a uma nova plataforma enquanto outra ainda o mantém conectado. Se o número já estiver conectado a outro provedor, o pop-up de cadastro da Meta o recusa e informa que a troca de parceiros não é compatível com esse fluxo. A empresa desconecta a plataforma atual no app do WhatsApp Business, espera 15 minutos e então executa o novo cadastro. ### Quais mensagens indicam que o número está em outro provedor? A referência de erros do Embedded Signup da Meta tem três mensagens para essa situação, na seção sobre integração de usuários do app do WhatsApp Business. - 2655093: a empresa já compartilha esta conta do WhatsApp Business com um parceiro, e a troca de parceiros não é compatível com este fluxo. - 3441049: o número já está registrado no produto e precisa ser desconectado da conta atual no app do WhatsApp Business. - 2655094: desconecte sua plataforma empresarial para continuar e espere 15 minutos antes de repetir. ### Como desconectar o provedor atual? Pelo celular, no app do WhatsApp Business. O caminho indicado pela Meta é Configurações, Conta, Plataforma empresarial; depois, selecione a plataforma conectada e toque em Desconectar. A Meta também informa que a chamada de desregistro da própria API não pode ser usada em um número que esteja em uso tanto com o app quanto com a Cloud API. Por isso, a desconexão acontece no app, e não pelo painel do provedor antigo. Quando a empresa desconecta, a Meta envia à plataforma anterior um webhook account_update com um evento PARTNER_REMOVED. É assim que o provedor antigo fica sabendo. Qualquer assinatura com esse provedor é uma questão separada entre a empresa e ele. ### O que acontece depois da desconexão? Espere. As mensagens da Meta para 3441049 e 2655094 orientam esperar 15 minutos antes de repetir. Depois, execute desde o início o cadastro da nova plataforma e escolha a opção de conectar a conta existente do app do WhatsApp Business. É uma nova integração: o compartilhamento do histórico de conversas é oferecido novamente, e a nova plataforma tem 24 horas após a integração para sincronizar contatos e histórico. Ainda há um caso que pode interromper a troca. A Meta informa que uma empresa que trabalhou com um parceiro no passado e ainda compartilha a linha de crédito dele pode encontrar um erro ao migrar para um novo parceiro. A Meta publica um guia separado para resolver esse caso. - Pedir ao provedor antigo para desregistrar o número. A Meta informa que a chamada de desregistro não funciona em um número usado tanto com o app quanto com a Cloud API. - Repetir poucos minutos depois da desconexão. A Meta pede que se espere 15 minutos. - Excluir a conta do app do WhatsApp Business para romper a conexão antiga. Desconectar em Configurações é o procedimento documentado. **É possível conectar um número a dois provedores ao mesmo tempo?** Não por este fluxo. A mensagem da Meta informa que a troca de parceiros não é compatível sem desconectar primeiro o parceiro atual. **Desconectar apagará minhas conversas?** A desconexão remove a conexão com a plataforma. O app do WhatsApp Business permanece no celular e continua funcionando. **O novo provedor pode desconectar o antigo por mim?** Não. A empresa faz a desconexão no app do WhatsApp Business. **O histórico será sincronizado novamente com o novo provedor?** A nova integração oferece novamente o compartilhamento do histórico, e a nova plataforma tem 24 horas para executar a sincronização. --- ## "Este código de autorização expirou" após o cadastro na Coexistência https://easycoexistence.com/pt/docs/coexistence-error-authorization-code-expired Quando o Embedded Signup da Meta termina, ele entrega à plataforma que iniciou o fluxo um código de curta duração, que deve ser trocado por um token de acesso em até 30 segundos. Se a troca ocorrer depois disso ou usar um código de uma tentativa anterior, a Meta informa que o código de autorização expirou. Executar o fluxo novamente gera um código novo. ### Qual código expirou? Quando a empresa conclui o Embedded Signup, a Meta retorna os IDs dos ativos e um código de token trocável à janela do navegador que abriu o popup. A plataforma então envia esse código ao próprio servidor, que chama o endpoint oauth access_token da Meta com o ID e o segredo do app para trocá-lo por um token da empresa. O guia de implementação da Meta é explícito sobre o prazo: o código de token trocável tem tempo de vida de 30 segundos, portanto a plataforma precisa fazer a troca antes que ele expire. Uma troca tentada depois desse momento é recusada, e "Este código de autorização expirou" é a mensagem dessa recusa. A empresa não fez nada errado ao concluir o popup lentamente; o relógio começa quando o código é retornado. ### Por que isso acontece quando o popup termina tarde ou duas vezes? Várias situações podem atrasar a troca além desse limite. A aba do navegador ficou em segundo plano ou o laptop entrou em suspensão enquanto o fluxo terminava, então o código chegou ao servidor da plataforma muito depois de ser emitido. O servidor da plataforma colocou a troca em fila atrás de outras tarefas em vez de executá-la imediatamente. Ou a pessoa abriu o fluxo duas vezes, concluiu ambos e a plataforma trocou o código da primeira janela depois que a segunda foi concluída. Em testes, há uma quarta situação: copiar o código do console do navegador e trocá-lo manualmente com cURL ou Postman. O guia da Meta alerta exatamente sobre isso e recomenda deixar a requisição de troca pronta antes de iniciar o fluxo. ### Como concluir a conexão? Execute o fluxo novamente desde o início em uma única janela e deixe a página da plataforma em primeiro plano até a conclusão. Cada conclusão retorna um código novo, e uma troca imediata desse código é tudo de que a plataforma precisa. Para um número em Coexistência, faça isso prontamente. A Meta converte a conta do WhatsApp Business quando a empresa conclui o fluxo e, depois que a plataforma faz o onboarding do cliente, ela tem 24 horas para sincronizar o histórico de mensagens. Depois disso, a empresa precisa ser removida do onboarding e concluir o fluxo novamente. No lado da plataforma, a correção duradoura é trocar o código no servidor assim que ele chegar, antes de qualquer outra etapa do onboarding. - Repetir a troca do token com o mesmo código. Ele expirou após 30 segundos e não voltará a funcionar. - Executar o cadastro em duas janelas ao mesmo tempo. Só conta o código da tentativa que está sendo trocada. - Trocar o código no navegador. A Meta exige que a troca seja uma requisição servidor a servidor com o segredo do app. **A empresa conectou o número ou não?** A empresa concluiu o fluxo da Meta, mas a plataforma não conseguiu transformar o código em um token funcional. Por isso, ainda não pode operar o número. Executar o fluxo novamente gera um código novo. **É possível fazer o código durar mais?** Não. A Meta define o tempo de vida de 30 segundos, e nenhuma plataforma pode estendê-lo. **O app do WhatsApp Business é afetado?** Não. O app continua funcionando no celular enquanto isso é resolvido. **Isso é igual a um token de acesso expirado?** Não. Este é o código de cadastro de curta duração. Um token de acesso expirado em uma conexão funcional retorna o erro 190. --- ## "Seu app não tem as permissões necessárias da Graph API para o pareamento de companhia da Cloud API" https://easycoexistence.com/pt/docs/coexistence-error-companion-pairing-permission Esta mensagem significa que a plataforma que iniciou o cadastro não tem as permissões do WhatsApp exigidas pela Meta, no nível de acesso exigido, para conectar um número do app do WhatsApp Business à Cloud API. A Meta só permite que uma empresa conceda permissões para as quais a plataforma tenha Advanced access. A empresa não pode corrigir isso; a plataforma precisa fazê-lo. ### O que essa mensagem significa? 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 exatamente essa redação, mas cada parte corresponde a algo que a Meta documenta. "Seu app" é o app da Meta da plataforma que executa o cadastro, não o app do WhatsApp Business no telefone. A Meta não define publicamente o pareamento de companhia; pelo contexto, ele descreve a Cloud API conectando-se a um número que continua registrado no app do WhatsApp Business, que é a configuração de Coexistência. E as permissões "advanced" do WhatsApp Business referem-se ao Advanced access, o nível concedido pela Meta por meio da análise do app. ### Quais permissões estão envolvidas? A documentação de permissões da Meta cita duas que as integrações do WhatsApp geralmente precisam. whatsapp_business_management abrange metadados da conta, templates, números de telefone, análises e webhooks da conta. whatsapp_business_messaging abrange o envio de mensagens e o recebimento de webhooks de mensagens e status. Para um parceiro cujos clientes usam seu app, a Meta exige análise do app e Advanced access para cada permissão necessária. A Meta declara diretamente a consequência: sem Advanced access para uma permissão, os clientes não podem concedê-la ao app pelo Embedded Signup. Chamadas feitas com whatsapp_business_management em contas que o app não possui, sem Advanced access, retornam o erro 200. Uma plataforma pode verificar o que uma empresa realmente concedeu inspecionando o token com o endpoint debug_token da Meta, que lista as permissões concedidas em scopes. ### O que a empresa pode fazer? Muito pouco do próprio lado, e ela não deve tentar alterar as configurações da Meta para resolver isso. A correção depende da plataforma: ela precisa ser Tech Provider ou Solution Partner, requisito que a Meta lista para cadastrar usuários do app do WhatsApp Business, e precisa ter Advanced access aprovado para as permissões do WhatsApp. A empresa pode informar a mensagem exata à plataforma e repetir o processo quando a plataforma confirmar seu acesso, ou usar uma plataforma que já tenha esse status. Repetir o mesmo fluxo na mesma plataforma antes disso produz o mesmo resultado e não afeta o app do WhatsApp Business no telefone. - Conceder mais permissões nas próprias configurações da Meta da empresa. O acesso ausente pertence ao app da plataforma. - Hospedar uma ferramenta por conta própria em um app de desenvolvedor sem análise do app. Sem Advanced access, as empresas não podem conceder as permissões necessárias. - Repetir várias vezes na mesma plataforma. O resultado só muda quando o acesso dessa plataforma muda. **Há algum problema com meu app do WhatsApp Business?** Não. A mensagem se refere ao app da Meta da plataforma, não ao app no seu telefone, que continua funcionando. **Posso conceder a permissão por conta própria?** Somente as permissões para as quais a plataforma tem Advanced access aparecem para você conceder. Primeiro, o acesso ausente precisa ser aprovado para a plataforma. **Como uma plataforma obtém Advanced access?** Por meio da análise do app pela Meta para cada permissão necessária ao app, como parceira cujos clientes usam o app. **A empresa precisa passar pela análise do app?** Não. A Meta diz que um desenvolvedor que acessa diretamente apenas os próprios dados comerciais não precisa de análise do app nem de Advanced access. --- ## Erro 0 do WhatsApp: não foi possível autenticar o usuário do app https://easycoexistence.com/pt/docs/whatsapp-error-0 O código de erro 0 significa que a Meta não conseguiu autenticar o usuário do app por trás do token de acesso. A descrição da Meta diz: "We were unable to authenticate the app user." O token expirou, foi invalidado ou o usuário bloqueou todos os apps de acessar os próprios dados. A correção é obter um novo token de acesso, não repetir a requisição. ### O que significa o código de erro 0 do WhatsApp? Isso significa que a plataforma recebeu uma requisição, mas não conseguiu associá-la a um usuário do app em que confia. A Meta classifica o código 0 entre os erros de autorização na referência de erros da Cloud API, com o texto de detalhes "We were unable to authenticate the app user." Os possíveis motivos estão todos relacionados ao token: ele expirou, foi invalidado ou a pessoa que o autorizou alterou uma configuração que impede todos os apps de acessar os dados dela. Nada nessa lista diz respeito ao número de telefone, à conta do WhatsApp Business ou à mensagem enviada. A requisição não avançou o suficiente para verificar nenhum desses itens. ### Como corrigir o erro 0? Obtenha um novo token de acesso. Esse é o recurso indicado pela Meta e o único que funciona. Antes de substituí-lo, descubra qual das três causas se aplicou, pois cada uma voltará a ocorrer se for ignorada. Um token de usuário com validade curta expirará novamente no prazo previsto. Um token invalidado continuará falhando até que alguém conceda acesso outra vez. Um usuário que desativou completamente o acesso dos apps precisa reativá-lo antes que qualquer token desse usuário funcione. Para envios de servidor para servidor, o guia de tokens de acesso da Meta recomenda tokens de System User, descritos como de longa duração e adequados a serviços automatizados que não exigem interação do usuário. ### O erro 0 é igual ao erro 190? Na prática, eles se sobrepõem e são listados separadamente pela Meta. O erro 190 traz o texto de detalhes "Your access token has expired." O erro 0 é mais amplo: abrange um token expirado, um token invalidado e um usuário que bloqueou completamente o acesso dos apps. Ambos aparecem na mesma tabela de autorização e, nos dois casos, a solução é obter um novo token. A diferença prática está no diagnóstico. O erro 190 informa que o token perdeu a validade. O erro 0 informa que a autenticação falhou e exige que você descubra o motivo. Vale fazer isso antes de emitir uma substituição que falhe exatamente da mesma forma uma hora depois. - Repetir a mesma requisição. Um token não autenticado continua não autenticado, então toda repetição retorna o código 0 novamente. - Reconectar o número. O número nunca foi verificado, portanto cadastrá-lo outra vez apenas dá trabalho ao responsável pela empresa sem mudar nada. - Emitir um novo token de usuário de curta duração para uma tarefa de backend. Ele expirará no prazo previsto e o erro voltará. **O erro 0 significa que meu número foi desconectado?** Não. Os motivos indicados pela Meta para o código 0 estão todos relacionados ao token de acesso. O número e o app do WhatsApp Business no telefone não estão envolvidos. **Onde o erro 0 está documentado?** Na tabela de erros de autorização da referência de códigos de erro da Cloud API da Meta. A Cloud API é baseada na Graph API, que usa o mesmo formato de erro. **Esperar fará o erro 0 desaparecer?** Não. Um token expirado ou invalidado não se recupera sozinho. É necessário obter um novo token. **Como verifico o que um token pode fazer?** Use o depurador de tokens de acesso da Meta ou o endpoint debug_token. Ambos mostram se o token é válido, quando expira e quais permissões ele possui. --- ## Erro 3 do WhatsApp: problema de capacidade ou permissões https://easycoexistence.com/pt/docs/whatsapp-error-3 O código de erro 3 indica que o app que chama o endpoint não tem uma capacidade ou permissão exigida por esse endpoint. A descrição da Meta é "Capability or permissions issue." A Graph API o chama de API Method. A correção é verificar as permissões concedidas ao token com o depurador de access token e adicionar a que o endpoint exige. ### O que significa o código de erro 3 do WhatsApp? Isso significa que a requisição foi autenticada, mas o app não tem autorização para fazer o que solicitou. A Meta lista o código 3 entre os erros de autorização na referência da Cloud API, com o texto de detalhes "Capability or permissions issue." O guia de tratamento de erros da Graph API, herdado pela Cloud API, chama o mesmo código de API Method e orienta verificar se o app tem a capacidade ou as permissões necessárias para a chamada. Portanto, o token funciona. A identidade não é o problema, e isso diferencia o erro dos códigos 0 e 190. O problema está no que o token está autorizado a acessar. ### Como verificar quais permissões um token tem? Use o depurador de access token ou o endpoint debug_token, que retorna as mesmas informações. A resposta lista as permissões concedidas na propriedade scopes. Compare essa lista com a página de referência do endpoint que falhou, pois cada referência informa as permissões exigidas. No WhatsApp, duas permissões cobrem quase tudo. whatsapp_business_management é necessária para metadados da conta, templates, listagens de números, análises e webhooks da conta. whatsapp_business_messaging é necessária para enviar qualquer mensagem e receber webhooks de mensagens e status. Um token que tenha apenas uma delas falha nas chamadas que exigem a outra. ### Por que um app parceiro pode ver o erro 3 quando um desenvolvedor direto não vê? Porque parceiros que atendem outras empresas passam por uma etapa adicional. O guia de permissões da Meta informa que um parceiro cujos clientes usam seu app para acessar os próprios dados precisa passar pela App Review e ter Advanced access para cada permissão exigida pelo app. Um desenvolvedor direto que trabalha apenas com os dados da própria empresa não precisa de App Review nem de Advanced access. Assim, o mesmo código pode funcionar na conta do próprio desenvolvedor e falhar na conta de um cliente. Quando isso acontece, a questão não é qual permissão falta no token, mas se o app foi aprovado para usar essa permissão em ativos que não pertencem a ele. - Gerar um novo token com os mesmos escopos. Um token novo com as mesmas permissões falha no mesmo ponto. - Verificar o nome da permissão nas configurações do app em vez de conferir o token. O que importa é o que foi concedido ao token. - Testar apenas na própria conta. Apps parceiros precisam de Advanced access antes que contas de clientes aceitem a chamada. **O erro 3 é um problema com meu número?** Não. Ele diz respeito ao que o token do app está autorizado a fazer. O número não é verificado antes de a requisição ser recusada. **Qual é a diferença entre o erro 3 e o erro 10?** O código 3 indica um problema de capacidade ou permissões. O código 10 informa que uma permissão não foi concedida ou foi removida. Ambos são resolvidos verificando os escopos do token. **Qual permissão preciso para enviar mensagens?** whatsapp_business_messaging. O guia de permissões da Meta informa que ela é necessária para enviar qualquer tipo de mensagem. **Repetir a requisição ajuda?** Não. As permissões do token não mudam entre as tentativas, então o resultado é o mesmo. --- ## Erro 4 do WhatsApp: o app atingiu o limite de chamadas da API https://easycoexistence.com/pt/docs/whatsapp-error-4 O código de erro 4 significa que o app atingiu o limite de taxa de chamadas da API. A descrição da Meta é "The app has reached its API call rate limit." Ela contabiliza as chamadas feitas pelo app em uma hora móvel, não as mensagens enviadas por um número. Consulte o uso no App Dashboard, aguarde e reduza a frequência com que o app chama a API. ### O que significa o código de erro 4 do WhatsApp? Significa que seu app fez chamadas demais à API na janela atual, e novas chamadas são recusadas até que a contagem diminua. A Meta lista o código 4 entre os erros de limitação de taxa, com o texto detalhado "The app has reached its API call rate limit." O guia de tratamento de erros da Graph API o chama de API Too Many Calls e o descreve como um problema temporário de limitação. Ele aparece ao lado de outros dois códigos de limitação que podem ser confundidos com ele. O 80007 indica que a WhatsApp Business Account atingiu seu limite de taxa. O 130429 indica o throughput de mensagens da Cloud API. O código 4 não é nenhum dos dois: ele representa o orçamento de chamadas do próprio app. ### Como o limite de chamadas do app é calculado? Para requisições feitas com um app access token, o guia de limitação de taxa da Graph API da Meta apresenta uma fórmula: as chamadas em uma hora equivalem a 200 multiplicado pelo número de usuários. O número de usuários se baseia nos usuários ativos diários únicos do app, usando os números semanais e mensais quando o uso diário cai. É um limite para o app como um todo, não por usuário, então alguns usuários muito ativos podem consumir a maior parte dele. O guia também informa que o uso aparece no App Dashboard e, depois que chamadas suficientes forem feitas, no cabeçalho X-App-Usage das respostas. Esse cabeçalho permite ver o limite se aproximando antes que o erro 4 apareça. ### O que fazer depois do erro 4? Pare de chamar por algum tempo e depois chame com menos frequência. O guia de limitação de taxa da Meta é direto quanto à primeira parte: quando o limite for atingido, pare de fazer chamadas à API, pois continuar aumenta a contagem e prolonga o tempo até que as chamadas funcionem novamente. A segunda parte é uma questão de design. Distribua as requisições de forma uniforme em vez de fazê-las em rajadas, filtre as respostas para que uma chamada retorne o que você precisa e evite chamadas que busquem dados sobrepostos. O polling costuma ser o culpado. Uma integração que consulta o mesmo status da conta a cada poucos segundos gasta seu orçamento com respostas que já possui. - Repetir em um loop. Cada chamada extra aumenta a contagem e afasta a recuperação. - Tratar isso como limite de envio. O código 4 contabiliza as chamadas do app, enquanto o throughput de mensagens é 130429. - Consultar endpoints de status em intervalos curtos. Leituras repetidas de dados inalterados consomem o orçamento por hora. **O erro 4 é igual ao erro 130429?** Não. O 130429 é o throughput de mensagens de um número. O erro 4 é o número de chamadas à API feitas pelo seu app. **Quanto tempo dura o erro 4?** Até que a contagem de chamadas na janela móvel de uma hora fique abaixo do limite. Fazer chamadas durante esse período prolonga a espera. **Onde posso ver quão perto meu app está do limite?** Na seção Application Rate Limit do App Dashboard e no cabeçalho X-App-Usage retornado nas respostas. **O erro 4 é igual ao erro 80007?** Não. A Meta usa o 80007 quando a WhatsApp Business Account atinge seu limite de taxa, enquanto o erro 4 contabiliza as chamadas do próprio app. --- ## Erro 10 do WhatsApp: permissão não concedida ou removida https://easycoexistence.com/pt/docs/whatsapp-error-10 O código de erro 10 significa que o token do app não tem uma permissão necessária para o endpoint, porque ela nunca foi concedida ou foi removida. A descrição da Meta é "Permission is either not granted or has been removed." A Meta também lista duas causas no WhatsApp: um número fora da lista de permissão em Flows with Endpoint e o não cumprimento dos requisitos de elegibilidade de uma API. ### O que significa o código de erro 10 do WhatsApp? Isso significa que o token chegou à Meta e foi reconhecido, mas não contém a permissão exigida pela chamada. A referência da Cloud API do WhatsApp atribui ao código 10 o texto detalhado "Permission is either not granted or has been removed." O guia de tratamento de erros da Graph API o chama de API Permission Denied e orienta tratar a permissão ausente. A palavra removida é importante. Uma permissão pode ser concedida na configuração e retirada depois, por exemplo quando alguém revoga o acesso do app nas Configurações do Negócio. Assim, uma integração que funcionou por meses pode começar a retornar 10 sem nenhuma mudança no próprio código. ### Quais outras causas a Meta lista para o erro 10? Há duas causas específicas do WhatsApp, e ambas passam facilmente despercebidas porque não têm relação com escopos. Para Flows with Endpoint do WhatsApp, a Meta orienta verificar se o número de telefone usado para configurar a chave pública do negócio está na lista de permissão. Um número fora dessa lista produz esse código mesmo quando o token contém todas as permissões. A Meta também informa que uma conta que não cumpre os requisitos de elegibilidade da API chamada recebe esse código. Nesse caso, nenhuma alteração no token ajudará, porque a barreira é a elegibilidade da conta, e não a credencial. ### Como corrigir o erro 10? Comece pelo depurador de token de acesso, que a Meta indica como primeira verificação. Se a lista de escopos não tiver a permissão exigida pelo endpoint, peça ao negócio que a conceda novamente. Para um app parceiro, isso também significa confirmar o acesso avançado à permissão, pois o guia de permissões da Meta o exige para contas de clientes. Se os escopos estiverem completos, verifique as duas causas específicas do WhatsApp. Em uma chamada de Flows, confira a lista de permissão do número que configurou a chave pública. Em qualquer outro caso, leia os requisitos de elegibilidade da API chamada e confirme se a conta os cumpre antes de alterar qualquer credencial. - Supor que a integração parou por causa de uma implantação. Uma permissão removida nas Configurações do Negócio produz esse código sem nenhuma alteração no código. - Recriar o token quando a causa é a elegibilidade. Uma credencial não pode tornar elegível uma conta inelegível. - Ignorar a lista de permissão de Flows. Em Flows with Endpoint, um número fora dela retorna 10 mesmo com todos os escopos. **O erro 10 é igual ao erro 131005?** Eles compartilham a mesma descrição na referência da Meta. O código 10 é o código da Graph API, enquanto 131005 pertence à faixa do WhatsApp. Ambos são verificados da mesma forma. **O erro 10 pode aparecer em um número que funcionou ontem?** Sim. A descrição da Meta inclui permissões removidas, então um acesso concedido anteriormente pode ser retirado depois. **O erro 10 significa que meu token expirou?** Não. Um token expirado corresponde ao código 190 ou 0. O código 10 significa que o token é válido, mas não tem uma permissão. **Como vejo quais permissões foram concedidas?** Chame debug_token ou abra o depurador de token de acesso. A propriedade scopes lista todas as permissões presentes no token. --- ## Erro 200 do WhatsApp: nenhum token de acesso fornecido https://easycoexistence.com/pt/docs/whatsapp-error-200 O código de erro 200 indica que a requisição chegou à Meta sem um token de acesso. A descrição da Meta é "No access token was provided" e a API retorna a mensagem 'Provide valid app ID'. Ele aparece em certos endpoints GET, como whatsapp_business_profile. Os códigos de 200 a 299 também abrangem permissões que não foram concedidas ou foram removidas. ### Por que o erro 200 diz 'Provide valid app ID'? Porque essa é a mensagem que a API retorna, embora o problema real seja a ausência de um token. A referência de erros da Meta diz que o código 200 ocorre em certos endpoints GET, como whatsapp_business_profile, quando nenhum token é incluído, e que a API retorna a mensagem 'Provide valid app ID'. A mesma referência observa que outros endpoints podem retornar 190 ou 104 para a mesma ausência. Assim, o texto aponta para o app ID, mas a correção está no token. Verifique se o cabeçalho Authorization está presente e escrito corretamente, e se a variável que armazena o token foi realmente preenchida quando a requisição foi criada. ### Quando o erro 200 indica uma permissão ausente? Quando o token está presente, mas o app não tem a permissão necessária para a chamada. A Meta lista a faixa de 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 token de acesso. Dois casos específicos estão documentados. O guia de permissões diz que um app que usa whatsapp_business_management em WABAs que sua empresa não possui, sem Advanced access, recebe o erro 200. O guia de registro diz que descadastrar um número sem whatsapp_business_management retorna o erro 200. O guia de token de acesso acrescenta um terceiro caso: um token de System User cujo usuário não tem acesso ao recurso consultado é rejeitado com 200. Leia o texto da mensagem para distinguir os casos. Um token ausente diz 'Provide valid app ID'. ### Qual é a diferença entre o erro 200 e o erro 190? O erro 190 significa que um token foi enviado e expirou. O erro 200, em seu primeiro significado, indica que nenhum token foi enviado. A referência da Meta declara essa distinção diretamente: a solução para o 200 é garantir que a requisição inclua um token de acesso válido, e ela diferencia essa condição do 190, que abrange tokens expirados ou inválidos. Isso muda onde procurar. Um 190 direciona você para a validade e a renovação dos tokens. Um 200 com 'Provide valid app ID' direciona você para o código que cria a requisição, porque a credencial nunca saiu do seu sistema. - Procurar um problema no app ID. A mensagem menciona o app ID, mas a causa documentada pela Meta é uma requisição sem token. - Renovar o token quando ele nunca foi enviado. Um token novo que a requisição continua omitindo produz o mesmo erro. - Tratar todo 200 como ausência de token. Com um token presente, a faixa de 200 a 299 indica uma permissão ausente. **O erro 200 pode aparecer em um número que está funcionando?** Sim. Ele descreve a requisição, não o número. Um número em perfeito estado ainda rejeita uma chamada que chega sem token. **Por que um endpoint retornou 200 e outro, 190?** A Meta diz que, para um token ausente, alguns endpoints GET retornam 200, enquanto outros podem retornar 190 ou 104. **Descadastrar um número exige uma permissão específica?** Sim. O guia de registro da Meta diz que descadastrar um número sem whatsapp_business_management retorna o erro 200. **O erro 200 está relacionado ao erro 10?** Em seu sentido relacionado a permissões, sim. Ambos trazem a descrição de que uma permissão não foi concedida ou foi removida. --- ## Erro 130472 do WhatsApp: mensagem não enviada em um experimento https://easycoexistence.com/pt/docs/whatsapp-error-130472 O erro 130472 indica que uma mensagem com template de marketing não foi enviada porque o destinatário participa do experimento de mensagens de marketing da Meta. A descrição da Meta é "Message was not sent as part of an experiment." Uma pequena porcentagem dos usuários do WhatsApp não recebe templates de marketing, a menos que uma janela de atendimento ou de ponto de entrada gratuito esteja aberta. A mensagem não é cobrada. ### O que significa o erro 130472 do WhatsApp? Isso significa que a Meta reteve um template de marketing porque o destinatário pertence a um grupo de experimento. A página de experimentos da Meta explica que o WhatsApp realiza experimentos contínuos para medir o efeito das mensagens na experiência do usuário. No experimento de mensagens de marketing, uma porcentagem muito pequena dos usuários do WhatsApp não recebe mensagens com template de marketing de nenhuma empresa, a menos que uma janela de atendimento ou de ponto de entrada gratuito esteja aberta com essa empresa. Quando você envia um template de marketing para esse usuário, o WhatsApp não o envia e não cobra você. Um webhook de status chega com status definido como failed e código de erro 130472. ### Como alcançar um cliente que aciona o erro 130472? Fazendo com que ele envie uma mensagem primeiro, o que abre uma janela de atendimento. A página de experimentos da Meta afirma claramente que repetir o envio do template resulta no mesmo erro. O caminho sugerido é entrar em contato com o usuário por outro canal, que não seja o WhatsApp, e pedir que ele envie uma mensagem para você. Assim, o template poderá ser enviado dentro de uma janela de atendimento aberta. O experimento é limitado a templates de marketing. Ele se aplica aos usuários do grupo, independentemente da empresa que envia a mensagem. Portanto, nada na sua conta, no template ou no número causou o erro, e alterar qualquer um deles também não ajuda. ### Como uma integração deve lidar com o erro 130472? Como um estado final dessa mensagem, e não como uma falha que deve ser repetida. Como o erro chega pelo webhook de status, e não apenas na resposta de envio, o tratamento deve ficar no processador de webhook. Marque a mensagem como retida pelo experimento, não coloque uma nova tentativa na fila e mantenha-a fora dos alertas de taxa de falhas, para que isso não pareça um problema de entregabilidade. Também vale separar esse caso nos relatórios. Uma campanha com alguns resultados 130472 não perdeu qualidade ou alcance por algo que você fez, e contabilizá-los junto com falhas reais dificulta a leitura dos números. - Reenviar o template. A Meta informa que repetir o envio retorna o mesmo erro. - Tratar isso como um problema de qualidade. O experimento se aplica igualmente a um grupo de usuários de todas as empresas. - Observar apenas a resposta de envio. O status 130472 chega pelo webhook de mensagens. **Sou cobrado por uma mensagem bloqueada com 130472?** Não. A página de experimentos da Meta informa que a mensagem não é enviada e não há cobrança por ela. **Posso tirar minha empresa do experimento?** Não. A Meta informa que não há exceções nem opções para sair da lista, e o experimento não tem data fixa para terminar. **O erro 130472 afeta templates de utilidade?** A Meta descreve o experimento como abrangendo mensagens com templates de marketing. Ela não lista outras categorias. **Como ainda posso entregar a mensagem?** Peça ao cliente, por outro canal, que envie uma mensagem para você. Dentro da janela de atendimento aberta, o template poderá ser enviado. --- ## Erro 131005 do WhatsApp: acesso negado, permissão ausente https://easycoexistence.com/pt/docs/whatsapp-error-131005 O erro 131005 indica que o token de acesso não tem uma permissão exigida pelo endpoint do WhatsApp, porque ela nunca foi concedida ou foi removida depois. A descrição da Meta é "Permission is either not granted or has been removed." Para corrigir, inspecione o token com o depurador de token de acesso e conceda a permissão ausente ou troque por um token que a tenha. ### O que significa o erro 131005 do WhatsApp? Isso significa que o token é aceito como legítimo, mas não tem a permissão verificada pelo endpoint. A referência da Cloud API da Meta lista o 131005 com o texto detalhado "Permission is either not granted or has been removed." O erro 10 da Graph API traz a mesma frase. A diferença está apenas na faixa: 10 é um código genérico da Graph API, enquanto 131005 pertence aos códigos do WhatsApp que começam com 131. Como as palavras são iguais, o diagnóstico também é. Para ambos, a Meta recomenda usar o depurador de token de acesso e confirmar que o app tem as permissões exigidas pelo endpoint. ### Qual permissão geralmente está faltando? Geralmente, uma das duas permissões do WhatsApp. Qual delas depende do que a chamada faz. O guia de permissões da Meta separa as permissões por função. whatsapp_business_messaging é necessária para enviar qualquer tipo de mensagem e receber webhooks de mensagens e status. whatsapp_business_management é necessária para metadados da conta, gerenciamento de templates, listagem de números de telefone, análises e webhooks da conta. Um token gerado apenas com a permissão de gerenciamento pode ler a conta e listar templates, mas falha assim que tenta enviar uma mensagem. Ao gerar um token de usuário do sistema, o guia de token de acesso da Meta orienta atribuir business_management, whatsapp_business_management e whatsapp_business_messaging em conjunto. ### Como corrigir o erro 131005? Leia o token primeiro e altere apenas o que estiver faltando. Chame o endpoint debug_token ou cole o token no depurador de token 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 uma permissão estiver ausente, gere um novo token que a inclua ou peça ao proprietário da empresa para concedê-la novamente, caso o token venha de um fluxo de parceiro. Se todas as permissões estiverem presentes e o erro continuar, verifique se o usuário do sistema por trás do token recebeu acesso à conta específica do WhatsApp Business. Um token pode ter todos os escopos necessários e ainda não estar atribuído a esse ativo. - Presumir que o token expirou. A expiração retorna 190 ou 0. Este código significa que o token funciona, mas não tem uma permissão. - Gerar um token apenas com a permissão de gerenciamento e usá-lo para enviar mensagens. O envio exige whatsapp_business_messaging. - Verificar os escopos e parar por aí. Um usuário do sistema também precisa receber acesso à conta específica do WhatsApp Business. **O 131005 é o mesmo erro que o 10?** Eles têm a mesma descrição na referência da Meta. O 131005 pertence à faixa do WhatsApp, e o 10, à faixa da Graph API. **Uma permissão pode ser removida depois da configuração?** Sim. A descrição da Meta cobre explicitamente permissões removidas, não apenas as que nunca foram concedidas. **O erro 131005 afeta o app do WhatsApp Business no celular?** Não. Ele diz respeito ao token da API. O app no celular continua funcionando normalmente. **Devo repetir a requisição após o erro 131005?** Não. Repetir com o mesmo token produz o mesmo resultado. Corrija a permissão primeiro. --- ## Erro 131037 do WhatsApp: o número 555 não tem nome de exibição aprovado https://easycoexistence.com/pt/docs/whatsapp-error-131037 O erro 131037 indica que a mensagem foi enviada por um número comercial 555 cujo nome de exibição não foi aprovado. A descrição da Meta é "The 555 business phone number used to send the request does not have an approved display name." Um número 555 não pode enviar mensagens até que a Meta aprove seu nome de exibição. Portanto, a correção é alterá-lo. ### O que é um número comercial 555? É um número oferecido pela Meta por meio do Embedded Signup para empresas elegíveis. A visão geral do Embedded Signup da Meta informa que clientes empresariais podem reivindicar até dois números 555. Eles usam o código de país +1 dos Estados Unidos com um código de área 555, são verificados automaticamente e não podem ser migrados para outra WhatsApp Business Account nem usados fora da WhatsApp Business Platform. Fora isso, funcionam como números comerciais padrão, sujeitos às regras de preços e às classificações de qualidade, com uma condição adicional que explica este erro: um número 555 precisa ter o nome de exibição aprovado antes de poder enviar mensagens. ### Como corrigir o erro 131037? Obtenha a aprovação do nome de exibição. Na prática, isso significa alterá-lo para um nome que passe pela análise. A solução indicada pela Meta é alterar o nome de exibição do número 555. Ela também direciona para o artigo da Central de Ajuda sobre como alterar o nome de exibição do WhatsApp Business. No WhatsApp Manager, acesse Account tools, Phone numbers, a aba Profile do número e depois Edit na seção Display name. Siga as diretrizes de nome de exibição da Meta, pois um nome rejeitado deixa você na mesma situação. O guia de nomes de exibição da Meta acrescenta que, depois da aprovação da alteração, você tem 14 dias para registrar novamente o número. Fazer o novo registro antes da aprovação não tem efeito. ### Como verificar se o nome de exibição foi aprovado? Solicite o campo name_status no phone number ID. O guia de nomes de exibição da Meta informa que o campo verified_name contém apenas a string do nome enviada para análise e não mostra se ela foi aprovada. O campo name_status mostra isso. Um webhook phone_number_name_update também informa a decisão, com decision definido como APPROVED ou REJECTED. Quando um nome é rejeitado, name_status fica definido como DECLINED. A Meta orienta revisar as diretrizes e editar o nome, ou abrir um recurso pelo suporte para desenvolvedores. Até que o status mude, todo envio desse número 555 continuará retornando 131037. - Interpretar verified_name como aprovação. A Meta informa que apenas name_status mostra se o nome foi aprovado. - Registrar novamente o número antes da aprovação. Segundo a Meta, isso não tem efeito até que o novo nome seja aprovado. - Alterar o nome repetidamente sem ler as diretrizes. A Meta permite 10 alterações a cada 30 dias. **O erro 131037 afeta números comerciais comuns?** Não. A descrição da Meta se refere especificamente a um número comercial 555 sem nome de exibição aprovado. **Posso mover um número 555 para outra conta?** Não. A Meta informa que números 555 não podem ser migrados para outra WhatsApp Business Account. **Como saberei quando o nome for aprovado?** Um webhook phone_number_name_update chegará com decision definido como APPROVED, e name_status se tornará APPROVED. **E se o nome de exibição for rejeitado?** Edite-o de acordo com as diretrizes de nome de exibição da Meta ou abra um recurso pelo suporte para desenvolvedores. --- ## Erro 131057 do WhatsApp: conta empresarial em manutenção https://easycoexistence.com/pt/docs/whatsapp-error-131057 O erro 131057 indica que a conta do WhatsApp Business está em modo de manutenção, por isso as requisições são recusadas por um curto período. A descrição da Meta é "Business Account is in maintenance mode." Uma causa indicada pela Meta é uma atualização de throughput, que leva até um minuto. Aguarde e repita a requisição sem alterar nada nela. ### O que significa o erro 131057 do WhatsApp? Isso significa que a Meta colocou a conta do WhatsApp Business em modo de manutenção e não está aceitando requisições para ela naquele momento. A referência da Cloud API lista o texto de detalhes "Business Account is in maintenance mode" e explica que uma causa possível pode ser uma atualização de throughput na conta. A expressão causa possível é importante: a Meta cita a atualização como uma causa possível, não como a única. Não há nada de errado na requisição. Espera-se que a mesma chamada, enviada sem alterações depois do fim da manutenção, funcione. Por isso, este é um dos poucos códigos em que esperar é toda a correção necessária. ### Por que uma atualização de throughput causa o erro 131057? Porque o número fica brevemente indisponível enquanto é transferido para a taxa mais alta. O guia de throughput da Meta informa que a Cloud API aceita até 80 mensagens por segundo por padrão e até 1.000 por atualização automática. O processo de atualização pode levar até um minuto. Nesse período, o número não pode ser usado na plataforma e qualquer requisição da API retorna 131057. Depois da primeira atualização, os aumentos seguintes ocorrem sem indisponibilidade. O guia lista as condições de elegibilidade: limite de mensagens ilimitado no Portfólio de Negócios, pelo menos 100 mil usuários únicos contatados fora de uma janela de atendimento em um período móvel de 24 horas e classificação de qualidade Média ou superior. ### O erro 131057 se aplica a um número de Coexistência? Ele pode aparecer em qualquer número, mas a explicação de throughput se aplica menos aos números de Coexistência. O guia de throughput da Meta informa que números usados com o app do WhatsApp Business e a Cloud API têm throughput fixo de 20 mensagens por segundo, para permanecerem compatíveis com o app. A atualização automática para 1.000 descrita no mesmo guia se aplica a números no nível padrão. Portanto, em um número de Coexistência, interprete o 131057 pelo significado literal, uma conta em modo de manutenção, e aguarde antes de repetir a requisição. Se persistir por muito mais que alguns minutos, entre em contato com o suporte da Meta usando o fbtrace_id da resposta, em vez de reconectar o número. - Editar a requisição. A requisição é válida, então alterá-la não ajudará enquanto a conta estiver em manutenção. - Repetir sem esperar. Durante uma atualização, toda chamada feita nesse minuto retorna o mesmo código. - Reconectar o número. O modo de manutenção está do lado da Meta e termina sem qualquer ação da empresa. **Quanto tempo dura o modo de manutenção?** A Meta informa que uma atualização de throughput leva até um minuto. Ela não publica uma duração para outras causas de manutenção. **Serei avisado quando a atualização terminar?** Sim. A Meta envia um webhook phone_number_quality_update com o evento definido como THROUGHPUT_UPGRADE quando o número é atualizado. **Um throughput maior custa mais?** Não. O guia de throughput da Meta informa que a atualização é gratuita e não afeta os preços. **O erro 131057 está relacionado ao 130429?** Indiretamente. O 130429 significa que você enviou mensagens mais rápido do que o throughput permite. O 131057 pode aparecer enquanto esse throughput está sendo aumentado. --- ## Erro 132005 do WhatsApp: texto traduzido longo demais https://easycoexistence.com/pt/docs/whatsapp-error-132005 O erro 132005 indica que o texto do template enviado é longo demais na tradução usada. A descrição da Meta é "Translated text is too long." A orientação da Meta é conferir no WhatsApp Manager se o template foi traduzido e depois revisar o status do template. O texto do corpo do template tem no máximo 1.024 caracteres, e o texto do rodapé, 60. ### O que significa o erro 132005 do WhatsApp? Isso significa que o envio de um template falhou porque o texto, na versão do idioma enviada, excede o limite permitido pela plataforma. A Meta lista o 132005 entre os erros de template, com o texto de detalhes "Translated text is too long." A orientação é conferir no WhatsApp Manager se o template foi traduzido e consultar a documentação de qualidade de templates para saber como verificar o status do template. A palavra translated é a pista. Existe uma versão do template por idioma, e a versão que falha corresponde ao código de idioma na sua requisição de envio. Ela pode não ser a versão que você escreveu e conferiu primeiro. ### Como corrigir o erro 132005? Abra o template no WhatsApp Manager e confira o idioma que você está enviando. Confirme se existe uma tradução para o código de idioma da requisição e se o status dela permite o envio. Depois, confira o tamanho usando os limites de componentes da Meta: o texto do corpo tem no máximo 1.024 caracteres, e o texto do rodapé tem no máximo 60. As traduções costumam ficar mais longas que o original, então um template que cabe em um idioma pode exceder o limite em outro. Se uma tradução for longa demais, reduza essa versão no WhatsApp Manager. Enviar o mesmo template no mesmo idioma sem editá-lo falhará da mesma forma. ### Como evitar o erro 132005 em templates multilíngues? Confira cada versão de idioma de acordo com os limites antes de enviá-la, não apenas a primeira. Uma verificação simples de tamanho na ferramenta usada para criar seus templates evita a maioria dos casos: conte os caracteres do corpo e do rodapé de cada tradução e compare com 1.024 e 60. Deixe uma margem no corpo quando houver variáveis, porque os valores preenchidos no momento do envio fazem parte da mensagem recebida pelo cliente. Mantenha o código de idioma da lógica de envio vinculado a traduções que realmente existem. Uma requisição para um idioma que o template não possui é um erro diferente, o 132001, e separar os dois facilita a leitura dos logs. - Conferir apenas o idioma original. A versão que falha é a tradução correspondente ao código de idioma da requisição. - Reenviar sem editar. O tamanho do texto não muda entre as tentativas. - Confundir com o 132001. Esse código significa que o template não existe nesse idioma ou não foi aprovado. **O erro 132005 é causado pelas minhas variáveis?** A descrição da Meta se refere ao texto traduzido longo demais. Confira primeiro o tamanho da tradução, incluindo espaço para os valores das variáveis. **Qual é o limite do corpo do template?** A referência de componentes de template da Meta define o máximo de 1.024 caracteres para o texto do corpo. **Onde confiro a tradução?** No WhatsApp Manager, dentro do template, na versão de idioma correspondente à sua requisição. **O erro 132005 é igual ao 132001?** Não. A Meta descreve o 132001 como um template que não existe no idioma especificado ou não foi aprovado. --- ## Erro 133000 do WhatsApp: tentativa anterior de desregistro falhou https://easycoexistence.com/pt/docs/whatsapp-error-133000 O erro 133000 indica que uma tentativa anterior de desregistrar o número de telefone falhou, portanto o número não pode ser registrado até que isso seja resolvido. A descrição da Meta é "A previous deregistration attempt failed." A correção indicada pela Meta é desregistrar o número novamente e depois registrá-lo. Ambos os endpoints são limitados a 10 requisições por número em uma janela móvel de 72 horas. ### O que significa o erro 133000 do WhatsApp? Isso significa que a plataforma ainda registra um desregistro não concluído para esse número e não fará um novo registro sobre ele. A Meta lista o código 133000 com o texto de detalhes "A previous deregistration attempt failed" e uma solução em uma linha: desregistrar o número novamente antes de registrá-lo. Por isso, o erro geralmente aparece em uma chamada de registro, embora a causa esteja em uma chamada de desregistro anterior. O desregistro é feito com um POST para o endpoint de desregistro do ID do número de telefone. O guia de registro da Meta alerta que isso torna o número inutilizável com a Cloud API até que seja registrado novamente e que não exclui o número nem o histórico de mensagens. ### Como corrigir o erro 133000? Repita o desregistro, confirme que ele foi concluído com sucesso e depois registre o número. Uma chamada de desregistro bem-sucedida retorna success definido como true. Somente depois dessa resposta a chamada de registro deve ser feita, com o campo messaging_product e o PIN de verificação em duas etapas de seis dígitos do número. A chamada de desregistro exige a permissão whatsapp_business_management. O guia de registro da Meta informa que uma requisição de desregistro sem essa permissão retorna o erro 200, que pode ser confundido com uma segunda falha do mesmo tipo. Se a própria chamada de desregistro continuar falhando, leia o valor details em cada resposta antes de enviar outra, pois toda tentativa conta para o limite descrito abaixo. ### Por que o limite de tentativas é importante neste caso? Porque corrigir esse erro exige uma sequência de tentativas, e a Meta limita essa sequência. O guia de registro limita os endpoints de registro e desregistro a 10 requisições por número comercial em uma janela móvel de 72 horas. Exceder esse limite retorna o erro 133016, e o número fica bloqueado para essa operação pelas 72 horas seguintes. Um script que repete chamadas de desregistro e registro após uma falha pode consumir a cota em segundos e deixar o número inutilizável por três dias. Faça cada tentativa de forma deliberada, registre a resposta e pare para investigar depois de duas ou três falhas, em vez de continuar automaticamente. - Tentar registrar novamente sem fazer o desregistro primeiro. A solução da Meta exige que o desregistro seja concluído antes do registro. - Repetir automaticamente chamadas de registro e desregistro. O limite é de 10 requisições em 72 horas, e excedê-lo bloqueia o número. - Fazer o desregistro sem whatsapp_business_management. Isso retorna o erro 200 e oculta o estado real do número. **Desregistrar exclui meu número?** Não. O guia de registro da Meta informa que o desregistro não exclui o número nem o histórico de mensagens. **Posso desregistrar um número de Coexistência com a API?** Não. A Meta informa que o endpoint de desregistro não pode ser usado em um número utilizado simultaneamente com a Cloud API e o app do WhatsApp Business. **O que acontece depois de 10 tentativas?** A API retorna 133016 e bloqueia o número para essa operação pelas 72 horas seguintes. **Preciso do PIN para registrar novamente?** Sim. Quando a verificação em duas etapas está ativada, o registro usa o PIN de seis dígitos do número. --- ## Erro 133004 do WhatsApp: servidor temporariamente indisponível https://easycoexistence.com/pt/docs/whatsapp-error-133004 O erro 133004 indica que o servidor que processava a requisição estava temporariamente indisponível. A descrição da Meta é "Server is temporarily unavailable." A requisição não é a causa. A orientação da Meta é consultar a página de status da WhatsApp Business Platform e ler o valor details na resposta antes de tentar de novo. Depois, repita com um intervalo. ### O que significa o erro 133004 do WhatsApp? Isso significa que a plataforma não conseguiu processar a requisição naquele momento porque um servidor estava indisponível. A Meta lista o 133004 na referência de erros da Cloud API, com o texto details "Server is temporarily unavailable." A palavra temporariamente é a parte principal. O token de acesso, o número e a mensagem não estão sendo rejeitados, e a mesma requisição pode funcionar pouco depois. Ele aparece entre os códigos 133, a maioria relacionada ao registro e cancelamento do registro de números de telefone, por isso é comum encontrá-lo durante uma chamada de registro. A Meta não o limita ao registro, porém, então trate-o como uma condição do servidor onde quer que apareça. ### O que devo verificar antes de repetir? Duas coisas, ambas citadas na própria orientação da Meta. Primeiro, a página de status da WhatsApp Business Platform em metastatus.com. Se a Meta estiver informando um incidente, repetir não resolverá até que ele seja encerrado, e a página oferece uma resposta mais rápida que seus próprios logs. 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, às vezes com orientação sobre o que fazer. Para este código, a Meta diz especificamente para consultá-lo antes de tentar de novo. Se a página de status estiver normal e details não indicar um tempo de espera, repita com um intervalo crescente, em vez de fazê-lo imediatamente. ### Como o 133004 difere de outros erros temporários? A Meta lista vários códigos que descrevem algo brevemente indisponível, e vale mantê-los separados nos logs. O código 1 é descrito como uma requisição inválida ou um possível erro do servidor, o código 2 como uma indisponibilidade temporária causada por interrupção ou sobrecarga, e o 131016 como um serviço temporariamente indisponível. O 133004 identifica especificamente um servidor. O tratamento é semelhante em todos: confirme o status da plataforma, leia o valor details e aguarde antes de repetir. Registrar o código exato ainda importa, porque um grupo de ocorrências do mesmo código em determinado horário fornece à equipe de suporte da Meta muito mais informação do que uma anotação genérica de que a API caiu. - Repetir instantaneamente em um loop apertado. Um servidor fora do ar continuará fora do ar no milissegundo seguinte. - Ignorar o valor details. A Meta orienta lê-lo antes de repetir, e ele pode trazer o motivo. - Alterar a requisição para contornar o problema. Nada na requisição causou o erro. **O erro 133004 é culpa minha?** Não. A Meta o descreve como um servidor temporariamente indisponível. A requisição não causou o erro. **Onde fica a página de status da WhatsApp Business Platform?** A Meta direciona para metastatus.com/whatsapp-business-api na referência de códigos de erro. **Quanto tempo devo esperar antes de repetir?** A Meta não informa um tempo fixo. Consulte o valor details e a página de status, depois repita com um intervalo crescente. **O que devo enviar ao suporte da Meta se o problema persistir?** O fbtrace_id da resposta de erro, que, segundo a Meta, pode ajudar a investigar o problema. --- ## Erro 133009 do WhatsApp: PIN da verificação em duas etapas inserido rápido demais https://easycoexistence.com/pt/docs/whatsapp-error-133009 O erro 133009 indica que as tentativas do PIN da verificação em duas etapas chegaram à Meta mais rápido do que ela 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 novamente e envie a próxima tentativa somente depois que o tempo indicado tiver passado. ### O que significa o erro 133009 do WhatsApp? Isso significa que as tentativas de PIN para esse número estão chegando muito próximas umas das outras, e a Meta recusa a última sem avaliá-la. A referência da Cloud API fornece ao 133009 o texto de details "Two-step verification PIN was entered too quickly" e uma instrução: confira o valor de details na resposta antes de tentar novamente. Esse erro fica entre dois códigos próximos. O 133005 indica que o PIN estava incorreto. O 133008 indica que houve tentativas demais de PIN para o número. O 133009 trata apenas da velocidade, por isso aparece quando um processo envia tentativas de PIN em sequência rápida, como um loop de repetição em uma chamada de registro. ### Como corrigir o erro 133009? Diminua o ritmo e pare de adivinhar. Leia o valor de details em error_data antes da próxima tentativa. A referência da Meta descreve details como o motivo mais provável do erro e, para esse código, é a primeira coisa que ela orienta verificar. Depois, confirme que a próxima tentativa usa um PIN que alguém realmente conhece. Se ninguém souber, o guia de verificação em duas etapas da Meta descreve uma redefinição no WhatsApp Manager: abra as configurações do número de telefone, escolha Two-step verification e clique em Change PIN. Um PIN novo e conhecido é mais rápido do que uma série de tentativas que termina em 133008 e em uma espera mais longa. ### Onde o PIN é usado? Ao registrar o número na Cloud API e em algumas operações de conta relacionadas. O guia de verificação em duas etapas da Meta informa que a configuração exige um PIN de seis dígitos ao registrar o número de telefone, e que a chamada de registro recebe o PIN como campo obrigatório quando a verificação em duas etapas está ativada. O guia de números de telefone da Meta acrescenta que o PIN é necessário para alterá-lo ou excluir o número da plataforma. Como ele é necessário raramente, é fácil esquecê-lo. Armazene-o com as outras credenciais da conta da empresa, não com a pessoa que configurou o número inicialmente. - Repetir imediatamente a chamada de registro em um loop. Tentativas rápidas de PIN são exatamente o que esse código informa. - Adivinhar PINs diferentes entre as tentativas. Tentativas demais levam você do 133009 ao 133008. - Ignorar o valor de details. A Meta o identifica como aquilo que deve ser verificado antes de tentar novamente. **O erro 133009 significa que meu PIN está errado?** Não necessariamente. Significa que as tentativas chegaram rápido demais. Um PIN incorreto é informado 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 novamente. **Posso desativar a verificação em duas etapas por API?** Não. O guia de verificação em duas etapas da Meta informa que não há endpoint para desativá-la. Você pode definir um novo PIN. **Como redefinir um PIN esquecido?** No WhatsApp Manager, abra as configurações do número de telefone, escolha Two-step verification e clique em Change PIN. --- ## Erro 133015 do WhatsApp: número excluído recentemente, exclusão incompleta https://easycoexistence.com/pt/docs/whatsapp-error-133015 O erro 133015 indica que o número de telefone em registro foi excluído recentemente e essa exclusã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 correção documentada é aguardar 5 minutos antes de repetir a requisição de registro. ### O que significa o erro 133015 do WhatsApp? Significa que uma requisição de registro chegou enquanto o mesmo número ainda estava sendo excluído. A referência da Meta traz o texto completo: "The phone number you are attempting to register was recently deleted, and deletion has not yet completed." A solução também é específica: aguarde 5 minutos antes de repetir a requisição. O caminho mais comum é mover um número. Alguém o exclui de uma WhatsApp Business Account e o registra imediatamente em outra, ou o exclui e adiciona de novo para recomeçar. A segunda etapa chega à Meta antes que a primeira termine em segundo plano. ### Como um número de telefone comercial é excluído? Somente no WhatsApp Manager e apenas por um administrador do portfólio comercial. O guia de números de telefone da Meta informa que um número de telefone comercial não pode ser excluído pela API. A exclusão é feita no WhatsApp Manager. Um número com status Connected precisa do PIN de verificação em duas etapas para ser excluído, e um número que enviou mensagens pagas nos últimos 30 dias não pode ser excluído até que se passem 30 dias desde a última mensagem. Exclusão é diferente de desregistro. O guia de registro da Meta diz que o desregistro apenas torna o número inutilizável com a Cloud API e não exclui o número nem seu histórico de mensagens. O erro 133015 trata especificamente da exclusão. ### Como evitar o erro 133015 ao mover um número? Inclua a espera no procedimento, em vez de descobrir o problema depois. Após excluir o número, aguarde pelo menos 5 minutos antes da chamada ao endpoint de registro. Se a chamada ainda retornar 133015, aguarde novamente em vez de repetir imediatamente. O motivo para ter paciência é o limite de registro. A Meta permite 10 requisições ao endpoint de registro por número em uma janela móvel de 72 horas. Quando esse limite é excedido, a API retorna 133016 e bloqueia o registro pelas próximas 72 horas. Um loop de repetição que faça chamadas a cada poucos segundos diante de 133015 pode esgotar essas dez tentativas antes mesmo de a exclusão terminar. - Repetir a chamada de registro a cada poucos segundos. Cada chamada conta para o limite de 10 em 72 horas. - Confundir exclusão com desregistro. O desregistro não exclui o número, e este código trata de exclusão. - Tentar excluir o número pela API. A Meta só permite a exclusão no WhatsApp Manager. **Quanto tempo devo aguardar após o erro 133015?** A Meta orienta aguardar 5 minutos antes de repetir a requisição de registro. **Posso excluir um número de telefone comercial pela API?** Não. O guia de números de telefone da Meta informa que a exclusão só é possível no WhatsApp Manager. **Por que não consigo excluir meu número?** A Meta bloqueia a exclusão de um número que enviou mensagens pagas nos últimos 30 dias. Você poderá excluí-lo 30 dias após a última mensagem. **O que acontece se eu repetir muitas vezes?** Após 10 requisições de registro em 72 horas, a API retorna 133016 e bloqueia o registro por 72 horas. --- ## Erro 135000 do WhatsApp: erro desconhecido nos parâmetros da requisição https://easycoexistence.com/pt/docs/whatsapp-error-135000 O erro 135000 indica que uma mensagem não foi enviada devido a um erro desconhecido nos parâmetros da requisição. A descrição da Meta é "Message failed to send because of an unknown error with your request parameters." A orientação da Meta é consultar a referência do endpoint para verificar a sintaxe correta e contatar o suporte ao cliente se o erro continuar ocorrendo. ### O que significa o erro 135000 do WhatsApp? Isso significa que a plataforma não conseguiu enviar a mensagem, não informou exatamente o motivo e ainda assim associou o problema aos parâmetros da sua requisição. Na referência da Meta, o código 135000 apresenta o texto detalhado "Message failed to send because of an unknown error with your request parameters." A solução é consultar a referência do endpoint para verificar se você está fazendo a chamada com a sintaxe correta e contatar o suporte ao cliente se continuar recebendo o código. Isso o diferencia do código 131000, que a Meta descreve como um erro desconhecido sem apontar para os parâmetros e cuja solução começa por repetir a operação. ### Como encontrar o parâmetro incorreto? Compare o corpo exato da requisição enviada com a referência do endpoint, campo por campo. Registre o payload completo junto com o erro, pois o valor que causou o problema costuma ser algo que varia por mensagem: um número de telefone em formato inesperado, uma string vazia onde era esperado texto ou um objeto aninhado com um campo no local 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 funcionar depois de uma alteração, mantenha as duas versões. A diferença é a resposta e mostra o que deve ser validado antes do próximo envio. ### Quando contatar o suporte da Meta sobre o erro 135000? Quando a requisição corresponder à referência e o código continuar retornando. A Meta indica o suporte como próximo passo para um 135000 persistente. Inclua o fbtrace_id da resposta de erro, que, segundo a Meta, pode ajudar a investigar o erro, além do horário, do endpoint e do corpo da requisição sem as credenciais. Antes de abrir um chamado, confirme que a mesma requisição falha de forma consistente. Uma requisição que falha uma vez e funciona sem alterações um minuto depois aponta para a plataforma, não para os parâmetros, e a página de status da WhatsApp Business Platform é o local mais rápido para confirmar isso. - Repetir várias vezes a mesma requisição idêntica. A Meta associa o problema aos parâmetros, então o mesmo payload tende a falhar da mesma forma. - Registrar apenas o erro. Sem o corpo da requisição, não é possível encontrar o parâmetro incorreto. - Contatar o suporte sem o fbtrace_id. A Meta o identifica como o ID que ajuda a investigar o erro. **O erro 135000 é igual ao 131000?** Não. O 131000 é um erro desconhecido sem causa informada. O 135000 é um erro desconhecido que a Meta atribui aos parâmetros da sua requisição. **O erro 135000 é igual ao erro 100?** Não. O erro 100 identifica parâmetros incompatíveis ou escritos incorretamente. O 135000 informa que os parâmetros causaram um erro que a Meta não consegue identificar. **Devo repetir a requisição após o erro 135000?** Não sem alterações. Primeiro confira a requisição na referência do endpoint. **O que devo enviar ao suporte da Meta?** O fbtrace_id da resposta, o endpoint, o horário e o corpo da requisição sem as credenciais. --- ## EasyCoexistence vs Z-API https://easycoexistence.com/pt/compare/easycoexistence-vs-z-api A Z-API é uma API brasileira para WhatsApp, vendida por instância, que conecta um número por QR code, da mesma forma que o WhatsApp Web vincula um dispositivo. A EasyCoexistence conecta o número à Cloud API oficial da Meta por meio da Coexistência. Assim, o app do WhatsApp Business continua funcionando e a conexão não viola os termos do WhatsApp. ### Como cada uma chega ao WhatsApp Todo o restante desta página decorre dessa diferença, por isso ela vem primeiro. - Z-API:: A documentação diz que, assim como no WhatsApp Web, a conexão exige ler um QR code ou inserir um número de telefone. O próprio site descreve a Cloud API oficial como um caminho separado e a si mesma como uma alternativa de mercado a ela. - EasyCoexistence:: A Cloud API da Meta, com credenciais emitidas pela Meta para a própria Conta do WhatsApp Business da empresa, conectada pelo Embedded Signup da Meta. O número é registrado como número de API e o app do WhatsApp Business continua funcionando no mesmo celular. ### Quanto custa por número Ambas cobram por número, o que faz desta uma das poucas comparações em que as unidades são iguais. - Z-API:: R$ 99,99 por instância ao mês no plano Ultimate, ou R$ 89,99 por instância no plano Partner, com mínimo de dez instâncias, conforme publicado no site. O período de teste é de dois dias. - EasyCoexistence:: R$ 29,90 por número conectado ao mês para um a cinco números, diminuindo em seis faixas até R$ 4,90 por número conforme você adiciona números. Os três primeiros dias são grátis, e a Meta cobra diretamente da empresa pelas tarifas de mensagens, sem margem. ### O que acontece com o número se o WhatsApp agir Este é o risco que um preço por instância não mostra. - Z-API:: Uma sessão de dispositivo vinculado não é um caminho autorizado pelos termos comerciais do WhatsApp para mensagens comerciais automatizadas, e uma conta conectada dessa forma pode ser restringida ou banida. - EasyCoexistence:: A conexão é um recurso da própria Meta, feito pelo fluxo da própria Meta, por um Tech Provider independente da Meta. Não há nada na forma como o número se conecta que o WhatsApp possa punir. ### Manter o celular em uso A maioria das pequenas empresas em qualquer um dos produtos ainda responde aos clientes pelo celular, então isso define como será o dia. - Z-API:: A instância é uma sessão vinculada no sentido do WhatsApp Web, portanto dura apenas enquanto esse vínculo permanecer ativo. O site deles não menciona o recurso Coexistence da Meta. - EasyCoexistence:: A Coexistência é o produto inteiro. A equipe mantém o app do WhatsApp Business, a API funciona no mesmo número e a conexão é monitorada para que uma queda, como a regra de 14 dias da Meta, seja sinalizada assim que ocorrer. - Tratar uma instância vinculada por QR code e a Cloud API como o mesmo produto com preços diferentes. Elas chegam ao WhatsApp por caminhos distintos. - Usar o número principal da empresa em uma sessão de dispositivo vinculado. Um banimento leva consigo a presença do número no WhatsApp. - Esquecer que a Cloud API cobra pelos templates. A Meta cobra esses valores da empresa, fora de qualquer assinatura. **A Z-API é a API oficial do WhatsApp?** Não. O próprio site descreve a Cloud API oficial como o caminho pela Meta e a Z-API como uma alternativa de mercado, enquanto a documentação diz que uma instância se conecta como o WhatsApp Web. **Qual é mais barata?** Nós somos. A Z-API publica R$ 99,99 por instância ao mês. Cobramos R$ 29,90 por número conectado ao mês para até cinco números, caindo até R$ 4,90 conforme você adiciona números. **Preciso aprovar templates com vocês?** Somente para mensagens que iniciam uma conversa fora da janela de atendimento de 24 horas, regra da Meta para todo provedor oficial. As respostas dentro da janela são de texto livre. **Posso mover um número da Z-API para a EasyCoexistence?** Sim. Desvincule a sessão, continue usando o app do WhatsApp Business e conecte o número pelo Embedded Signup. É necessária a versão 2.24.17 ou posterior do app e atividade real recente. --- ## EasyCoexistence vs Blip https://easycoexistence.com/pt/compare/easycoexistence-vs-blip A Blip é uma plataforma brasileira de conversação para criar chatbots e atender clientes no WhatsApp e em outros canais, com planos pagos informados pela equipe comercial. A EasyCoexistence é a própria conexão do WhatsApp à Cloud API da Meta por meio da Coexistência, com valor publicado por número conectado e o app do WhatsApp Business funcionando no celular. ### O que é cada produto Ambos usam a API oficial da Meta. Eles vendem coisas diferentes sobre essa base. - Blip:: Uma plataforma para criar bots com fluxos personalizados e processamento de linguagem natural, além de uma central de atendimento humano, no WhatsApp, Instagram, Messenger e outros canais. A página de preços informa que a empresa é uma provedora oficial de soluções para negócios da Meta. - EasyCoexistence:: A conexão entre um número que a empresa já usa no app do WhatsApp Business e a Cloud API da Meta, além do monitoramento contínuo dessa conexão. As mensagens chegam ao sistema que a empresa já utiliza: um CRM, n8n, seu próprio código ou um agente de IA por meio do MCP. ### Quanto custa A diferença aqui é saber se o preço pode ser consultado antes de falar com alguém. - Blip:: Um plano gratuito para até dois agentes, com limite de conversas mensais. Os planos pagos não têm preço na página; o leitor é direcionado a uma etapa comercial para saber mais, então o valor vem de uma conversa com vendas. - EasyCoexistence:: US$ 9 por número conectado por mês para um a cinco números, caindo para US$ 1 por número conforme você adiciona números, com os três primeiros dias grátis. A Meta cobra as tarifas de mensagens na própria conta da empresa, sem margem. ### O celular continua funcionando Para uma pequena empresa que responde pelo celular, esta costuma ser a primeira dúvida. - Blip:: A página de preços não aborda a Coexistência. Pergunte se um número pode continuar no app do WhatsApp Business enquanto permanece conectado, em vez de depender desta página. - EasyCoexistence:: Sim, por definição. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, com o histórico recente de conversas sincronizado, enquanto a API funciona em paralelo. O throughput de um número com Coexistência é de 20 mensagens por segundo. ### Onde fica a lógica do bot A automação precisa rodar em algum lugar, e essa escolha define a que você ficará vinculado. - Blip:: Dentro da Blip. Fluxos, bots e a central de atendimento são criados e executados na plataforma, que é o produto vendido pela empresa. - EasyCoexistence:: Onde você já desenvolve. A Meta envia os webhooks das mensagens diretamente ao seu sistema, o conteúdo das conversas nunca é armazenado do nosso lado, e um servidor MCP permite que Claude, ChatGPT, Cursor ou Codex enviem mensagens pelo número. - Comparar linha a linha o orçamento de uma plataforma de bots com uma taxa de conexão. Um deles inclui o criador e a central de atendimento. - Supor que qualquer parceiro da Meta mantém o app do WhatsApp Business funcionando. A Coexistência precisa ser compatível e habilitada. - Esquecer as próprias tarifas de mensagens da Meta. Elas são cobradas pela Meta em qualquer um dos produtos. **A Blip publica seus preços?** Somente o plano gratuito, para até dois agentes e com conversas limitadas. Os planos pagos não têm preço na página de preços. **Uma é mais barata?** Nosso preço é publicado e o deles não, então o nosso é o que você pode consultar: US$ 9 por número conectado por mês, caindo para US$ 1 conforme você adiciona números, sem limite de agentes. **Posso criar um chatbot com a EasyCoexistence?** Sim, na ferramenta que você já usa. As mensagens chegam ao seu webhook, n8n, Make ou agente de IA por meio do MCP, e a lógica fica lá. **A EasyCoexistence é um produto da Meta?** Não. Somos um Tech Provider independente da Meta, usando o Embedded Signup e a Cloud API oficiais da Meta. --- ## EasyCoexistence vs Digisac https://easycoexistence.com/pt/compare/easycoexistence-vs-digisac A Digisac é uma plataforma brasileira de atendimento multicanal, com preço sob proposta personalizada a partir de R$ 197 por mês, que opera a API oficial do WhatsApp por meio da Gupshup e da 360dialog e oferece Coexistência por meio delas. A EasyCoexistence é uma Meta Tech Provider que conecta o próprio número, com valor publicado por número e sem plataforma intermediária. ### Como o preço é definido Um funciona por proposta e o outro por tabela, e isso molda todo o restante. - Digisac:: Não há planos fixos. A própria página informa que o preço inicial é R$ 197 e varia conforme o número de agentes, canais, recursos como módulos de IA e integrações, reunidos em uma proposta pela equipe comercial. - EasyCoexistence:: R$ 29,90 por número conectado ao mês para um a cinco números, caindo em seis faixas até R$ 4,90 por número conforme você adiciona números. Não há agentes para contar nem módulos para adicionar. Primeiros três dias grátis. ### Quem fica entre você e a Meta A cadeia de empresas por trás de um número define quem pode corrigi-lo quando algo dá errado. - Digisac:: A plataforma opera a API por meio da Gupshup e da 360dialog, que são parceiras da Meta. O artigo sobre Coexistência informa que a ativação ocorre com um provedor oficial, como a 360dialog, com a Digisac apoiando o cliente nesse processo. - EasyCoexistence:: Ninguém. Somos uma Meta Tech Provider independente, a empresa se cadastra pelo próprio Embedded Signup da Meta na sua própria conta do WhatsApp Business, e os webhooks da Meta vão diretamente para o sistema da empresa. ### Onde a equipe trabalha Uma plataforma de atendimento e uma conexão mudam coisas diferentes na rotina de trabalho. - Digisac:: Uma plataforma compartilhada de atendimento que centraliza WhatsApp, Instagram, Telegram, Messenger, e-mail e chat web, com distribuição de conversas, chat interno e funil de vendas. A equipe trabalha dentro dela. - EasyCoexistence:: Nada novo para acessar. A equipe mantém o app do WhatsApp Business, enquanto automações, um CRM ou um agente de IA atuam no mesmo número pela API. ### Quanto tempo até o número funcionar Pequenas empresas muitas vezes decidem isso sozinhas. - Digisac:: Primeiro vem a proposta comercial, depois a ativação com o provedor. A página lista CNPJ, Meta Business Manager e conformidade com as políticas entre os pré-requisitos. - EasyCoexistence:: Normalmente, menos de dois minutos pelo Embedded Signup: entre com o Facebook, informe o número e escaneie um código QR no app. O monitoramento começa assim que o número é conectado. - Comparar o preço inicial da Digisac com um valor por número. O preço deles cresce conforme agentes, canais e módulos. - Presumir que a Coexistência é um recurso da plataforma. Ela é da Meta e é habilitada por um provedor do lado da Meta. - Deixar as cobranças da Meta fora do orçamento. Elas são cobradas pela Meta em qualquer uma das opções. **A Digisac oferece suporte à Coexistência?** Sim. O próprio artigo informa que ela é ativada com um provedor oficial, como a 360dialog, com a Digisac apoiando o processo. **Uma é mais barata?** Para um único número, somos mais baratos: R$ 29,90 por mês contra um preço inicial de R$ 197 que aumenta conforme agentes, canais e módulos. O nosso cai conforme mais números são adicionados. **Perco uma caixa de entrada compartilhada com vocês?** Nós não vendemos uma. A equipe mantém o app do WhatsApp Business, e todo o restante funciona na ferramenta que você escolher. **Quem paga a Meta?** A empresa, diretamente, na própria conta do WhatsApp Business. Nunca aplicamos margem sobre uma cobrança da Meta. --- ## EasyCoexistence vs Octadesk https://easycoexistence.com/pt/compare/easycoexistence-vs-octadesk Octadesk é uma plataforma brasileira de atendimento ao cliente que combina chatbot, agentes de IA e helpdesk, com planos a partir de R$ 2.499 por mês para 3.000 conversas, além de uma consultoria obrigatória de integração. EasyCoexistence conecta o número que já está no app do WhatsApp Business à Cloud API da Meta por meio da Coexistência, com valor publicado por número, sem limite de conversas e sem configuração. ### Pelo que é a cobrança mensal As unidades são diferentes, e essa diferença cresce a cada cliente que envia uma mensagem. - Octadesk:: Um plano dimensionado por conversas: One por R$ 2.499 ao mês para 3.000, Flow por R$ 4.399 para 5.500 e Nexus sob consulta para 9.000. Usuários de helpdesk são cobrados à parte por usuário, e todo plano exige uma consultoria de integração com preço sob consulta. - EasyCoexistence:: Um valor por número conectado: R$ 29,90 ao mês para um a cinco números, caindo até R$ 4,90 por número conforme você adiciona números. Um mês com dez mil conversas custa o mesmo que um mês tranquilo. A Meta cobra diretamente suas próprias tarifas de mensagens. ### O que cada um é Ambos colocam o número na API oficial. O que é construído sobre ela é diferente. - Octadesk:: Um ecossistema de serviços: chatbot, agentes de IA, helpdesk com SLAs e histórico de tickets e envio em massa pelo WhatsApp, com um número oficial da API do WhatsApp incluído em cada plano. - EasyCoexistence:: A conexão e seu monitoramento. O número permanece no app do WhatsApp Business, a API funciona nele ao mesmo tempo e as mensagens chegam às ferramentas que a empresa já usa, incluindo agentes de IA por meio do nosso servidor MCP. ### Adicionar um segundo ou décimo número Agências e empresas com várias filiais perguntam isso antes de qualquer outra coisa. - Octadesk:: Cada plano informa um número oficial da API do WhatsApp como incluído. A página de preços deles não publica um valor para números adicionais. - EasyCoexistence:: Números ilimitados por conta, cada um pelo preço da faixa, e o valor por número diminui conforme a quantidade aumenta: R$ 24,90 a partir de seis números, chegando a R$ 4,90 conforme você adiciona números. ### Se o telefone continua funcionando Essa é a pergunta que decide se uma equipe pequena terá de mudar sua forma de trabalhar. - Octadesk:: A página de preços deles não aborda a Coexistência. Confirme com eles se o número pode permanecer no app do WhatsApp Business depois de ser colocado na API. - EasyCoexistence:: Sim. A Coexistência é tudo o que conectamos: o app mantém suas conversas, cerca de seis meses de histórico podem ser sincronizados e a API funciona no mesmo número. A conexão é monitorada para que uma queda seja sinalizada imediatamente. - Comparar preços de planos sem contar as conversas. Os planos da Octadesk têm limites; uma taxa de conexão não tem. - Fazer o orçamento sem incluir a consultoria de integração. A Octadesk exige isso em todos os planos e define o preço sob consulta. - Esperar que o plano cubra as tarifas de template da Meta. A Meta cobra esses valores diretamente da empresa. **Um é mais barato?** Sim, por uma ampla margem para uma empresa que precisa da conexão. A Octadesk começa em R$ 2.499 por mês mais a integração; cobramos R$ 29,90 por número conectado por mês. **O que acontece depois de 3.000 conversas?** No plano One da Octadesk, você passa para um plano superior. Conosco, nada muda: não há limite de conversas em nenhum preço. **A Octadesk oferece Coexistência?** A página de preços deles não informa. Pergunte diretamente a eles em vez de confiar nesta página. **Ainda posso usar IA com a EasyCoexistence?** Sim. Nosso servidor MCP permite que Claude, ChatGPT, Cursor, Claude Code e Codex enviem mensagens e templates pelo número. --- ## EasyCoexistence vs Huggy https://easycoexistence.com/pt/compare/easycoexistence-vs-huggy Huggy é uma caixa brasileira de atendimento omnicanal, com preço por plano e usuário conectado, enquanto o WhatsApp é cobrado separadamente por quantidade e categoria. EasyCoexistence é a própria conexão do WhatsApp: a Cloud API da Meta no número já usado no app do WhatsApp Business, por meio da Coexistência, com um valor publicado por número conectado. ### O que a cobrança mensal inclui A cobrança da Huggy cresce com a equipe. A nossa cresce apenas com os números. - Huggy:: Um plano com um usuário conectado, seguido de uma taxa por usuário adicional: R$ 69,90 no Starter, R$ 119,90 no Intermediate a partir de R$ 579 por mês e R$ 189,90 no Custom a partir de R$ 989. O WhatsApp é cobrado à parte, por quantidade e categoria, e a implementação é opcional por R$ 1.250. - EasyCoexistence:: R$ 29,90 por número conectado ao mês para um a cinco números, caindo até R$ 4,90 por número conforme você adiciona números, sem qualquer contagem de usuários. Três primeiros dias grátis, e a Meta cobra diretamente da empresa as tarifas de mensagens. ### O que cada produto é Uma caixa de entrada e uma conexão são compradas por motivos diferentes. - Huggy:: Uma caixa de atendimento que centraliza WhatsApp, Instagram, Messenger, Telegram, e-mail, 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 conexão entre o número do app do WhatsApp Business e a Cloud API da Meta, monitorada continuamente. As mensagens vão para o sistema que a empresa já usa, por meio dos webhooks da Meta ou do nosso servidor MCP. ### Se a equipe muda a forma de trabalhar A pergunta do proprietário antes de concordar com qualquer coisa. - Huggy:: Os agentes entram na caixa de entrada da Huggy, onde as conversas de todos os canais são distribuídas e respondidas. A página de preços deles não aborda a Coexistência com o app do WhatsApp Business. - EasyCoexistence:: Ninguém muda de lugar. O app do WhatsApp Business continua funcionando no mesmo número, com suas conversas, enquanto a API opera em paralelo para o que a empresa automatizar. ### Onde as conversas ficam Uma decisão difícil de reverter depois. - Huggy:: Na plataforma deles, que uma caixa de entrada precisa usar para exibir as conversas aos agentes que as acessam. - EasyCoexistence:: Não do nosso lado. O conteúdo das conversas nunca é armazenado, e a Meta pode encaminhar as mensagens recebidas diretamente para o webhook da própria empresa. - Comparar o preço da Huggy sem considerar a cobrança do WhatsApp. Ela é separada do plano, por quantidade e categoria. - Contar apenas a equipe de hoje. Cada usuário adicional acrescenta uma taxa mensal ao plano da caixa de entrada. - Comprar uma caixa de entrada para obter acesso à API em um número. Para isso, basta a conexão. **Um é mais barato?** Para uma empresa que precisa da conexão, somos nós. O plano Intermediate da Huggy começa em R$ 579 por mês para um usuário, antes do WhatsApp; o nosso custa R$ 29,90 por número conectado ao mês. **A Huggy usa a API oficial?** A página de preços deles diz que são parceiros oficiais da Meta e ativam a API oficial da Meta. **A Huggy oferece Coexistência?** A página de preços deles não aborda isso. Pergunte diretamente a eles em vez de confiar nesta página. **Vocês têm uma caixa de entrada?** Não. A equipe continua usando o app do WhatsApp Business, que é justamente para isso que serve a Coexistência. --- ## EasyCoexistence vs Umbler Talk https://easycoexistence.com/pt/compare/easycoexistence-vs-umbler-talk Umbler Talk é uma caixa de entrada, CRM e chatbot brasileiro do WhatsApp na API oficial, com preço por agente a partir de R$ 99,90 por mês e mínimo de dois agentes. A EasyCoexistence conecta o número que já está no app do WhatsApp Business à Cloud API da Meta por meio da Coexistência, com cobrança por número conectado. Assim, o valor nunca depende de quantas pessoas respondem. ### Para que serve a cobrança mensal A Umbler Talk conta pessoas. A EasyCoexistence conta números. - Umbler Talk:: Por agente ao mês: R$ 99,90 no Essencial com pelo menos dois agentes, R$ 149,90 no Impulso e R$ 219,90 no Escala com pelo menos três. A menor cobrança possível é de dois agentes no Essencial, R$ 199,80 por mês. - EasyCoexistence:: R$ 29,90 por número conectado ao mês para um a cinco números, caindo em seis faixas até R$ 4,90 por número conforme você adiciona números. Sem contagem mínima de agentes. Os três primeiros dias são grátis, e a Meta cobra o envio de mensagens diretamente. ### O que é cada produto Ambos usam a API oficial da Meta, como a Umbler Talk declara claramente em sua página. - Umbler Talk:: Uma caixa de entrada compartilhada com pipeline visual de CRM, chatbot, agentes de IA, base de conhecimento e webchat, além de campanhas no WhatsApp nos planos mais altos. A equipe trabalha dentro dela. - EasyCoexistence:: A conexão e seu monitoramento. O número permanece no app do WhatsApp Business, a API funciona nele ao mesmo tempo e as mensagens chegam ao seu CRM, n8n, código próprio ou agente de IA por meio do MCP. ### Quantos números cabem Para agências e empresas com várias filiais, o limite de números importa mais que o nome do plano. - Umbler Talk:: Dois números do WhatsApp no Essencial e até três no Impulso, com o Escala descrito como tendo limite dinâmico de números. Mais números significam um plano mais caro para cada agente. - EasyCoexistence:: Números ilimitados por conta, cada um pelo preço da faixa, e o preço por número cai conforme a quantidade aumenta. O vigésimo número custa menos que o primeiro. ### Se o app do WhatsApp Business continua funcionando É a pergunta que uma equipe pequena faz antes de qualquer outra. - Umbler Talk:: A página de planos não menciona a Coexistência. Pergunte se um número continua funcionando no app do WhatsApp Business depois de conectado. - EasyCoexistence:: Sim. A Coexistência é a única coisa que conectamos, então o app mantém suas conversas e a API funciona ao lado dele, com a conexão monitorada para quedas causadas por regras como a de 14 dias da Meta. - Interpretar o preço por agente como o valor total. O mínimo é de dois agentes, e os planos mais altos exigem mais. - Escolher um plano pelo limite de números e, por consequência, pagar a tarifa mais alta para cada agente. - Deixar as cobranças de template da Meta fora do orçamento. A Meta cobra esses valores diretamente da empresa. **Um deles é mais barato?** Sim, nós somos. A menor cobrança da Umbler Talk é de dois agentes a R$ 99,90 cada, R$ 199,80 por mês; a nossa é de R$ 29,90 por número conectado, independentemente de quem o atende. **A Umbler Talk usa a API oficial do WhatsApp?** Sim. A página deles diz que a Umbler Talk usa a API oficial do WhatsApp e segue as diretrizes da plataforma. **A Umbler Talk oferece Coexistência?** A página de planos não menciona isso. Pergunte a eles, em vez de confiar nesta página. **A EasyCoexistence cobra por agente?** Não. A cobrança é por número conectado, independentemente de quantas pessoas respondem nele ou trabalham com ele pela API. --- ## EasyCoexistence vs Whaticket https://easycoexistence.com/pt/compare/easycoexistence-vs-whaticket Whaticket é uma caixa de entrada multiagente para WhatsApp e outros canais, a partir de US$ 49 por mês com mínimo de três usuários e um número de WhatsApp, conectado por QR code ou pela API oficial com Coexistência. EasyCoexistence é apenas a conexão oficial: a Cloud API da Meta no número do app do WhatsApp Business, a US$ 9 por número. ### Como cada um conecta o número O Whaticket vende dois caminhos até o WhatsApp. A EasyCoexistence vende um. - Whaticket:: Uma escolha entre WhatsApp QR, uma sessão lida como no WhatsApp Web, ou WhatsApp API com Coexistência. O próprio site avisa que envio em massa com WhatsApp Business pode causar bloqueios e recomenda a API para reduzir esse risco. - EasyCoexistence:: Apenas a Cloud API da Meta, conectada pelo Embedded Signup da Meta com Coexistência, então o app do WhatsApp Business continua funcionando no mesmo número. Não há opção de sessão por QR code, então não existe caminho não oficial como alternativa. ### Para que serve a cobrança mensal As duas cobranças são feitas de partes diferentes. - Whaticket:: US$ 49 por mês no Basic para três usuários e um número, US$ 20 por mês para cada número a mais, e o plano Pro a US$ 109. Campanhas em conexão por QR consomem créditos, a partir de US$ 25 por 1.000 mensagens; campanhas pela API são isentas. - EasyCoexistence:: US$ 9 por número conectado por mês de um a cinco números, caindo até US$ 1 cada conforme você adiciona números. Sem usuários, sem créditos. A Meta cobra suas tarifas de mensagens direto da empresa, nunca com margem. Primeiros três dias grátis. ### O que cada produto é Um é onde os agentes trabalham. O outro é o encanamento por baixo. - Whaticket:: Uma caixa de entrada multiagente que centraliza e automatiza canais de mensagens, com campanhas, para que a equipe responda dentro da plataforma. - EasyCoexistence:: A conexão mais monitoramento 24/7. A equipe mantém o app do WhatsApp Business, as mensagens chegam ao seu próprio webhook e agentes de IA atuam no número pelo nosso servidor MCP. ### Quanto custa um segundo, quinto ou décimo número Agências e empresas com várias filiais fazem essa conta antes de tudo. - Whaticket:: US$ 20 por número extra além do plano, então cinco números no Basic somam US$ 129 por mês para três usuários. - EasyCoexistence:: Cinco números somam US$ 45 por mês, e o valor por número continua caindo: US$ 7 cada a partir de seis, até US$ 1 conforme você adiciona números. - Usar um número da empresa na conexão por QR. O próprio site do Whaticket avisa que envio em massa nela pode causar bloqueios. - Esquecer os créditos de mensagem. Campanhas em conexão por QR são cobradas por mil mensagens além do plano. - Precificar números extras pela tarifa do plano. Cada um soma US$ 20 por mês. **Qual é mais barato?** Somos nós. Um número no Whaticket Basic custa US$ 49 por mês; um número conectado conosco custa US$ 9. Com cinco números, são US$ 129 contra US$ 45. **O Whaticket tem suporte a Coexistência?** Sim. A página de preços lista WhatsApp API com Coexistência como opção de conexão ao lado da conexão por QR. **A conexão por QR é oficial?** Não. Ela vincula uma sessão como o WhatsApp Web faz. O próprio site do Whaticket recomenda a API para reduzir o risco de bloqueios. **Vocês têm uma caixa de entrada como o Whaticket?** Não. A equipe mantém o app do WhatsApp Business, e o que você automatizar roda nas suas próprias ferramentas. --- ## EasyCoexistence vs Leadsales https://easycoexistence.com/pt/compare/easycoexistence-vs-leadsales Leadsales é um CRM conversacional mexicano para vender por WhatsApp, Facebook e Instagram. O plano Basic, US$ 97 por mês, conecta o WhatsApp pela sessão web, e a API oficial começa no plano Professional, a US$ 133. A EasyCoexistence conecta o número à Cloud API da Meta por meio da Coexistência, a US$ 9 por número. ### Qual plano chega ao WhatsApp de forma oficial Na Leadsales, o método de conexão depende do plano. Na EasyCoexistence, não. - Leadsales:: O Basic conecta o WhatsApp pelo Messenger e pela sessão web, não pela 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:: Todo número fica na Cloud API da Meta, conectado pelo Embedded Signup da própria Meta com Coexistência, então o app do WhatsApp Business continua funcionando no celular. Não existe um plano mais barato e não oficial. ### Pelo que a mensalidade é cobrada A Leadsales limita usuários e conversas por plano. A EasyCoexistence não limita nenhum dos dois. - Leadsales:: O Basic inclui 3 usuários e 5,000 conversas ativas, o Professional 4 usuários e 20,000, o Advanced 5 usuários e 50,000, com descontos de até 20% na cobrança anual. - EasyCoexistence:: US$ 9 por número conectado por mês de um a cinco números, caindo até US$ 1 cada conforme você adiciona números. Sem contagem de usuários, sem contagem de conversas, três primeiros dias grátis, e a Meta cobra as mensagens diretamente da empresa. ### O que cada produto é Um CRM e uma conexão resolvem problemas diferentes. - Leadsales:: Um CRM de vendas com funis, espaço de trabalho compartilhado, envio em massa por etapa e um agente de IA nos planos mais altos. Os leads são trabalhados dentro da Leadsales. - EasyCoexistence:: A conexão e o seu monitoramento. As mensagens chegam ao CRM ou à ferramenta que a empresa já usa por meio dos webhooks da Meta, e agentes de IA atuam no número pelo nosso servidor MCP. ### O que acontece com um número na sessão web O risco que o plano mais barato carrega. - Leadsales:: Um número no plano Basic chega ao WhatsApp por uma sessão web, e não pela Business API, um caminho que os termos comerciais do WhatsApp não autorizam para mensagens empresariais automatizadas. - EasyCoexistence:: Nada na conexão pode ser punido, porque é o recurso de Coexistência da própria Meta, feito pelo fluxo da própria Meta, e a conexão é monitorada o tempo todo. - Escolher o plano Basic pelo preço e achar que ele usa a API. Ele conecta pela sessão web. - Contar os usuários e esquecer o limite de conversas ativas. Cada plano define um. - Esperar que o plano inclua as cobranças de templates da Meta. A Meta cobra isso diretamente da empresa. **Algum dos dois é mais barato?** Sim, a EasyCoexistence. O plano mais barato da Leadsales com a API oficial custa US$ 133 por mês; um número conectado conosco custa US$ 9. **A Leadsales usa a API oficial do WhatsApp?** No Professional e no Advanced, sim. O plano Basic conecta o WhatsApp pelo Messenger e pela sessão web. **A Leadsales oferece Coexistência?** A página de preços deles diz que, em alguns casos, o número continua utilizável no celular e, em outros, passa totalmente para a API. Conosco, ele sempre continua no app do WhatsApp Business. **Posso manter meu CRM e usar a EasyCoexistence?** Sim. A Meta entrega as mensagens ao webhook que você escolher, então qualquer CRM que aceite webhooks pode recebê-las. --- ## EasyCoexistence vs Treble https://easycoexistence.com/pt/compare/easycoexistence-vs-treble A Treble é uma plataforma latino-americana de WhatsApp Business API para fluxos automatizados, campanhas e atendimento com IA, vendida pela equipe comercial, sem preço público. A EasyCoexistence conecta à Cloud API da Meta, por meio da Coexistência, o número que a empresa já usa no app do WhatsApp Business, por autoatendimento e a um preço publicado de US$ 9 por número conectado por mês. ### O que acontece com o app do WhatsApp Business Os dois produtos partem de premissas opostas sobre o celular. - Treble:: A página inicial deles diz que a Treble é uma solução baseada na WhatsApp Business API, não no app gratuito do WhatsApp Business. Ela não menciona a Coexistência, então pergunte a eles se um número pode continuar no app. - EasyCoexistence:: O app continua. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, com cerca de seis meses de histórico de conversas sincronizado, enquanto a Cloud API roda ao lado para a automação. ### Quanto custa Um preço dá para ler hoje. O outro exige uma conversa. - Treble:: Sem preço público. A página inicial não mostra valor e a página de preços pede uma senha, então o valor vem da equipe comercial deles. - EasyCoexistence:: US$ 9 por número conectado por mês de um a cinco números, caindo em seis faixas até US$ 1 cada conforme você adiciona números. A Meta cobra as mensagens direto da empresa e nada recebe margem. ### O que cada produto é Os dois usam a 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 conexões personalizadas. - EasyCoexistence:: A conexão e seu monitoramento 24/7. A Meta entrega os webhooks direto no seu sistema, o conteúdo das conversas nunca é armazenado do nosso lado e um servidor MCP permite que agentes de IA enviem mensagens pelo número. ### Quanto tempo até um número entrar no ar Muitas vezes é a pergunta decisiva para uma pequena empresa. - Treble:: Por um processo comercial, já que planos e preços são combinados com a equipe deles antes da integração. - EasyCoexistence:: Normalmente menos de dois minutos pelo Embedded Signup da Meta: entre com o Facebook, informe o número e escaneie um QR code no app. Os requisitos são app na versão 2.24.17 ou superior e atividade real recente. - Mover um número de app com muito movimento para uma configuração só de API sem verificar a Coexistência. O celular deixa de ser o lugar onde a equipe responde. - Comparar o orçamento de uma plataforma de campanhas com o valor de uma conexão. Um deles inclui fluxos e campanhas. - Deixar de fora as cobranças de template da Meta. Elas são cobradas pela Meta, não por nenhum dos dois provedores. **A Treble publica preços?** Não. A página inicial deles não mostra nenhum e a página de preços é protegida por senha. **Qual é mais barata?** O nosso preço é publicado e o deles não, então o nosso é o que você pode verificar: US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números. **A Treble oferece Coexistência?** A página inicial deles não a menciona e descreve a Treble como baseada na API, não no app do WhatsApp Business. Pergunte a eles. **Posso fazer campanhas com a EasyCoexistence?** Sim, pela Cloud API com templates aprovados, a partir do seu próprio sistema ou ferramenta. A Meta cobra os templates direto de você. --- ## EasyCoexistence vs Botmaker https://easycoexistence.com/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 por 3.000 conversas, mais uma taxa única de US$ 99 para abrir a conta do WhatsApp. Ela é compatível com Coexistência. A EasyCoexistence é só a conexão de Coexistência, a US$ 9 por número conectado por mês, sem pacotes de conversas. ### Pelo que você paga todo mês A Botmaker vende conversas. A EasyCoexistence vende a conexã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 de US$ 0,07 a US$ 0,05 por conversa excedente e US$ 99 para abrir a conta do WhatsApp. As mensagens push levam o custo do WhatsApp mais 20% de taxa de serviço. - EasyCoexistence:: US$ 9 por número conectado por mês de um a cinco números, caindo até US$ 1 cada conforme você adiciona números. Sem pacote, sem excedente, sem taxa para começar. A Meta cobra suas tarifas direto da empresa e nós nunca aplicamos margem. ### Como a Coexistência funciona em cada uma As duas mantêm o app do WhatsApp Business funcionando no número. O resto da configuração é diferente. - Botmaker:: A central de ajuda deles diz que a Coexistência está disponível apenas para números novos ou novas configurações, que o bot pausa quando alguém responde pelo celular e que conversas em grupo não são compatíveis com a plataforma. - EasyCoexistence:: A Coexistência é o produto: autoatendimento pelo Embedded Signup da Meta em cerca de dois minutos, depois monitoramento 24/7, de modo que uma queda, como a regra de 14 dias da Meta, é sinalizada no instante em que acontece. ### O que cada produto é Uma plataforma de bots e uma conexão são compras diferentes. - Botmaker:: Uma plataforma para criar bots e operar atendimento com agentes no WhatsApp, com de dez a cinquenta assentos de agente incluídos conforme o plano. Os fluxos ficam dentro da Botmaker. - EasyCoexistence:: A conexão. Os webhooks da Meta chegam ao seu próprio sistema, o conteúdo das conversas nunca é armazenado do nosso lado e um servidor MCP permite que Claude, ChatGPT, Cursor, Claude Code ou Codex atuem no número. ### O que o crescimento faz com a conta Os dois modelos vão em direções opostas à medida que o negócio ganha movimento. - Botmaker:: Mais conversas significam excedente por conversa ou a mudança para o plano seguinte, então um mês movimentado custa mais do que um mês calmo. - EasyCoexistence:: O volume de mensagens não entra no preço. Só adicionar números muda a conta, e o valor por número cai conforme eles são adicionados. - Comparar preços de plano e esquecer a taxa de US$ 99 da conta e os 20% de taxa de serviço sobre mensagens push. - Dimensionar o plano pelas conversas de hoje. O excedente é cobrado por conversa acima do pacote. - Esperar que uma resposta pelo celular mantenha o bot rodando. Na Botmaker, o bot pausa quando o celular responde. **A Botmaker é compatível com Coexistência?** Sim. A central de ajuda deles a documenta, disponível para números novos ou novas configurações. **Qual das duas é mais barata?** A nossa. A Botmaker começa em US$ 149 por mês mais US$ 99 para abrir a conta; um número conectado conosco custa US$ 9 por mês, sem nada a pagar para começar. **Vocês cobram alguma taxa sobre as cobranças da Meta?** Não. A Meta cobra as mensagens na conta da própria empresa e nós nunca aplicamos margem. **Posso criar um bot com a EasyCoexistence?** Sim, no n8n, no Make, com código próprio ou com um agente de IA via MCP. As mensagens chegam ao seu sistema pelos webhooks da Meta. --- ## EasyCoexistence vs Gallabox https://easycoexistence.com/pt/compare/easycoexistence-vs-gallabox Gallabox e EasyCoexistence resolvem problemas diferentes. O Gallabox é um inbox para equipes e uma suíte de automação sobre a API oficial do WhatsApp Business, vendido em planos com número fixo de usuários. A EasyCoexistence é a conexão em si: a Cloud API da Meta no mesmo número do app do WhatsApp Business, com preço por número, sem inbox e sem assentos. ### O que a fatura mensal paga Os dois são cobrados por unidades diferentes, e a unidade define como a fatura cresce. - Gallabox:: Planos mensais com tamanho de equipe fixo. O Basic custa ₹ 2,999 por mês, cobrados trimestralmente, para 3 usuários, descrito na página deles como limite rígido, e equipes maiores migram para o Essential ou o Advanced. - EasyCoexistence:: A partir de US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números. Não há contagem de usuários nem de contatos, então contratar alguém ou atender mais clientes não muda nada na fatura. ### Como a Coexistência é ativada Os dois usam a Coexistência da Meta, então o app do WhatsApp Business continua funcionando no celular. O caminho até ela é que muda. - Gallabox:: A documentação deles afirma que a Coexistência não vem ativada por padrão e que é preciso falar com o suporte do Gallabox antes de começar, para que o workspace seja ativado primeiro. - EasyCoexistence:: A Coexistência é o produto. O dono do negócio conclui o Embedded Signup da Meta em cerca de dois minutos, por conta própria, com o app na versão 2.24.17 ou superior e o número não vinculado a outro provedor. ### Onde as conversas ficam guardadas Esta é a diferença que mais importa para quem constrói a própria interface ou administra números de clientes. - Gallabox:: Dentro da plataforma deles. Um inbox compartilhado, um construtor de chatbot e uma ferramenta de transmissão precisam das mensagens armazenadas do lado deles para exibi-las aos atendentes. - EasyCoexistence:: Conosco, não. A Meta envia os webhooks direto ao endpoint que você indicar, e as conversas nunca são armazenadas do nosso lado. Seu CRM, seu app ou seu agente de IA é onde os dados chegam. ### Qual escolher Se a compra é um inbox para equipe com chatbots e campanhas, o Gallabox é esse tipo de produto, e é uma compra diferente de uma conexão. Se a compra é o número em si, conectado oficialmente e mantido ativo, a EasyCoexistence é a opção mais enxuta e mais barata. Serve para uma agência que integra números de clientes à própria stack, para um desenvolvedor que já tem interface ou para um dono que quer automação sem tirar a equipe do celular. A conexão é monitorada, inclusive a regra de 14 dias da Meta, e a Meta cobra as mensagens na sua própria conta, sem margem nossa. - Comparar diretamente os preços dos planos. Um inclui inbox e créditos de IA; o outro é só a conexão. - Iniciar o onboarding da Coexistência antes de o provedor ativá-la e depois repetir o processo com o mesmo número várias vezes. - Comprar um inbox com limite de assentos para números cujas mensagens serão tratadas pelo seu próprio software. **A EasyCoexistence é mais barata que o Gallabox?** Para a conexão, sim. O Gallabox Basic custa ₹ 2,999 por mês, cobrados trimestralmente, para 3 usuários. A EasyCoexistence custa US$ 9 por número conectado por mês, sem limite de usuários, então um número com uma equipe de qualquer tamanho custa US$ 9. **O Gallabox oferece Coexistência?** Sim. A documentação deles a descreve e diz que o suporte precisa ativá-la no seu workspace antes da configuração. **A EasyCoexistence tem um inbox como o do Gallabox?** Não. Sua equipe continua no app do WhatsApp Business, e o software recebe as mesmas mensagens por webhooks entregues pela Meta ao seu próprio sistema. **Quem paga as tarifas de mensagem da Meta?** Com a EasyCoexistence, você paga, direto à Meta, na sua própria conta do WhatsApp Business, sem nenhum acréscimo nosso. --- ## EasyCoexistence vs TimelinesAI https://easycoexistence.com/pt/compare/easycoexistence-vs-timelinesai A TimelinesAI é uma caixa de entrada do WhatsApp compartilhada, sincronizada com CRMs e cobrada por assento, que conecta um número por QR code, pela API oficial do WhatsApp Business ou por Coexistência. A EasyCoexistence conecta números apenas pela Cloud API da Meta com Coexistência, cobra por número e envia cada mensagem ao seu próprio sistema, em vez de a uma caixa de entrada. ### Como cada uma conecta o número O método de conexão define a que o número fica exposto, por isso vem primeiro. - TimelinesAI:: Três opções em todos os planos: um link de QR code, que anexa o número como dispositivo vinculado, a API oficial do WhatsApp Business ou a Coexistência, que roda o app e a API juntos. - EasyCoexistence:: Um método só: a Cloud API da Meta com Coexistência, pelo Embedded Signup da própria Meta. Não há opção de sessão por QR code, então nenhum número conectado por nós depende de um dispositivo vinculado continuar ativo. ### O que a fatura mensal paga Assento e número crescem por motivos diferentes. - TimelinesAI:: $35 por assento por mês no Starter, ou $28 no plano anual, e $49 por assento no Pro. A página de preços deles informa que é preciso um assento para cada usuário que conecta uma conta do WhatsApp. - EasyCoexistence:: US$ 9 por número conectado por mês até cinco números, caindo para US$ 1 conforme você adiciona números. Pessoas não entram na conta, e a Meta cobra as tarifas de mensagem diretamente de você. ### Onde as conversas vão parar Uma caixa de entrada e uma conexão colocam os dados em lugares diferentes. - TimelinesAI:: Na caixa de entrada compartilhada deles, sincronizada com o CRM que você escolher. A caixa de entrada é o produto, então as mensagens passam e são exibidas na plataforma deles. - EasyCoexistence:: Direto para o seu endpoint. A Meta entrega webhooks na URL que você indicar e as conversas nunca são armazenadas do nosso lado, o que mantém os dados de um cliente em sistemas que você controla. ### Qual escolher Uma equipe de vendas que quer uma caixa de entrada compartilhada dentro do CRM está procurando uma caixa de entrada, e a TimelinesAI é uma. Uma empresa que quer o número conectado de forma oficial, sem sessão por QR code no caminho e nada armazenado por intermediário, está procurando uma conexão. A EasyCoexistence é essa conexão, com monitoramento de saúde que lê os motivos de desconexão da própria Meta, um servidor MCP para assistentes de IA e um valor fixo por número, seja qual for o tamanho da equipe. - Vincular um número comercial por QR code porque é mais rápido. Uma sessão de dispositivo vinculado não é a Business Platform da Meta. - Contar assentos para números que um software, e não pessoas, vai responder. - Misturar números vinculados por QR code e conectados pela API na mesma conta sem controlar qual é qual. **A EasyCoexistence é mais barata que a TimelinesAI?** Para um número conectado, sim. O Starter da TimelinesAI custa $35 por assento por mês. A EasyCoexistence custa US$ 9 por número conectado por mês, e uma equipe de qualquer tamanho respondendo pelo app do WhatsApp Business não acrescenta nada. **A TimelinesAI oferece Coexistência?** Sim. A página de preços deles lista a Coexistência ao lado do QR code e da API oficial em todos os planos. **Posso conectar um número por QR code com a EasyCoexistence?** Não. Todo número é conectado pela Cloud API da Meta com Coexistência, nunca como dispositivo vinculado. **Continuo usando o WhatsApp no celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número enquanto a API roda em paralelo. --- ## EasyCoexistence vs Periskope https://easycoexistence.com/pt/compare/easycoexistence-vs-periskope O Periskope conecta um número do WhatsApp lendo um QR code na tela de Conectar aparelho do celular, e a documentação dele diz que números da API do WhatsApp não podem ser vinculados. O EasyCoexistence segue o caminho oposto: o número é registrado na Cloud API da Meta por meio da Coexistência, então o app do WhatsApp Business continua funcionando e a conexão é a oficial. ### Como cada um chega ao WhatsApp Tudo o mais nesta página decorre do método de conexão. - Periskope:: Você abre as configurações do WhatsApp no celular, escolhe Conectar aparelho e lê o QR code que o Periskope mostra. O número fica anexado como dispositivo vinculado, e a página inicial deles anuncia que isso dispensa a API Business. - EasyCoexistence:: O Embedded Signup da Meta registra o número na Cloud API com credenciais que a Meta emite para a sua própria conta do WhatsApp Business. A Coexistência mantém o app rodando no celular, no mesmo número. ### Quanto custa por mês Os dois publicam seus preços, e cada um conta uma coisa diferente. - Periskope:: O Starter custa US$ 25 por usuário por mês e o Pro US$ 35, com o primeiro telefone incluído e cada telefone adicional cobrado como uma licença própria pelo valor do plano. O Enterprise exige no mínimo 50 usuários ou telefones. - EasyCoexistence:: US$ 9 por número conectado por mês de um a cinco números, caindo em seis faixas até US$ 1 conforme você adiciona números. Sem licenças por usuário, e a Meta cobra as mensagens direto na sua conta, sem margem. ### A que a conexão fica exposta Uma sessão de dispositivo vinculado e um registro na API recebem tratamento diferente do WhatsApp. - Periskope:: O acesso por dispositivo vinculado roda fora da plataforma de negócios da Meta. Os termos comerciais do WhatsApp regem o uso automatizado e de terceiros, e um número acessado assim não tem reconhecimento em nível de API junto à Meta. - EasyCoexistence:: Cada chamada vai para a Cloud API da Meta. Quando uma conexão cai, lemos o motivo de desconexão informado pela própria Meta e avisamos você, inclusive sobre a regra de 14 dias de atividade no app que vale para números em Coexistência. ### Qual escolher A pergunta é quanto vale o número e onde ele precisa funcionar. O modelo do Periskope é construído em torno de vincular números existentes como dispositivos, inclusive grupos, e ele não aceita números de API. Para um número do qual os clientes dependem, ou o número de um cliente pelo qual uma agência responde, o caminho oficial é o que fica dentro das regras da Meta. O EasyCoexistence oferece esse caminho por um valor fixo por número, mantém o app do WhatsApp Business funcionando e entrega as mensagens no seu próprio sistema. - Supor que uma ferramenta paga significa que o acesso é autorizado pela Meta. A autorização vem da Meta emitindo credenciais da API. - Vincular um número comercial como dispositivo e depois tentar migrá-lo para um provedor de API sem desvincular antes. - Precificar por usuário quando a maior parte das mensagens será tratada por automação, e não por pessoas. **O EasyCoexistence é mais barato que o Periskope?** Sim. O Periskope Starter custa US$ 25 por usuário por mês, e cada telefone extra mais US$ 25. O EasyCoexistence custa US$ 9 por número conectado por mês, sem cobrança por usuário. **O Periskope usa a API oficial do WhatsApp?** Não. A documentação dele conecta números por QR code em Conectar aparelho e afirma que números da API do WhatsApp não podem ser vinculados. **Posso usar grupos pelo EasyCoexistence?** Não. Conversas em grupo ficam fora da Cloud API da Meta, e essa regra vale para todo provedor oficial. **Meu app vai continuar funcionando?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no celular enquanto a Cloud API roda no mesmo número. --- ## EasyCoexistence vs Wassenger https://easycoexistence.com/pt/compare/easycoexistence-vs-wassenger A Wassenger é uma caixa de entrada para equipes e plataforma de API do WhatsApp com dois conectores: uma sessão por QR code e a Cloud API da Meta, com Coexistência no lado da API. A EasyCoexistence oferece só a Cloud API com Coexistência, não tem caixa de entrada e cobra cada número conectado a partir de US$ 9 por mês, em vez de um plano com número fixo de agentes. ### Como cada uma conecta o número A própria central de ajuda da Wassenger compara seus dois conectores, e é o melhor lugar para começar. - Wassenger:: Um conector por QR, descrito como uma conexão baseada em sessão, por meio de um serviço worker que exige o celular online e fica sujeita à detecção antispam do WhatsApp, e um conector Cloud API autenticado na Meta. A Coexistência é oferecida no lado da API. - EasyCoexistence:: Apenas a Cloud API da Meta, por meio do Embedded Signup da Meta com Coexistência. Não existe worker de sessão nem conector por QR no produto, então não há o que escolher errado. ### Pelo que a mensalidade paga Um plano de agentes e um valor 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 cobrados à parte, a preço de custo. - EasyCoexistence:: US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números, sem contagem de agentes. A Meta cobra as mensagens na sua própria conta do WhatsApp Business Account, nunca por nós. ### Onde as conversas vão parar Uma caixa de entrada guarda o que mostra. Uma conexão repassa o que recebe. - Wassenger:: Na caixa de entrada compartilhada da equipe, onde os agentes recebem conversas atribuídas, rodam campanhas e usam o assistente de IA. As mensagens ficam na plataforma deles para que os agentes possam trabalhá-las. - EasyCoexistence:: No seu próprio sistema. A Meta envia os webhooks direto ao endpoint que você define, as conversas nunca são armazenadas do nosso lado e a equipe continua respondendo pelo app do WhatsApp Business. ### Qual escolher Uma equipe que quer agentes entrando numa caixa de entrada compartilhada está comprando 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 mais nada, como uma agência que conecta números de clientes, um desenvolvedor que alimenta um app existente ou um dono que adiciona automação sem uma ferramenta nova, recebe da EasyCoexistence um produto mais estreito: um único tipo de conexão, valor fixo por número, monitoramento que avisa antes de um vínculo de Coexistência expirar e um servidor MCP para Claude, ChatGPT e Cursor. - Começar em um conector por QR para testar e deixar o número da empresa nele depois que funciona. - Comparar um plano de €39.90 com um valor por número sem contar os agentes e a caixa de entrada incluídos no plano. - Mover um número entre conectores sem verificar se o histórico de conversas vai junto. **A EasyCoexistence é mais barata que a Wassenger?** Para a conexão, sim. O Wassenger Professional custa €39.90 por mês por um número. A EasyCoexistence custa US$ 9 por número conectado por mês, e cinco números saem por US$ 45 no total. **A Wassenger oferece Coexistência?** Sim. A Wassenger publica uma página e um artigo de ajuda sobre Coexistência, para usar o app do WhatsApp Business e a plataforma de API dela no mesmo número. **O conector por QR da Wassenger é oficial?** A Wassenger o descreve como baseado em sessão e sujeito à detecção antispam do WhatsApp. O conector Cloud API é o que é autenticado na Meta. **Preciso de um servidor para usar a EasyCoexistence?** Você precisa de um endpoint para receber webhooks, ou de um assistente de IA conectado pelo servidor MCP. A hospedagem da conexão em si está incluída. --- ## EasyCoexistence vs WANotifier https://easycoexistence.com/pt/compare/easycoexistence-vs-wanotifier A WANotifier é uma plataforma de marketing e notificações do WhatsApp na API oficial, com preço por plano e faixa de contatos e limites mensais de mensagens. A EasyCoexistence é a própria conexão oficial, com Coexistência, cobrada por número conectado, sem limite de contatos nem de mensagens. Ambas repassam as tarifas de mensagem da Meta sem margem, então a diferença está no que a assinatura compra. ### O que a mensalidade paga A WANotifier cobra pelo tamanho da audiência. A EasyCoexistence cobra por número. - WANotifier:: Essentials $69, Advanced $119 e Premium $199 por mês, cobrados mensalmente na faixa de menos de 1.000 contatos, com limites mensais de envio de 4.000, 8.000 e 12.000 mensagens. Uma lista de contatos maior leva a uma faixa mais alta. - EasyCoexistence:: US$ 9 por número conectado por mês para até cinco números, caindo até US$ 1 conforme você adiciona números. Uma lista de cinquenta mil contatos custa o mesmo que uma de cinquenta. ### Como a Coexistência entra As duas se conectam pela API oficial da Meta e as duas oferecem Coexistência, então o app do WhatsApp Business continua no celular. - WANotifier:: A Coexistência aparece como recurso em todos os planos, ao lado de campanhas, chatbots, sequências automáticas e uma caixa de entrada compartilhada da equipe. - EasyCoexistence:: A Coexistência é o produto inteiro: Embedded Signup self-service em cerca de dois minutos, monitoramento contínuo da saúde da conexão e alertas baseados nos próprios motivos de desconexão da Meta, incluindo a regra de 14 dias de atividade no app. ### Para onde vão as mensagens Uma ferramenta de campanhas trabalha as mensagens por você. Uma conexão as entrega. - WANotifier:: Para o painel, a caixa de entrada e o construtor de automações deles, com API REST e webhooks nos planos Advanced e Premium para integrações. - EasyCoexistence:: Direto para o seu endpoint em cada número, porque a Meta envia os webhooks para a URL que você indicar. Nada é armazenado do nosso lado, e um servidor MCP permite que Claude, ChatGPT ou Cursor trabalhem com o número. ### Qual escolher Quem quer disparos, sequências automáticas e um construtor de chatbot em um só painel está comprando uma ferramenta de campanhas, um produto diferente de uma conexão. Quem já tem o software, ou está construindo um, precisa do número conectado oficialmente e mantido conectado. Isso é a EasyCoexistence, com um valor que não varia com contatos nem com volume, enquanto as tarifas de mensagem da Meta vão direto para a sua conta nos dois casos. - Escolher um plano pelo preço sem conferir o limite mensal de mensagens que vem com ele. - Deixar a lista de contatos passar do limite de uma faixa no meio do mês sem prever o aumento no orçamento. - Achar que 0% de margem significa nenhuma taxa de plataforma. Valem tanto a assinatura quanto as tarifas da Meta. **A EasyCoexistence é mais barata que a WANotifier?** Sim, para a conexão. O WANotifier Essentials custa $69 por mês na menor faixa de contatos. A EasyCoexistence custa US$ 9 por número conectado por mês, sem limite de contatos nem de mensagens. **A WANotifier oferece Coexistência?** Sim. A página de preços deles lista a Coexistência do WhatsApp em todos os planos. **As duas repassam as tarifas da Meta sem margem?** Sim. A WANotifier declara 0% de margem, e com a EasyCoexistence a Meta cobra você diretamente na sua própria conta. **Posso enviar campanhas com a EasyCoexistence?** Você pode enviar templates aprovados pela Cloud API a partir do seu próprio sistema ou de um assistente de IA. Não há construtor de campanhas. --- ## EasyCoexistence vs Eazybe https://easycoexistence.com/pt/compare/easycoexistence-vs-eazybe O Eazybe é uma camada de CRM para equipes de vendas, instalada como extensão do Chrome no WhatsApp Web, cobrada por usuário no plano Starter, com planos maiores que incluem um número de API do WhatsApp e Coexistência. O EasyCoexistence é apenas a conexão oficial: a Cloud API da Meta com Coexistência, cobrada por número, entregando as mensagens ao seu próprio sistema. ### Como cada um chega ao WhatsApp Os dois produtos ficam em lugares diferentes: um no navegador do atendente, outro na API da Meta. - Eazybe:: Uma extensão do Chrome adicionada à sessão do WhatsApp Web que cada atendente já mantém aberta, com etiquetas, sincronização de CRM e agendamento. Os planos maiores listam também um número de API do WhatsApp e Coexistência. - EasyCoexistence:: A Cloud API da Meta, registrada pelo Embedded Signup da Meta com Coexistência. Nada roda em uma aba do navegador, então as mensagens fluem com ou sem o WhatsApp Web aberto. ### O que a mensalidade paga O Eazybe mostra preços na moeda local do visitante e muda a unidade de cobrança entre os planos. - Eazybe:: O Starter é cobrado por usuário por mês. Scaler, Basic AI e Pro AI são cobrados por número por mês, com 3 ou 5 usuários incluídos e cada usuário extra cobrado à parte, além de respostas de IA cobradas por resposta. - EasyCoexistence:: US$ 9 por número conectado por mês, caindo para US$ 1 conforme você adiciona números. Sem contagem de usuários, sem créditos de IA, e a Meta cobra as mensagens direto na sua própria conta. ### Onde as conversas vão parar Uma extensão de CRM copia os chats para um CRM. Uma conexão os encaminha para o sistema que você escolher. - Eazybe:: Sincronizadas do WhatsApp Web para os CRMs com os quais ele se integra, como HubSpot, Zoho e Salesforce, pela plataforma dele. - EasyCoexistence:: Entregues pela Meta como webhooks ao endpoint que você indicar, nunca armazenadas do nosso lado. Seu CRM, seu app, uma ferramenta de automação ou um assistente de IA pelo servidor MCP os recebe diretamente. ### Qual escolher Uma equipe de vendas que quer campos de CRM ao lado de cada chat no navegador está comprando uma extensão de CRM, e é isso que o plano Starter do Eazybe é. Uma empresa que quer todos os números na API oficial da Meta, sem depender de uma sessão de navegador, compra a conexão. O EasyCoexistence a oferece por um valor fixo por número, monitora a saúde dela continuamente, avisa antes de a regra de 14 dias de atividade no app vencer e mantém a equipe no app do WhatsApp Business que ela já usa. - Tratar uma extensão de navegador no WhatsApp Web como conexão de API. Ela depende de a aba estar aberta. - Comparar um plano por usuário com um valor por número sem contar quantos atendentes compartilham cada número. - Presumir que todo plano inclui a API oficial. No Eazybe ela aparece a partir do Scaler. **O EasyCoexistence é mais barato que o Eazybe?** Para um número compartilhado por uma equipe, sim. O Eazybe Starter cobra por usuário, e os planos de API cobram por número mais usuários extras. O EasyCoexistence custa US$ 9 por número conectado por mês, qualquer que seja o tamanho da equipe. **O Eazybe oferece Coexistência?** O Eazybe publica uma página sobre Coexistência que descreve o app do WhatsApp Business e a API oficial no mesmo número. **Preciso do WhatsApp Web aberto para usar o EasyCoexistence?** Não. A Cloud API roda nos servidores da Meta, e a equipe continua usando o app do WhatsApp Business no celular. **Posso sincronizar mensagens com meu CRM?** Sim, apontando os webhooks da Meta para o seu CRM, uma ferramenta de automação como n8n ou Make, ou o seu próprio código. --- ## EasyCoexistence vs Superchat https://easycoexistence.com/pt/compare/easycoexistence-vs-superchat O Superchat é uma caixa de entrada unificada para WhatsApp, Instagram, e-mail e outros canais, vendida em planos com contrato mínimo de 12 meses, e sua opção de Coexistência está marcada como beta. A EasyCoexistence é uma coisa só: o número do WhatsApp conectado à Cloud API da Meta por meio da Coexistência, cobrado por número conectado por mês, com as mensagens entregues ao seu próprio sistema. ### O que a mensalidade paga 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, valor líquido, 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 login extra $19, com prazo mínimo de 12 meses. - EasyCoexistence:: US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números, sem contas ou logins para contar. A Meta cobra as tarifas de mensagem diretamente de você. ### Como a Coexistência é oferecida Ambos conectam pela API oficial e ambos oferecem Coexistência, para que o app do WhatsApp Business continue no celular. - Superchat:: Um de quatro caminhos de conexão, ao lado de um número novo, uma migração completa e a troca de outro provedor. A central de ajuda deles diz que o caminho da Coexistência está em beta no momento e pode ter limitações de recursos. - EasyCoexistence:: O único caminho, concluído por conta própria pelo Embedded Signup da Meta em cerca de dois minutos e depois monitorado continuamente, para que um vínculo interrompido seja detectado antes de o cliente perceber. ### Onde as conversas vão parar Uma caixa de entrada guarda conversas para atendentes. Uma conexão as repassa. - Superchat:: Na caixa de entrada unificada deles, com templates, etiquetas, agentes de IA e gestão de avaliações trabalhando sobre as mensagens dentro da plataforma. - EasyCoexistence:: No endpoint que você indicar, porque a Meta envia os webhooks direto para lá. As conversas nunca são armazenadas do nosso lado, e a equipe continua com o app do WhatsApp Business. ### Qual escolher Quem quer responder vários canais a partir de uma única caixa de entrada está comprando uma caixa de entrada multicanal, uma compra separada de uma conexão com o WhatsApp. Quem quer o número de WhatsApp na API oficial, mantido ativo, com as mensagens indo para o próprio CRM, app ou assistente de IA, compra a EasyCoexistence: um valor fixo por número e a Coexistência como núcleo do produto, e não como uma opção beta. - Ler o preço mensal sem o prazo mínimo que vem junto. - Contar só o preço do plano quando são necessários mais números. Números extras têm sua própria mensalidade. - Iniciar a integração da Coexistência com um número já conectado a outro provedor de API. **A EasyCoexistence é mais barata que o Superchat?** Sim, para uma conexão com o WhatsApp. O Superchat Basic custa $19 por mês com prazo mínimo de 12 meses. A EasyCoexistence custa US$ 9 por número conectado por mês, e uma equipe de qualquer tamanho atende pelo app do WhatsApp Business. **O Superchat é compatível com a Coexistência?** Sim, como uma de suas opções de conexão, que a central de ajuda dele classifica como beta. **A EasyCoexistence cobre Instagram ou e-mail?** Não. Ela conecta números de WhatsApp pela Cloud API da Meta e nada além disso. **Quem paga as tarifas de mensagem da Meta?** Você, diretamente à Meta, na sua própria conta do WhatsApp Business. A EasyCoexistence nunca aplica margem sobre elas. --- ## EasyCoexistence vs Sinch https://easycoexistence.com/pt/compare/easycoexistence-vs-sinch A Sinch é uma plataforma de comunicação corporativa que revende WhatsApp junto com SMS, voz e outros canais, cobrando uma taxa própria por mensagem além da Meta, conforme o contrato de cada cliente. A EasyCoexistence conecta um número do app do WhatsApp Business à Cloud API da Meta por meio da Coexistência, em autoatendimento, por um valor fixo por número, e a Meta cobra as mensagens diretamente de você. ### Quanto custa cada mensagem A diferença está em haver ou não uma segunda taxa sobre 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 no seu contrato com a Sinch e não em uma tabela pública. - EasyCoexistence:: Uma camada só. A Meta cobra as taxas dela na sua própria conta do WhatsApp Business, e nós nunca aplicamos margem sobre elas. Nossa cobrança é de US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números, seja qual for o tráfego. ### Para quais números cada uma foi feita A maioria das pequenas empresas já atende clientes no app do WhatsApp Business. Esse é o número que importa. - Sinch:: O guia de configuração do Sinch Engage Classic pede um número que receba SMS ou ligações internacionais e que não esteja conectado a nenhuma conta do WhatsApp. Os artigos de onboarding deles não descrevem um caminho via Coexistência. - EasyCoexistence:: O número que já está no app do WhatsApp Business, conectado por meio da Coexistência. As conversas, o histórico e o app no celular continuam, e a Cloud API passa a rodar no mesmo número. ### Como começar Um caminho passa por um contrato comercial, o outro por uma página de cadastro. - Sinch:: O Embedded Signup no Sinch Build Dashboard está, nas palavras deles, disponível apenas para clientes corporativos diretos no momento, e o preço depende do seu contrato. - EasyCoexistence:: Embedded Signup da Meta em autoatendimento, em cerca de dois minutos, com os 3 primeiros dias grátis. O app precisa estar na versão 2.24.17 ou superior e ter atividade real recente. ### Qual escolher Uma grande empresa que compra SMS, voz e WhatsApp em um único contrato, com condições negociadas, está comprando CPaaS, que é outra compra e não uma conexão de WhatsApp. Uma empresa cujos clientes já escrevem para o app do WhatsApp Business, ou uma agência que conecta esses números para os clientes, precisa de Coexistência, de um preço publicado e de nenhuma taxa empilhada em cada mensagem. A EasyCoexistence foi feita exatamente para isso, com webhooks roteados pela Meta para o seu próprio sistema e um servidor MCP para assistentes de IA. - Orçar apenas a tabela de preços da Meta quando o provedor soma uma taxa própria a cada mensagem. - Registrar um número novo para a API e deixar os clientes escrevendo para o antigo, que está no app. - Apagar a conta do app do WhatsApp Business para liberar um número quando a Coexistência o manteria. **A EasyCoexistence é mais barata que a Sinch?** Sim, na parte que controlamos. A Sinch soma uma taxa própria a cada mensagem, conforme o seu contrato. A EasyCoexistence não soma nada por mensagem e cobra US$ 9 por número conectado por mês. **A Sinch oferece suporte à Coexistência?** Os artigos de onboarding da Sinch analisados para esta página não tratam do assunto. Pergunte diretamente à Sinch em vez de confiar apenas nesta página. **A Sinch publica a taxa dela para WhatsApp?** A central de ajuda diz que as taxas da Sinch dependem do seu contrato e não lista um valor público por mensagem. **Preciso de um contrato com a EasyCoexistence?** Não. O cadastro é em autoatendimento pelo Embedded Signup da Meta, com os 3 primeiros dias grátis. --- ## EasyCoexistence vs Vonage https://easycoexistence.com/pt/compare/easycoexistence-vs-vonage A Vonage é uma plataforma de comunicação para desenvolvedores cuja Messages API envia WhatsApp ao lado de SMS, RCS e outros canais, com uma taxa de plataforma da Vonage somada a cada mensagem, além da taxa da Meta. A EasyCoexistence conecta um número do app do WhatsApp Business à Cloud API da Meta por meio da Coexistência, por um valor fixo por número, e a Meta cobra as mensagens diretamente de você. ### Como a conta é montada Preço por uso e valor fixo se comportam 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 euro por mensagem e varia conforme volume e região. As chamadas têm outra taxa da Vonage, de US$ 0,004 por minuto. - EasyCoexistence:: US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números. A Meta cobra as mensagens na sua própria WhatsApp Business Account, e nós não somamos nada por mensagem. ### Para quais números cada uma foi feita O número em que uma pequena empresa já atende costuma ser um número do app do WhatsApp Business. - Vonage:: A página de preços de WhatsApp e o guia de Embedded Signup hospedado para parceiros não tratam da Coexistência, o recurso da Meta que mantém o app funcionando em um número com API. - EasyCoexistence:: Especificamente números em Coexistência. O app do WhatsApp Business mantém as conversas e continua funcionando no celular, enquanto a Cloud API roda no mesmo número, com o throughput de 20 mensagens por segundo da Coexistência na Meta. ### O que fica entre você e a Meta Ambas são produtos de API. O que muda é de quem é a API que você chama. - Vonage:: A Vonage Messages API, uma interface única sobre o WhatsApp e os outros canais deles. Seu código chama a Vonage, e a Vonage chama a Meta. - EasyCoexistence:: A Cloud API documentada da Meta, com credenciais emitidas na sua própria conta, e webhooks encaminhados pela Meta ao seu endpoint. As conversas nunca são armazenadas do nosso lado. ### Qual escolher Um desenvolvedor que quer uma única API para SMS, RCS, e-mail e WhatsApp está comprando CPaaS multicanal, que é um produto diferente de uma conexão com o WhatsApp. Uma empresa ou agência que precisa de números do app do WhatsApp Business na API da própria Meta, sem taxa sobre cada mensagem e sem um número novo, precisa de Coexistência. A EasyCoexistence oferece isso por autoatendimento em cerca de dois minutos, monitora cada conexão continuamente e expõe o número ao Claude, ao ChatGPT ou ao Cursor por meio de um servidor MCP. - Projetar o custo a partir de uma taxa de plataforma por mensagem sem somar a taxa da própria Meta. - Escrever código contra o esquema de mensagens de um fornecedor quando a Cloud API da Meta é documentada e portável. - Presumir que o fluxo de onboarding de uma CPaaS vai aceitar um número que ainda está ativo no app. **A EasyCoexistence é mais barata que a Vonage?** Em qualquer volume relevante, sim, porque a Vonage soma uma taxa de plataforma a cada mensagem e a EasyCoexistence não soma nenhuma. Nossa cobrança fica em US$ 9 por número conectado por mês, não importa quantas mensagens passem. **A Vonage oferece suporte à Coexistência?** As páginas de preços de WhatsApp e de Embedded Signup hospedado dela não tratam do assunto. Pergunte à Vonage em vez de se basear nesta página. **Posso manter meu número de WhatsApp atual?** Sim. A Coexistência conecta o número que já está no app do WhatsApp Business, com as conversas dele. **Quem me cobra pelas mensagens do WhatsApp?** A Meta, diretamente, na sua própria WhatsApp Business Account. A EasyCoexistence nunca aplica margem sobre essas taxas. --- ## EasyCoexistence vs Qontak https://easycoexistence.com/pt/compare/easycoexistence-vs-qontak A Mekari Qontak é uma suíte indonésia de CRM omnichannel e atendimento ao cliente na API oficial do WhatsApp, vendida em planos que começam em cinco usuários, com a Coexistência exigindo uma assinatura própria. A EasyCoexistence é apenas a conexão: um número do app do WhatsApp Business na Cloud API da Meta por meio da Coexistência, com preço por número conectado, e as mensagens vão para o seu próprio sistema. ### O que a fatura mensal paga A Qontak vende uma suíte de CRM. A EasyCoexistence vende uma conexão. - Qontak:: Service Suite e Sales Suite começam em Rp2.000.000 por mês no plano Plus e Rp3.000.000 no Ultimate, e o Qontak 360 em Rp3.500.000, com todos os planos a partir de 5 usuários. - EasyCoexistence:: US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números. Um número com uma equipe de qualquer tamanho respondendo pelo app custa US$ 9. ### Como a Coexistência é configurada Ambas conectam pelo fluxo de Coexistência da Meta, então o app do WhatsApp Business continua funcionando no celular. - Qontak:: O guia deles lista, entre os requisitos antes da integração, uma assinatura ativa do META Coex, um número ativo há pelo menos 30 dias e a verificação de negócios do Facebook concluída. - EasyCoexistence:: A Coexistência é o produto e não custa nada a mais. O cadastro é self-service em cerca de dois minutos, com o app na versão 2.24.17 ou posterior, atividade real recente e o número sem vínculo com outro provedor. ### Para onde vão as conversas Uma suíte de CRM guarda as conversas para trabalhá-las. Uma conexão as repassa. - Qontak:: Na caixa de entrada omnichannel e no CRM da Qontak, espelhadas com o app do WhatsApp Business, junto com tickets, chatbots e transmissões feitos pelo painel deles. - EasyCoexistence:: No endpoint que você escolher, porque a Meta envia os webhooks direto para lá. As conversas nunca ficam armazenadas do nosso lado, e um servidor MCP conecta o número a assistentes de IA. ### Qual escolher Uma empresa que quer funis de vendas, tickets e vários canais em uma só suíte está comprando um CRM, uma compra diferente de uma conexão com o WhatsApp. Um negócio que já tem seu CRM, ou uma agência que integra números de clientes à própria stack, precisa do número na API oficial e mantido conectado. A EasyCoexistence faz isso por um valor fixo por número, monitora cada conexão e avisa antes que a regra de 14 dias de atividade no app da Meta expire. - Conectar um número registrado no app comum do WhatsApp. A Coexistência exige o app do WhatsApp Business. - Criar um Portfólio de Negócios novo só para a integração, o que o guia da Qontak desaconselha. - Redefinir o app para resolver um problema da conta. Isso não zera o histórico e pode quebrar o vínculo. **A EasyCoexistence é mais barata que a Qontak?** Sim, para a conexão. Os planos da Qontak começam em Rp2.000.000 por mês com mínimo de 5 usuários, mais uma assinatura de Coexistência. A EasyCoexistence custa US$ 9 por número conectado por mês, com a Coexistência incluída. **A Qontak oferece Coexistência?** Sim. A central de ajuda deles descreve a integração e lista uma assinatura ativa do META Coex como requisito. **A EasyCoexistence exige um número com 30 dias?** Ela exige atividade real recente no app do WhatsApp Business, que é a verificação de elegibilidade da própria Meta para a Coexistência. **A EasyCoexistence inclui um CRM?** Não. As mensagens chegam ao seu CRM ou app atual por webhooks que a Meta entrega no seu endpoint. --- ## Registre mensagens do WhatsApp no HubSpot a partir de um número com Coexistência https://easycoexistence.com/pt/integrations/hubspot O HubSpot tem um objeto Communications cujo tipo de canal pode ser WHATS_APP, feito para registrar mensagens que acontecem fora do HubSpot. Encaminhe os webhooks do número para um workflow do n8n, encontre ou crie o contato pelo telefone e faça um POST de cada mensagem para /crm/v3/objects/communications. A conversa aparece na linha do tempo do contato, enquanto a equipe continua respondendo pelo app do WhatsApp Business. ### Como uma mensagem do WhatsApp chega a um contato do HubSpot? Em três etapas. A Meta entrega a mensagem ao destino de webhook que você definiu para o número, que aqui é um nó Webhook do n8n. O workflow busca no HubSpot um contato com o telefone do remetente e cria um se nada corresponder. Depois cria um registro de comunicação com o texto da mensagem e o associa a esse contato. O HubSpot criou o objeto Communications para esse caso. Ele representa uma mensagem no WhatsApp, LinkedIn ou SMS enviada ou recebida fora do HubSpot, e aparece na linha do tempo do registro como uma ligação ou um e-mail registrado. As propriedades obrigatórias são o tipo de canal, hs_communication_logged_from definido como CRM, o corpo, um responsável e um carimbo de data e hora. Nada disso exige um app do marketplace do HubSpot. O nó HTTP Request do n8n pode reutilizar a credencial do HubSpot que você já configurou para o nó HubSpot, e a chamada é um único POST por mensagem. ### As mensagens digitadas no celular também são registradas? Podem ser, e isso é o que um número com Coexistência acrescenta. Quando alguém da equipe responde pelo app do WhatsApp Business, a Meta envia um eco dessa mensagem enviada para o mesmo destino de webhook. Um workflow que trata tanto as mensagens recebidas quanto os ecos grava os dois lados da conversa na linha do tempo, e quem abre o contato 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 celular chegam em smb_message_echoes. Registre a primeira como recebida e a segunda como enviada, e a linha do tempo fica em ordem. As respostas que o próprio workflow envia pela Cloud API já são conhecidas por ele, então registre-as no momento do envio em vez de esperar um webhook. ### E o canal de caixa de entrada do WhatsApp do próprio HubSpot? É outra integração. A caixa de entrada de conversas do HubSpot conecta um número de WhatsApp ao próprio HubSpot, e a base de conhecimento dele diz que o número não pode estar conectado a outra integração do WhatsApp. Ela está disponível no Marketing Hub ou no Service Hub Professional e Enterprise. Um número conectado pela EasyCoexistence segue o caminho inverso: a Meta encaminha os webhooks para uma URL sua, e o HubSpot recebe os registros pela API. A conversa é respondida pelo celular ou pelo seu workflow, e o HubSpot é o sistema de registro que guarda o histórico junto ao contato, ao negócio ou ao ticket. A chamada precisa de um escopo de escrita em contatos no app privado ou na credencial que a faz, o mesmo escopo que o workflow já precisa para criar o contato. ### Como o workflow deve associar um remetente a um contato? Pelo número de telefone, normalizado antes da busca. A Meta envia o remetente como dígitos com o código do país e sem o sinal de mais, como 14155550188. Os contatos do HubSpot são digitados à mão, então a mesma pessoa pode estar salva como +1 415 555 0188 ou (415) 555-0188. O padrão confiável é manter uma propriedade de contato dedicada com o número só em dígitos, preenchê-la quando o workflow criar um contato e buscar por essa propriedade. Buscar direto no campo de telefone de texto livre funciona para contatos criados pelo workflow e deixa passar muitos criados por uma pessoa, o que gera duplicatas. Quando a busca não retorna nada, crie o contato com o nome do perfil do payload do webhook como primeiro nome e o número só em dígitos nos dois campos. Alguém pode mesclar ou renomear depois, e a conversa já está anexada. - Registrar apenas as mensagens recebidas. A linha do tempo passa a mostrar perguntas sem respostas, porque as respostas digitadas no celular chegam como eventos smb_message_echoes. - Deixar hs_communication_logged_from sem valor. O HubSpot exige que seja CRM ao criar uma comunicação pela API. - Buscar contatos no campo de telefone bruto. O formato só em dígitos da Meta raramente coincide com o que uma pessoa digitou, e cada falha cria um contato duplicado. **Posso responder ao cliente de dentro do HubSpot?** Não pelo objeto Communications, que é um registro. As respostas saem pelo app do WhatsApp Business ou por um workflow que chama a Cloud API, e as duas são registradas de volta no contato. **Quais permissões do HubSpot o workflow precisa?** Leitura e escrita de contatos. O HubSpot lista crm.objects.contacts.read ou crm.objects.contacts.write como os escopos da Communications API, e criar contatos já exige o escopo de escrita. **O mesmo workflow também pode enviar a primeira mensagem?** Sim. Um ramo separado do n8n pode enviar um template aprovado pela Cloud API com o phone number id e o token do número, e depois registrá-lo no contato como uma comunicação enviada. **A EasyCoexistence armazena o conteúdo das mensagens no caminho?** Não. A Meta entrega o webhook direto para a sua URL do n8n. A EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Envie conversas do WhatsApp para o Salesforce a partir de um número com Coexistência https://easycoexistence.com/pt/integrations/salesforce Direcione os webhooks do número para um workflow do n8n, busque o remetente no Salesforce com uma consulta SOQL por telefone, crie o lead se ninguém corresponder e registre cada mensagem como Tarefa ou nota no registro. O nó Salesforce do n8n cobre as três chamadas. A equipe continua respondendo pelo app do WhatsApp Business, enquanto o Salesforce guarda o histórico. ### Como é o workflow no n8n? Quatro nós em sequência, mais o ramo de verificação que todo webhook da Meta exige. Um nó Webhook recebe o POST que a Meta envia a cada mensagem. Um nó Salesforce executa uma consulta SOQL por um Lead ou Contact cujo telefone corresponda ao remetente. Um nó IF separa os casos conforme algo tenha voltado ou não: se voltou, o workflow segue com o id do registro; se não, um nó Salesforce cria um Lead com o nome do perfil que veio no payload. Um último nó Salesforce cria uma Tarefa nesse registro, com o texto da mensagem na descrição e o assunto indicando que foi uma mensagem do 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, e o resto do workflow fica parado. ### Tarefa ou nota: qual deve guardar a mensagem? Uma Tarefa, para a maioria das equipes, porque ela entra na linha do tempo de atividades que os vendedores já leem e pode ser usada em relatórios. Defina o status como concluída para que ela não apareça como pendência aberta, e dê a ela um assunto que nomeie o canal, de modo que filtrar as atividades do WhatsApp seja uma única condição. A operação Add note do nó do n8n serve a outro caso: um resumo em vez de cada mensagem. Algumas equipes fazem o workflow juntar as mensagens do dia por contato e escrever uma só nota à noite, o que mantém a linha do tempo legível para um cliente que manda vinte linhas curtas. Qualquer que seja a escolha, grave o id da mensagem do WhatsApp no registro. A Meta repete entregas, e um workflow que verifica se o id já existe antes de gravar nunca registra a mesma mensagem duas vezes. ### A equipe ainda pode responder pelo celular, e o Salesforce vai ver? Sim para os dois. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, então quem respondia os clientes ontem continua respondendo. Quando respondem pelo app, a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes. Adicione um segundo caminho no workflow para esses ecos e registre-os como Tarefas de saída. Um vendedor que abre o lead vê então a pergunta e a resposta que a loja deu, em ordem, sem ninguém copiar uma conversa à mão. As respostas que o próprio workflow envia, por um nó HTTP Request na Cloud API, devem ser registradas no momento do envio. O workflow já tem o texto e o id do registro em mãos. ### Como evitar leads duplicados? Compare por um número de telefone normalizado, não pelo campo como as pessoas o digitaram. A Meta envia o remetente como dígitos com o código do país e sem o sinal de mais. Os campos de telefone do Salesforce guardam o que quem criou o registro digitou, com espaços, parênteses e traços. A abordagem confiá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 registros existentes. A consulta SOQL então compara esse campo por igualdade, o que é rápido e exato. Verifique também os contatos, não só os leads. Um cliente que já foi convertido é um Contact, e um workflow que busca apenas leads criará um lead novo para cada cliente existente que escrever. - Buscar apenas no objeto Lead. Clientes existentes são Contacts, e cada um que escreve vira um lead duplicado. - Registrar mensagens como Tarefas abertas. Os vendedores recebem uma pendência para cada linha do cliente; defina o status como concluída ao criá-las. - Pular o ramo de verificação por GET no workflow. A Meta nunca confirma o destino, e nenhuma mensagem é entregue. **Preciso de um pacote do Salesforce AppExchange para isso?** Não. O nó Salesforce nativo do n8n cuida da busca, do lead e da tarefa, e o que faltar pode passar pelo nó HTTP Request usando a mesma credencial. **O Make faz a mesma coisa?** Sim. Um webhook personalizado do Make recebe a mensagem e os módulos do Salesforce gravam os registros. O desenho do cenário corresponde ao workflow do n8n passo a passo. **O Salesforce pode enviar um template do WhatsApp para um lead?** Pelo workflow, sim. Faça o Salesforce chamar um webhook do n8n, e o n8n envia o template de mensagem 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 direto na sua URL do n8n, e a EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Conectar o WhatsApp ao Zoho CRM em um número com Coexistência https://easycoexistence.com/pt/integrations/zoho-crm Direcione os webhooks do número para um workflow do n8n, busque 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 registro. O nó do Zoho CRM no n8n cuida de leads e contatos; a nota é uma única chamada HTTP à API de Notes do Zoho, com a mesma credencial. ### Como uma mensagem do WhatsApp se torna um registro no Zoho CRM? A Meta envia cada mensagem do número ao destino de webhook que você definiu, aqui um nó Webhook do n8n. O workflow pega o número do remetente no payload e chama o endpoint de busca do Zoho com phone igual a ele, primeiro em Leads e depois em Contatos. O Zoho verifica todos os campos de telefone do módulo, então uma correspondência em Mobile ou em Phone vale igual, e você não precisa adivinhar qual campo o vendedor usou. Quando nada volta, o nó do Zoho CRM no n8n cria um Lead com o nome do perfil do WhatsApp e o número. De qualquer forma, o workflow passa a ter um id de registro e grava a mensagem como nota nesse registro por meio de POST /Notes. Uma nota exige apenas Note_Content e um Parent_Id que indique o módulo e o registro. ### Quais permissões do Zoho a credencial do n8n precisa? Leitura e criação nos módulos em que você busca e escreve, além de criação em Notes. O Zoho chama o escopo da nota de ZohoCRM.modules.notes.CREATE e exige junto o escopo de criação do módulo pai, então uma credencial que cria Leads mas nunca recebeu o escopo de notas falha no último passo com um erro de autorização. O nó do Zoho CRM no n8n cobre Leads, Contatos, Contas, Negócios e vários documentos de vendas, com criar, upsert, obter, obter todos, atualizar e excluir. Notas não estão entre os recursos dele, e por isso a nota passa por um nó HTTP Request. O n8n permite que esse nó reutilize a credencial do Zoho que você já conectou, então há uma única autorização OAuth para gerenciar, e não duas. Defina o domínio da API conforme o data center do seu Zoho. Uma credencial criada na região da UE chama zohoapis.eu, e não zohoapis.com. ### Quantas mensagens o Zoho CRM aguenta? O Zoho mede sua API em créditos por 24 horas corridas, e o orçamento depende da edição e do número de usuários. A edição Free recebe 5.000. A Standard recebe 50.000 mais 250 por usuário, a Professional 50.000 mais 500 por usuário e a Enterprise 50.000 mais 1.000 por usuário, cada uma com um teto por edição. Cada mensagem recebida custa uma busca e a gravação de uma nota, mais a criação de um lead para quem escreve pela primeira vez. Isso cabe com folga no 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 simultâneas e a Standard 10, então uma rajada de respostas a um envio em massa pode formar fila. Configure o workflow do n8n para processar uma execução por vez se o Zoho começar a devolver erros de limite. ### As respostas enviadas pelo celular chegam ao Zoho CRM? Podem chegar. Em um número com Coexistência, o app do WhatsApp Business continua funcionando, e quando alguém responde por ele a Meta envia um eco dessa mensagem enviada ao mesmo destino de webhook, no campo smb_message_echoes. Dê ao workflow um ramo para os ecos e grave-os como notas com título de mensagem enviada. Assim, o vendedor que abre o lead no Zoho lê os dois lados da conversa, e ninguém precisa colar capturas de tela no CRM. As mensagens que o próprio workflow envia pela Cloud API, como um template aprovado depois que um negócio muda de etapa, é melhor registrá-las no momento do envio, porque o workflow já tem o texto e o id do registro. - Dar à credencial os escopos de leads mas não ZohoCRM.modules.notes.CREATE. A busca e o lead funcionam, e depois toda nota falha. - Chamar zohoapis.com a partir de uma conta de outro data center do Zoho. Use o domínio da API da região em que a conta está. - Buscar só em Leads. Clientes convertidos são Contatos, e cada um que escreve vira um lead duplicado novo. **Isso substitui a integração própria do WhatsApp do Zoho?** É outro caminho. Aqui o número fica conectado pela EasyCoexistence e o Zoho CRM recebe os registros pela API, enquanto a equipe responde pelo celular ou pelo 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 fazem a busca, o lead e a nota. **Uma mudança de etapa do negócio pode enviar um template do WhatsApp?** Sim, pelo workflow. Faça a mudança de etapa chamar a 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. **A EasyCoexistence armazena as mensagens?** Não. A Meta entrega o webhook direto na sua URL do n8n. A EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Conectar o WhatsApp ao Pipedrive em um número com Coexistência https://easycoexistence.com/pt/integrations/pipedrive Direcione os webhooks do número para um workflow do n8n, busque pessoas no Pipedrive pelo telefone, crie a pessoa e um lead quando ninguém corresponder e grave cada mensagem como nota na pessoa ou no negócio. O node do Pipedrive no n8n faz tudo isso. A equipe continua respondendo pelo app do WhatsApp Business, e as respostas também podem ser registradas. ### Como uma mensagem do WhatsApp chega a uma pessoa do Pipedrive? A Meta envia cada mensagem do número para o destino de webhook que você definiu, aqui um node Webhook do n8n. O workflow busca pessoas no Pipedrive com o número do remetente; a busca de pessoas do Pipedrive cobre o campo de telefone e aceita um parâmetro de correspondência exata. Quando uma pessoa é retornada, o workflow usa esse id. Quando nenhuma é, ele cria uma pessoa com o nome do perfil do WhatsApp e o número, depois um lead vinculado a ela, de modo que a primeira mensagem de um desconhecido aparece na Caixa de entrada de Leads para alguém qualificar. A mensagem em si vira uma nota. Uma nota do Pipedrive exige apenas o conteúdo, que aceita HTML, e ao menos um id de pessoa, negócio, organização ou lead. Anexe-a ao negócio em aberto, quando houver, e à pessoa caso contrário. ### Por que a etapa de busca atinge os limites primeiro? Porque o Pipedrive dá à busca uma cota própria, bem menor. As chamadas gerais de API são limitadas por usuário em uma janela móvel de dois segundos, de 20 requisições no Lite com token de API até 120 no Ultimate. A Search API fica limitada a 10 requisições a cada dois segundos em todos os planos. Um número com pouco movimento nunca percebe. Um número que envia um template a algumas centenas de clientes e recebe cinquenta respostas em um minuto percebe, porque cada resposta começa com uma busca. O workflow então recebe respostas 429 e, sem repetir a requisição, perde a nota. Duas medidas resolvem. Ative repetições com espera no node de busca do Pipedrive e guarde em cache o mapeamento de telefone para id da pessoa nos dados estáticos do workflow do n8n ou em uma tabela pequena, de modo que um cliente que manda seis mensagens seguidas custe uma busca, não seis. ### As respostas digitadas no celular também podem ser registradas? Sim. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número e, quando alguém da equipe responde por ele, a Meta envia um eco da mensagem enviada ao mesmo destino de webhook, no campo smb_message_echoes. Adicione uma ramificação para esses ecos e registre-os como notas marcadas como de saída, ou como atividades concluídas se sua equipe reporta por contagem de atividades. Um vendedor que abre o negócio vê então o que o cliente perguntou e o que a loja respondeu, em ordem. Para as mensagens que o próprio workflow envia, como um template quando um negócio muda de etapa, registre a nota no momento do envio. O workflow já tem o texto e o id do negócio, então não há motivo para esperar um webhook. ### Como o número de telefone deve ser normalizado? Para dígitos com o código do país e nada mais, porque é isso que a Meta envia. Um remetente chega como 14155550188, enquanto uma pessoa digitada à mão no Pipedrive pode aparecer como +1 (415) 555-0188. Quando o workflow cria uma pessoa, grave o número nessa forma só com dígitos, para que seus próprios registros sempre correspondam. Para as pessoas criadas à mão, uma limpeza única no n8n que reescreva os telefones existentes na mesma forma se paga já na primeira semana. Sem ela, a busca por correspondência exata não encontra as pessoas cadastradas pela equipe e o workflow cria um duplicado para cada uma. Mantenha a formatação original em um segundo telefone se a equipe gostar de lê-lo assim. Pessoas no Pipedrive podem ter mais de um telefone. - Fazer uma busca por mensagem sem cache. Rajadas de respostas esbarram no limite de 10 por dois segundos da Search API e notas se perdem. - Criar um lead para cada mensagem em vez de cada nova pessoa. A Caixa de entrada de Leads se enche de cópias do mesmo cliente. - Anexar notas só à pessoa quando há um negócio em aberto. Quem trabalha o negócio nunca vê a conversa. **As mensagens vão aparecer na caixa de mensagens do Pipedrive?** Não. Este caminho grava notas e leads pela API do Pipedrive. As conversas são respondidas pelo app do WhatsApp Business ou pelo workflow e registradas na pessoa ou no negócio. **Posso usar Make ou Zapier no lugar do n8n?** Sim. Um webhook personalizado ou catch hook recebe a mensagem, e os passos do Pipedrive deles ou um passo HTTP gravam a pessoa, o lead e a nota na mesma ordem. **A mudança de etapa de um negócio pode enviar um template do WhatsApp?** Sim, pelo workflow. Quando a mudança de etapa chama uma URL de 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 armazena as mensagens?** Não. A Meta entrega cada webhook direto na sua URL do n8n, e a EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Conectar o WhatsApp ao CRM Bitrix24 em um número com Coexistência https://easycoexistence.com/pt/integrations/bitrix24 Direcione os webhooks do número para um workflow do n8n e faça com que ele chame o Bitrix24 por uma URL de webhook de entrada. crm.duplicate.findbycomm encontra o lead, contato ou empresa dono do telefone do remetente, crm.lead.add cria um lead quando ninguém é dono e crm.timeline.comment.add grava a mensagem na linha do tempo do registro. A equipe continua respondendo pelo app do WhatsApp Business. ### Como o n8n conversa com o Bitrix24? Por um webhook de entrada, que no Bitrix24 não é um receptor, e sim uma credencial. Você o cria nos recursos para desenvolvedores do Bitrix24, escolhe os escopos que ele pode usar e recebe uma URL com o endereço do seu portal, o id do usuário que o criou e um código secreto. Acrescentar o nome de um método a essa URL chama a API REST como esse usuário, com as permissões dele. Assim, no n8n cada etapa do Bitrix24 é um nó HTTP Request que envia um POST para essa 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 escopo de CRM e crie-o com um usuário cujas permissões cubram os leads e contatos que o workflow precisa enxergar, já que o Bitrix24 verifica o acesso como esse usuário. ### Quais métodos do Bitrix24 o workflow chama? Três, em ordem, depois que o nó Webhook do n8n recebe a mensagem da Meta. crm.duplicate.findbycomm com o tipo PHONE e o número do remetente devolve os ids de leads, contatos e empresas que têm esse número. Essa é a busca certa porque pesquisa os três de uma vez e foi feita para comparar meios de contato, não um campo de texto. Quando nada é encontrado, crm.lead.add cria um lead com o nome do perfil do WhatsApp como título e o número no campo de telefone. Em seguida, crm.timeline.comment.add grava o texto da mensagem como comentário no registro, recebendo ENTITY_TYPE, ENTITY_ID e COMMENT. O comentário aparece na linha do tempo do registro, ao lado de ligações e e-mails, onde o vendedor já costuma olhar. ### Como o limite de taxa influencia o workflow? O Bitrix24 mede as chamadas REST com um balde furado. Cada requisição soma ao contador, o contador diminui a uma taxa fixa por segundo e, quando passa de um limite, a próxima requisição recebe um 503 com QUERY_LIMIT_EXCEEDED. Nos planos Enterprise o contador diminui 5 por segundo, com limite de 250; em todos os outros planos diminui 2, com limite de 50. Cada mensagem recebida custa duas ou três chamadas, então um fluxo constante e moderado nunca chega perto. Uma rajada chega: cinquenta clientes respondendo ao mesmo template em um minuto são até 150 chamadas. Configure os nós HTTP Request para repetir em caso de falha com uma espera curta e execute as execuções do workflow uma de cada vez, para que a rajada escoe para o Bitrix24 em vez de bater e voltar. ### As respostas digitadas no celular chegam ao Bitrix24? Podem chegar. Em um número com Coexistência, o app do WhatsApp Business continua funcionando e, quando alguém responde por ele, a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes. Uma segunda ramificação do workflow trata esses ecos como as mensagens recebidas, com o comentário marcado como enviado. O registro passa a mostrar a conversa completa, com as falas do cliente e as respostas da loja em ordem. As respostas que o próprio workflow envia pela Cloud API já estão em poder dele na hora do envio, então registre-as nesse momento em vez de esperar um webhook voltar. - Colar a URL do webhook de entrada em código do lado do cliente ou em um documento compartilhado. O segredo nela concede todos os escopos dados ao webhook. - Criar o webhook com um usuário que não vê todos os leads. As buscas deixam registros de fora e o workflow cria duplicatas. - Enviar uma rajada de chamadas sem repetição. O Bitrix24 responde 503 QUERY_LIMIT_EXCEEDED e essas mensagens nunca chegam à linha do tempo. **As conversas aparecem nos Open Channels do Bitrix24?** Não com este workflow. Ele grava leads e comentários na linha do tempo pela API REST do CRM, e a conversa é respondida pelo app do 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 na URL do webhook de entrada. **O workflow pode enviar um template do WhatsApp a partir de dados do Bitrix24?** Sim. O n8n lê o que precisa do Bitrix24 e envia o template aprovado pela Cloud API com o phone_number_id e o token do número. **A EasyCoexistence armazena as mensagens?** Não. A Meta entrega cada webhook direto na sua URL do n8n. A EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Transforme contatos do WhatsApp em conversões do RD Station Marketing https://easycoexistence.com/pt/integrations/rd-station Direcione os webhooks do número para um workflow do n8n e, para cada remetente, envie um POST com um evento de conversão ao RD Station Marketing em api.rd.services/platform/conversions, usando sua API key. O RD Station aceita telefone no lugar de email, então um contato do WhatsApp sem email ainda vira lead, com tags e pronto para seus fluxos de automação. A equipe continua respondendo pelo celular. ### Como uma mensagem do WhatsApp vira um lead no RD Station? A Meta envia cada mensagem recebida no número para o destino de webhook que você definiu, aqui um nó Webhook do n8n. O workflow lê o número e o nome de perfil do remetente no payload e faz um HTTP POST para o endpoint de conversões do RD Station Marketing, com a API key na query string. O corpo leva event_type definido como CONVERSION, event_family definido como CDP e um payload com um conversion_identifier que você escolhe, como whatsapp-inbound. Dentro do payload vão o name, o mobile_phone e as tags que quiser. O RD Station cria o contato se ele for novo e registra a conversão de qualquer forma, então o histórico do contato mostra que ele chegou pelo WhatsApp e quando. Daí em diante é o RD Station de sempre: segmente pela conversão ou pela tag e deixe seus fluxos de automação assumirem. ### Toda mensagem deve ser uma conversão? Não, e essa é a decisão de design mais importante. Um cliente que manda oito linhas curtas seguidas registraria 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 depois de um intervalo que você escolher, como trinta dias. O n8n pode guardar a data da última conversão de cada número nos static data do workflow ou em uma tabela pequena e pular a chamada quando ela for recente. Use um conversion_identifier distinto para qualquer coisa mais específica que o primeiro contato. A resposta a um template promocional, uma mensagem com uma palavra-chave ou o toque em um botão de mensagem interativa podem ser, cada um, uma conversão própria, o que dá ao RD Station segmentos limpos para trabalhar, em vez de um fluxo único e indiferenciado. ### O RD Station pode disparar uma mensagem de volta no WhatsApp? Pelo workflow, sim. O RD Station Marketing pode disparar um webhook quando um lead converte ou é marcado como oportunidade, e um webhook do n8n no lado receptor pode enviar um template do WhatsApp aprovado pela Cloud API, usando o phone number id e o token de acesso do número no painel do EasyCoexistence. Os templates importam aqui porque o lead pode não ter escrito nas últimas 24 horas. Fora dessa janela de atendimento, só um template aprovado pela Meta é entregue; texto livre falha. Dentro dela, uma resposta de texto normal funciona. O app do WhatsApp Business no celular também mostra essas mensagens enviadas, já que a Coexistência mantém o app e a API no mesmo número. Um vendedor que assume a conversa no celular vê o que a automação já disse. - Enviar uma conversão a cada mensagem. Um cliente muito falante registra várias conversões e repete o mesmo fluxo de automação. - Postar a API key a partir de uma página de navegador que qualquer pessoa pode ler. Mantenha a chamada dentro do workflow do n8n, onde a chave fica privada. - Enviar texto livre 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 essa chamada ao RD Station?** Não. O endpoint de conversão autentica com a API key na query string, e enviar eventos de conversão é exatamente para isso que a chave serve. **E se o contato do WhatsApp não tiver email?** Envie o telefone. O RD Station só exige email em uma conversão quando nenhum telefone é informado. **Posso usar Make ou Zapier no lugar do n8n?** Sim. Qualquer ferramenta que receba o webhook e faça um HTTP POST pode enviar o mesmo corpo de conversão ao RD Station. **O EasyCoexistence armazena as mensagens?** Não. A Meta entrega o webhook para a URL do seu n8n, e o EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Conectar o WhatsApp aos contatos do GoHighLevel em um número com Coexistência https://easycoexistence.com/pt/integrations/gohighlevel Direcione os webhooks do número para um workflow do n8n, faça o upsert do remetente como contato do HighLevel com o nó HighLevel do n8n e grave cada mensagem como nota por meio de POST /contacts/{contactId}/notes. Autentique com um token de Private Integration, gerado nas configurações da subconta. Um único workflow pode atender todos os clientes, associando cada phone number id à sua subconta. ### Como uma mensagem do WhatsApp chega a um contato do HighLevel? A Meta envia cada mensagem recebida no número para o destino de webhook que você definiu, aqui um nó Webhook do n8n. O workflow passa o número do remetente e o nome de perfil do WhatsApp para o nó HighLevel do n8n, cujo recurso de contato tem uma operação de criar ou atualizar. Assim, um remetente novo vira contato e um já conhecido é encontrado, sem duplicar. Com o id do contato em mãos, um nó HTTP Request envia o texto da mensagem para /contacts/{contactId}/notes. A nota aparece no registro do contato, onde qualquer pessoa que o abra vê o que o cliente escreveu. Quando a mensagem pede um acompanhamento, o nó HighLevel também pode criar uma tarefa no contato ou uma oportunidade em um pipeline, e ambos são compatíveis diretamente. A equipe continua respondendo pelo app do WhatsApp Business o tempo todo. ### Qual token o workflow deve usar? Um token de Private Integration. A API v2 do HighLevel é acessada por OAuth ou por um desses tokens, e as antigas chaves da API v1 chegaram ao fim da vida útil. O token de Private Integration é criado nas configurações da subconta, limitado às permissões que você marcar, e enviado no cabeçalho Authorization como qualquer token de acesso. Ele não se renova sozinho, o que combina com uma automação: continua funcionando até alguém fazer a rotação. Quando você faz a rotação, o HighLevel mantém o token antigo e o novo válidos juntos por sete dias, e essa é a janela para colar o novo no n8n antes de o antigo parar. Marque apenas os escopos de que o workflow precisa: contatos, notas e, se você os usar, oportunidades e tarefas. Se não encontrar Private Integrations nas configurações, o HighLevel orienta ativar o recurso em Labs. ### Como um workflow atende várias subcontas de clientes? Roteando pelo número que recebeu a mensagem. Todo webhook enviado pela Meta inclui o phone_number_id do número comercial que recebeu a mensagem. Aponte o número de cada cliente para o mesmo webhook do n8n, mantenha uma tabela pequena que associa cada phone_number_id à subconta desse cliente e ao respectivo token, e busque o token no início de cada execução. Isso deixa um só workflow para manter em todos os clientes, o que importa mais para uma agência do que para qualquer outra pessoa. Uma correção na lógica de correspondência ou no formato da nota vale para todos de uma vez. Os limites de taxa são contados por app por subconta, então os clientes não consomem a cota uns dos outros: cada um tem suas 100 requisições a cada dez segundos e 200.000 por dia. ### As respostas digitadas no celular chegam ao HighLevel? Podem chegar. Em um número com Coexistência, o app do WhatsApp Business continua em uso, e quando alguém responde por ele a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes. Adicione uma ramificação para esses ecos e grave-os como notas marcadas como enviadas. O registro do contato passa a conter, em ordem, as falas do cliente e as respostas da empresa, que é o que um cliente espera ver ao abrir o CRM. Quando o próprio workflow envia uma mensagem pela Cloud API, por exemplo um template aprovado depois de um agendamento, grave a nota no momento do envio. O workflow já tem o texto e o id do contato. - Usar uma chave da API v1. A API v1 do HighLevel chegou ao fim da vida útil; a API v2 exige um token de Private Integration ou OAuth. - Fazer a rotação do token de Private Integration sem atualizar o n8n dentro da sobreposição de sete dias. Toda chamada falha quando o token antigo expira. - Gravar as mensagens de todos os clientes com o token de uma única subconta. Associe antes o phone_number_id à subconta correta, ou os registros caem no cliente errado. **As mensagens aparecem na aba Conversations do HighLevel?** Não com este workflow. Ele grava contatos, notas, tarefas e oportunidades pela API, e a conversa é respondida pelo app do WhatsApp Business ou pelo workflow. **Posso usar Make ou Zapier no lugar do n8n?** Sim. Um webhook personalizado ou catch hook recebe a mensagem, e uma etapa HTTP chama a API v2 do HighLevel com o mesmo token. **Um agendamento marcado pode enviar uma confirmação pelo WhatsApp?** Sim, pelo workflow. Quando o HighLevel chama a 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 armazena as mensagens?** Não. A Meta entrega cada webhook direto na sua URL do n8n, e a EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Use um número Coexistência como caixa de entrada WhatsApp Cloud do Chatwoot https://easycoexistence.com/pt/integrations/chatwoot A caixa de entrada WhatsApp Cloud do Chatwoot pede três valores: o WhatsApp Business Account id, o phone number id e um token de acesso. Um número Coexistência expõe os três. Crie a caixa de entrada com eles, depois defina o destino do webhook do número como a URL de webhook do Chatwoot, com o mesmo token de verificação, e a equipe responde pelo Chatwoot e pelo celular. ### Como conectar um número Coexistência ao Chatwoot? Em dois lugares, nesta ordem. No Chatwoot, adicione uma caixa de entrada, escolha WhatsApp e selecione o provedor WhatsApp Cloud com a configuração manual. Informe o número, o phone number id, o WhatsApp Business Account id e o token de acesso, todos exibidos no painel do EasyCoexistence para a conexão, ou retornados por get_api_credentials a um assistente. O Chatwoot então mostra uma URL de webhook e um token de verificação do webhook para a caixa de entrada. No EasyCoexistence, defina o destino do webhook do número como essa URL e informe o mesmo token de verificação. A Meta envia a requisição de verificação ao Chatwoot, o Chatwoot responde, e a partir daí toda mensagem para o número chega na caixa de entrada. Nada roda no meio, então não há workflow para manter vivo. ### As respostas enviadas pelo celular aparecem no Chatwoot? Sim. Em um número Coexistência, uma resposta digitada no app do WhatsApp Business é informada pela Meta como um evento smb_message_echoes, e o job de webhook do Chatwoot reconhece esse campo e registra a mensagem como enviada, na conversa certa. O código-fonte descreve o caso diretamente: empresas respondendo tanto pelo Chatwoot quanto pelo app, com as mensagens sincronizadas no Chatwoot. Isso faz a divisão funcionar na prática. O dono pode continuar atendendo clientes frequentes pelo celular, a equipe pode trabalhar a caixa de entrada compartilhada na mesa, e cada um vê o que o outro enviou, sem ninguém encaminhar prints. As mensagens enviadas pelo Chatwoot saem pela Cloud API no mesmo número, então também aparecem no celular. ### Por que a caixa de entrada do Chatwoot não deve ter segredo do app? Porque as entregas são assinadas com um segredo que você não tem. A Meta assina cada webhook com o segredo do app dono da assinatura, que é o app do EasyCoexistence, e esse segredo nunca é compartilhado. No código atual do Chatwoot, o cabeçalho X-Hub-Signature-256 de um canal WhatsApp Cloud configurado manualmente só é verificado quando um segredo do app foi armazenado nele, ou quando o canal foi criado pelo Embedded Signup do próprio Chatwoot. Uma caixa de entrada manual sem segredo do app aceita as entregas; uma com qualquer segredo do app preenchido rejeita todas como não autorizadas. O token de verificação é a proteção que vale aqui. Escolha um valor longo e aleatório, pois é ele que permite ao Chatwoot distinguir a requisição de verificação da Meta de qualquer outra. ### O que o Chatwoot não consegue fazer neste número? Receber webhooks em um segundo lugar ao mesmo tempo. A Meta encaminha os webhooks de um número para um único destino, então 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 repasse cada entrega ao Chatwoot e ao workflow. Os limites da Coexistência valem como em qualquer lugar: a API envia até 20 mensagens por segundo, texto livre só sai dentro de 24 horas após a última mensagem do cliente, e os templates cobrem todo o resto. O app do WhatsApp Business ainda precisa ser aberto pelo menos uma vez a cada 14 dias, e o EasyCoexistence vigia isso. - Preencher um segredo do app na caixa de entrada do Chatwoot. As entregas são assinadas com o segredo do app do EasyCoexistence, então o Chatwoot rejeita todas como não autorizadas. - Usar no EasyCoexistence um token de verificação diferente do que o Chatwoot mostra. A verificação da Meta falha e a caixa de entrada nunca recebe mensagem. - Escolher o Embedded Signup do Chatwoot em vez do fluxo manual. Isso conecta o número pelo app da Meta do próprio Chatwoot, uma conexão separada. **Isso funciona no Chatwoot hospedado por conta própria?** Sim. A 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 um app da Meta próprio para o Chatwoot?** Não. O número é conectado pelo EasyCoexistence, que fornece as credenciais e encaminha os webhooks. O guia do Chatwoot descreve a criação de um app da Meta só porque presume que você não tem nenhum. **Dá para colocar 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 a URL e o token de verificação da caixa de entrada correspondente. **O EasyCoexistence vê as conversas?** Não. A Meta entrega os webhooks direto ao Chatwoot, e o EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Registre mensagens do WhatsApp no Airtable e envie a partir de uma base https://easycoexistence.com/pt/integrations/airtable O gatilho de webhook de entrada do Airtable aceita apenas requisições POST, então 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 do n8n que adiciona cada mensagem a uma tabela. O envio funciona de dentro do Airtable: uma automação Run a script pode chamar a Cloud API com fetch e o token do número guardado como secret. ### Por que o Airtable não consegue receber webhooks do WhatsApp diretamente? Porque a Meta verifica o destino antes de entregar qualquer coisa. Ela envia uma requisição GET com um valor de desafio e espera receber o mesmo valor no corpo da resposta. O gatilho When webhook received do Airtable só aceita requisições POST e responde com um JSON fixo próprio, então a verificação não passa e a Meta nunca começa a entregar. A solução é um passo intermediário. Um nó Webhook do n8n cuida da verificação e recebe cada mensagem, e o nó Airtable do n8n adiciona uma linha: remetente, nome do perfil, texto, id da mensagem, horário e o phone number id que recebeu. O mesmo formato funciona no Make ou no Zapier. O passo intermediário traz um segundo benefício. O gatilho de webhook do Airtable permite cinco requisições por segundo, e uma ferramenta de workflow consegue enfileirar um pico que, de outra forma, seria recusado. ### Como enviar um template de WhatsApp a partir de uma base do Airtable? Com uma automação cuja ação é Run a script. O gatilho pode ser um registro entrando em uma view, um campo mudando ou um botão sendo clicado. O script lê o telefone e os campos do registro por input.config() e chama o endpoint de mensagens da Cloud API com fetch. Os scripts de automação do Airtable rodam no servidor, então não há restrição de navegador no caminho. Guarde o token de acesso como secret no editor de scripts, e não no código. O Airtable oculta os secrets na saída do console e só deixa editar o script quem tem acesso a todos os secrets dele. Use um template para qualquer contato que o cliente não tenha iniciado nas últimas 24 horas, já que texto livre só é entregue dentro dessa janela de atendimento. O script pode gravar de volta no registro o id da mensagem retornado, o que liga o envio à linha. ### Como deve ser a tabela de mensagens? Uma linha por mensagem, com o id da mensagem do WhatsApp como campo primário. A Meta repete as entregas que considera falhas, e um workflow que consulta o id antes de adicionar nunca grava a mesma mensagem duas vezes. Mantenha um campo de direção com inbound e outbound. Em um número Coexistência, as respostas que a equipe digita no app do WhatsApp Business chegam ao mesmo webhook como eventos smb_message_echoes, e registrá-las como linhas outbound dá à base a conversa completa, e não só um lado dela. Ligue cada mensagem a uma tabela Contacts com chave no telefone só com dígitos, que é a forma que a Meta envia. Um rollup mostra então o horário da última mensagem inbound de cada contato, e esse único campo é o que uma automação precisa para decidir entre texto livre e template. - Definir a URL de um webhook do Airtable como destino do número. Ele aceita só POST, o GET de verificação da Meta falha e nada é entregue. - Colar o token de acesso no corpo do script. Guarde-o como secret do script para que fique fora do código e dos logs. - Enviar texto livre de uma automação de registro para quem não escreveu nas últimas 24 horas. Só um template aprovado é entregue. **O Run a script está disponível no plano gratuito do Airtable?** O Airtable lista a ação em todos os tipos de plano, com limitações variadas, e informa que ela não está disponível no trial do plano Team. **Posso dispensar o n8n e usar Make ou Zapier?** Sim. Qualquer um dos três pode receber o webhook, responder à verificação e adicionar 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 gatilho When a button is clicked com uma ação Run a script que chama a Cloud API, e os dados da linha preenchem o template. **A EasyCoexistence armazena as mensagens?** Não. A Meta entrega cada webhook na URL do seu n8n, e a única cópia é a que o seu workflow grava no Airtable. --- ## Registre mensagens do WhatsApp no Google Sheets e envie a partir de uma planilha https://easycoexistence.com/pt/integrations/google-sheets Aponte o destino do webhook do número para um workflow do n8n cujo nó do Google Sheets adiciona uma linha por mensagem: remetente, nome, texto, id da mensagem e horário. Para enviar a partir da planilha, uma função do 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 equipe continua respondendo pelo app do WhatsApp Business. ### Como cada mensagem do WhatsApp vira uma linha? A Meta envia cada mensagem do número para o destino do webhook que você definiu, aqui um nó Webhook do n8n que também responde à requisição 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 do perfil, o texto, o id da mensagem do WhatsApp, o horário e o phone number id que recebeu. Use Append or Update Row com chave no id da mensagem, em vez de um append simples, se quiser que repetições sejam inofensivas. A Meta reenvia uma mensagem quando acha que uma entrega falhou, e a chave no id transforma a segunda entrega em uma atualização da mesma linha. Em um número com Coexistência, as respostas digitadas no app do WhatsApp Business chegam ao mesmo webhook como eventos smb_message_echoes. Registre-as com uma coluna de direção e a planilha guarda os dois lados. ### Onde a cota do Sheets pesa? Nas escritas por usuário. A API do Sheets permite 300 requisições de escrita por minuto por projeto e 60 por minuto por usuário por projeto, e uma credencial do n8n é um usuário. Um workflow que adiciona uma linha por mensagem aguenta, portanto, cerca de uma mensagem por segundo, de forma contínua. Isso é de sobra para a maioria dos números de loja. Deixa de ser depois de um template em massa, quando algumas centenas de clientes respondem em poucos minutos. A API então devolve 429 Too Many Requests e, sem repetições, linhas se perdem. Há duas correções, e qualquer uma basta. Ative as repetições com espera no nó do Google Sheets, o que segue o conselho do próprio Google de recuar de forma exponencial. Ou agrupe: faça o n8n juntar as mensagens por trinta segundos e adicioná-las em uma única requisição, transformando várias escritas em uma. ### Como enviar templates a partir de uma planilha? Com o Apps Script, pelo menu Extensões da planilha. Uma função lê as linhas ainda não enviadas, chama o endpoint de mensagens da Cloud API com UrlFetchApp para cada uma e grava o id da mensagem retornado e o horário na linha. Um gatilho por tempo pode executá-la a cada poucos minutos, ou você pode rodá-la manualmente em 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 veja o token. Lembre-se das cotas. Uma conta Google pessoal tem 20.000 chamadas de URL Fetch por dia e uma conta Workspace 100.000, e cada execução é interrompida após seis minutos. Processe as linhas em blocos e marque cada uma como enviada antes de seguir, para que uma execução interrompida continue de onde parou em vez de enviar duas vezes. - Adicionar linhas sem chave no id da mensagem. As repetições da Meta então gravam a mesma mensagem em duas linhas. - Gravar uma linha por mensagem por uma única credencial durante um pico de respostas. O limite de 60 escritas por minuto por usuário devolve 429 e linhas se perdem. - Enviar texto livre da planilha para pessoas que não escreveram nas últimas 24 horas. Só um template aprovado é entregue fora dessa janela de atendimento. **Posso usar Make ou Zapier em vez do n8n?** Sim. Um webhook personalizado do Make ou um catch hook do Zapier recebe a mensagem, e o passo do Google Sheets deles adiciona a linha. **Com qual conta Google o n8n escreve?** Com a que autorizou a credencial Google do n8n. Essa conta precisa de acesso de edição à planilha, e a cota de escrita por usuário dela é a que o workflow consome. **A coluna de telefone está formatada corretamente?** Guarde os números como texto simples, só dígitos com código do país e sem o sinal de mais, que é a forma como a Meta envia. Caso contrário, o Sheets os trata como números, o que remove 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 para a sua URL do n8n, e a planilha é a única cópia. --- ## Receba webhooks do WhatsApp em uma Edge Function do Supabase https://easycoexistence.com/pt/integrations/supabase Uma Edge Function do Supabase pode ser diretamente o destino do webhook do número. Ela responde ao GET de verificação da Meta com o valor de hub.challenge, insere cada mensagem recebida por POST em uma tabela do Postgres e responde pela Cloud API. Faça o deploy com a verificação de JWT desativada, porque o Supabase exige um JWT válido por padrão e a Meta não consegue enviar um. ### O que a Edge Function precisa fazer? Duas coisas, em dois métodos. No GET, ela responde à verificação da Meta. Leia hub.mode, hub.verify_token e hub.challenge na query string, compare o token com o que você informou como verify token do destino e devolva o challenge como corpo em texto simples, com status 200. Retorne 403 quando o token não bater. No POST, ela recebe os eventos. Faça o parse do corpo, extraia as mensagens de entry, changes e value, insira-as em uma tabela e retorne 200. Mantenha a resposta rápida: a Meta trata uma resposta lenta ou com falha como entrega que falhou e repete o envio, o que significa a mesma mensagem duas vezes. Defina a 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. ### Por que a função retorna 401 para a Meta? Porque a verificação de JWT está ativada. O Supabase valida um JWT no header Authorization antes de o handler de uma Edge Function rodar, e esse é o padrão de toda função. A Meta não envia esse header, então a plataforma rejeita tanto o GET de verificação quanto cada entrega, e o seu código nunca as vê. Desative a verificação só para esta função. Faça o deploy com supabase functions deploy whatsapp --no-verify-jwt ou defina verify_jwt = false na seção da função em supabase/config.toml. A documentação do Supabase descreve exatamente este caso: um endpoint público chamado por um provedor de webhook externo. Com a checagem da plataforma desligada, a função precisa ter a sua própria. O header de assinatura não está disponível para você, já que a Meta assina com o app secret do app dono da assinatura. Coloque um segredo longo e aleatório na URL do destino como parâmetro de query e rejeite requisições sem ele, como o exemplo faz no POST. ### Como a função deve armazenar e responder? Armazene primeiro, responda depois. Faça upsert pelo id da mensagem do WhatsApp, com uma constraint de unicidade, para que as repetições da Meta caiam na mesma linha em vez de criar duplicata. Guarde o phone_number_id que recebeu a mensagem em cada linha se mais de um número apontar para a função. Para qualquer trabalho lento, como chamar um modelo ou outra API antes de responder, entregue o trabalho ao EdgeRuntime.waitUntil e devolva a resposta de imediato. A função continua rodando até essa promise terminar, enquanto a Meta já recebeu o 200. O Supabase para de esperar após 150 segundos de inatividade e retorna 504, então um handler que faz todo o trabalho antes de responder é o que mais provoca repetições. As respostas vão 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. Dentro de 24 horas da última mensagem do cliente, texto livre é entregue; fora dessa janela, só um template aprovado. ### As mensagens enviadas pelo celular chegam à função? Sim. Em um número com Coexistência, o app do WhatsApp Business continua funcionando e, quando alguém responde por ele, a Meta entrega um eco dessa mensagem enviada ao mesmo destino, no campo smb_message_echoes e em um array message_echoes, e não em messages. Estenda o parser para ler os dois e guardar uma coluna de direção. A tabela passa a conter a conversa completa, as falas do cliente e as respostas da empresa, que é o que a maioria quer consultar depois: tempos de resposta, conversas sem resposta, o horário da última mensagem recebida por contato. Esse último valor também é o dado de que todo caminho de envio precisa, pois ele decide se a resposta pode ser texto livre ou tem de ser um template. Uma view sobre a tabela pode expô-lo por contato para o resto do seu app. - Fazer o deploy com a verificação de JWT ativada. O Supabase rejeita as requisições da Meta com 401 antes de o handler rodar, e nenhuma mensagem chega. - Devolver o challenge dentro de JSON. A Meta precisa do valor puro como corpo, ou a verificação falha em silêncio. - Fazer trabalho lento antes de responder. A Meta repete o que vê como falha, e a mesma mensagem é processada duas vezes. - Desativar a verificação de JWT sem nenhuma checagem própria. Qualquer pessoa que descobrir a URL pode inserir mensagens falsas na tabela. **Isso funciona no plano gratuito do Supabase?** As Edge Functions rodam no plano gratuito, com limite de 150 segundos de tempo total de execução contra 400 segundos nos planos pagos. Um handler de webhook que responde rápido fica bem dentro de ambos. **Devo usar a service role key na função?** Só no servidor, como aqui, lida do ambiente da função. Ela ignora a Row Level Security, então nunca pode chegar a um navegador. **Uma função pode atender vários números?** Sim. Aponte o destino do webhook de cada número para ela e separe a lógica pelo phone_number_id de cada payload. **O EasyCoexistence vê as mensagens?** Não. A Meta entrega cada webhook direto à sua função, e o EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Conecte o WhatsApp ao Activepieces em um número com Coexistência https://easycoexistence.com/pt/integrations/activepieces O Activepieces tem uma piece do WhatsApp Business que se conecta com um token de acesso e o id da conta do WhatsApp Business, e um número com Coexistência expõe os dois. O trigger New Incoming Message responde sozinho à verificação da Meta, então a URL dele pode ser o destino do webhook do número. Deixe vazio o app secret opcional da piece, e o fluxo roda a cada mensagem enquanto a equipe continua com o celular. ### Como conectar um número com Coexistência ao Activepieces? Crie a conexão do WhatsApp Business no Activepieces com dois valores: o token de acesso e o id da conta do WhatsApp Business. O painel do EasyCoexistence mostra os dois para a conexão, e get_api_credentials os devolve a um assistente. As instruções da piece falam em criar um app da Meta e um usuário de sistema, porque supõem que você não tem nenhum dos dois. Aqui o número já está conectado, então vá direto a colar os valores. Depois monte um fluxo que comece com o trigger New Incoming Message, defina nele um verify token à sua escolha e publique o fluxo. Copie a URL de webhook do trigger para o destino do webhook do número no EasyCoexistence, com o mesmo verify token. A Meta envia a requisição de verificação, o trigger responde, e cada mensagem para o número inicia uma execução. ### Por que o app secret deve ficar vazio? Porque o segredo que assina essas entregas não é seu para colar. A Meta assina cada webhook com o app secret do app dono da assinatura, e em um número conectado pelo EasyCoexistence esse app é o do EasyCoexistence, cujo segredo nunca é compartilhado. A piece trata o campo como opcional. Vazio, os triggers aceitam as entregas como chegam. Preenchido com o segredo de qualquer outro app, toda entrega falha na checagem do X-Hub-Signature-256 e é ignorada em silêncio, o que parece exatamente mensagens que não chegam. O verify token é o que mantém estranhos fora do handshake. Escolha um valor longo e aleatório e mantenha a URL do trigger privada, pois é o endereço que inicia o seu fluxo. ### O que um fluxo pode fazer quando a mensagem chega? O trigger entrega ao fluxo uma mensagem achatada: remetente, nome do perfil, id da mensagem, tipo, texto, eventual id de mídia, respostas de botão e de lista, e o id do número que recebeu. A partir daí é um fluxo comum do Activepieces com as outras pieces, como um CRM, uma planilha ou uma etapa de IA. As respostas usam a mesma piece. Send Message envia texto livre, e só entrega dentro de 24 horas da última mensagem do cliente. Send Template Message envia um template aprovado, a única coisa que entrega depois dessa janela de atendimento. Botões interativos, listas, mídia, localização e reações são ações próprias. As próprias instruções do Activepieces observam que a Meta aceita uma URL de callback por app. Com destinos por número, o limite é uma URL por número, então um fluxo que precise tratar vários tipos de evento deve ramificar dentro de um só fluxo. ### As respostas digitadas no celular chegam ao fluxo? Chegam ao webhook, mas não a este trigger. Em um número com Coexistência, a Meta envia um eco de cada resposta digitada no app do WhatsApp Business ao mesmo destino, no campo smb_message_echoes. O trigger New Incoming Message da piece lê apenas o campo messages e descarta o resto. Se você precisa das respostas do celular no fluxo, comece com a piece genérica Webhook do Activepieces, que aceita qualquer método HTTP, e responda ao GET de verificação com uma etapa Return Response na URL síncrona. Depois você interpreta o payload bruto por conta própria, com os dois campos. Para a maioria dos fluxos, o trigger da piece é a escolha mais simples: ele reage aos clientes, e as respostas da equipe continuam visíveis no app do celular. - Colar um app secret na conexão do WhatsApp. As entregas são assinadas com o segredo do app do EasyCoexistence, então todas são ignoradas. - Definir o destino antes de publicar o fluxo. A Meta verifica na hora e um fluxo não publicado não consegue responder. - Esperar que o trigger New Incoming Message veja as respostas digitadas no celular. Ele lê só o campo messages, não o smb_message_echoes. **Isso funciona no Activepieces self-hosted?** Sim. A piece é de código aberto e roda na nuvem do Activepieces ou self-hosted, desde que a instância seja acessível por HTTPS pela internet. **De qual número um fluxo envia?** Do que você escolher no campo de número da ação, que lista os números da conta do WhatsApp Business para a qual a conexão aponta. **Posso continuar usando n8n ou Make no mesmo número?** Não ao mesmo tempo. A Meta direciona os webhooks de um número a um único destino, então escolha uma ferramenta para receber, ou encaminhe dela para a outra. **O EasyCoexistence armazena as mensagens?** Não. A Meta entrega cada webhook direto ao trigger do Activepieces, e o EasyCoexistence nunca armazena o conteúdo das conversas. --- ## Rode um fluxo do Typebot no WhatsApp com Coexistência https://easycoexistence.com/pt/integrations/typebot O canal de WhatsApp do Typebot pede um token, o id de uma WhatsApp Business Account e um phone number id, e em troca entrega uma callback URL e um verify token. Preencha os três primeiros com os dados do número conectado, deixe vazio o app secret opcional do Typebot e defina a callback URL e o verify token dele como destino do webhook do número. ### Quais campos do Typebot recebem valores do número conectado? O assistente de WhatsApp do Typebot, na aba Share de um bot, pede quatro coisas: um app secret, um System User Token, um WhatsApp Business Account ID e um Phone number ID. Três deles vêm direto da conexão. O painel mostra o id da WABA, o phone number id e o token de acesso do número, e a ferramenta get_api_credentials devolve os mesmos valores se um assistente estiver buscando por você. Cole cada um no campo correspondente. O app secret é o que deve ficar em branco. O Typebot o usa para uma única coisa no tráfego de entrada: conferir o cabeçalho X-Hub-Signature-256 que a Meta adiciona a cada entrega. Para um número conectado por um Tech Provider, a Meta assina com o app secret do provedor, que nunca é compartilhado, então qualquer valor digitado ali faz o Typebot rejeitar todas as mensagens legítimas. Com o campo vazio, o Typebot pula essa checagem e aceita a entrega. ### Onde entram a callback URL e o verify token do Typebot? No destino do webhook do número, não no painel de um app da Meta. O assistente do Typebot manda colar a Callback URL e o Verify Token nas configurações de WhatsApp do seu próprio app da Meta. Com a Coexistência pela EasyCoexistence, não há app seu envolvido: a Meta roteia os eventos do número para o destino definido na conexão. Então copie os dois valores da última etapa do Typebot e defina-os como destino, no painel ou com set_webhook_destination. Em seguida a Meta envia o GET de verificação ao Typebot, o Typebot responde com o challenge e, a partir daí, toda mensagem para o número chega ao bot. O verify token do Typebot é de uso único: ele é apagado do banco de dados do Typebot assim que uma verificação dá certo. Se você definir o destino de novo mais tarde, gere antes um token novo rodando o assistente outra vez. ### O que o bot faz com a janela de 24 horas? O Typebot responde a quem escreveu para ele, o que mantém quase toda mensagem dentro da janela de atendimento. A Meta abre uma janela de 24 horas a cada vez que um cliente escreve e, dentro dela, qualquer tipo de mensagem de atendimento pode ser enviado sem template. Um bot que só responde é, portanto, o caso fácil. O limite aparece num fluxo que espera. Um bloco Wait, ou uma sessão retomada depois de o cliente ficar mais de um dia em silêncio, tentará enviar texto livre fora da janela, e a Meta o recusa com o erro 131047. O timeout de expiração de sessão do Typebot, de 4 horas por padrão e ajustável até 48, decide quando um cliente que volta começa uma nova conversa, não se a Meta aceita a mensagem. Como isso é Coexistência, a equipe continua vendo todas as conversas no app do WhatsApp Business e pode assumir pelo celular sempre que o bot não deva responder. - Colar no Typebot o app secret de um app da Meta. As entregas são assinadas com o secret do Tech Provider, então o Typebot rejeita toda mensagem por assinatura inválida. - Reaproveitar um verify token antigo do Typebot. Ele é apagado após uma verificação bem-sucedida, então definir o destino de novo exige um token novo do assistente. - Compartilhar a callback URL. Com a checagem de assinatura desligada, conhecer a URL é o que permite enviar uma requisição, então trate-a como uma senha. **Preciso de um app próprio da Meta para usar o Typebot?** Não. O guia do Typebot pressupõe um porque a maioria das pessoas conecta o número por conta própria. Com a Coexistência por um Tech Provider, o token e os ids vêm da conexão e a Meta roteia o webhook para o Typebot. **A equipe ainda verá no celular as mensagens do bot?** Sim. As mensagens enviadas pela Cloud API aparecem no app do WhatsApp Business no mesmo número, então uma pessoa pode ler a conversa e assumir. **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 os dois precisam dos eventos, aponte o destino para o n8n e faça o fluxo encaminhar o payload bruto para a callback URL do Typebot. **O Typebot armazena as conversas?** O Typebot guarda seus próprios dados de sessão e resultados, como em qualquer canal. A EasyCoexistence nunca armazena o conteúdo das mensagens: a Meta entrega direto no destino que você definir. --- ## Conectar um bot do Botpress ao WhatsApp com Coexistência https://easycoexistence.com/pt/integrations/botpress Use a integração de WhatsApp do Botpress em Manual Configuration. Cole o access token e o phone number id do número conectado, escolha um verify token e deixe App ID e Client Secret vazios. Depois defina a URL de webhook do Botpress e esse verify token como destino do webhook do número, e a Meta entrega cada mensagem ao bot. ### Qual configuração do Botpress funciona com um número em Coexistência? Manual Configuration. As outras opções conectam um número pelo app da Meta do próprio Botpress, o que é um novo onboarding do número, e não uma forma de usar um número que já está conectado. Na integração de WhatsApp, abra o menu suspenso Configuration e escolha Manual Configuration. Ele 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 conexão: o painel mostra os três, e get_api_credentials os devolve a um assistente. O verify token é qualquer texto que você 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 o marca como opcional e diz que, sem ele, a verificação de assinatura é ignorada. Isso importa, porque a Meta assina cada entrega com o app secret do Tech Provider, que nenhum cliente possui. ### Como o webhook do Botpress recebe as mensagens da Meta? Pelo destino do webhook do número. O guia do Botpress manda colar a URL de webhook dele e o seu verify token na configuração de WhatsApp de um app da Meta. Aqui você não tem um app da Meta: a Meta encaminha os eventos do número para o destino que a conexão indicar. Então copie a URL de webhook que o Botpress mostra para a integração e defina-a, 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 e a entrega começa. Quando o Botpress salva uma configuração manual, ele também confere o token perguntando ao Graph qual app o emitiu, então um token inválido ou revogado falha na hora de salvar, e não na primeira mensagem. O handler do Botpress também processa smb_message_echoes, o evento que a Meta envia quando alguém responde pelo app do WhatsApp Business. Assim, uma resposta dada pelo celular fica visível para o bot, em vez de invisível. ### O que o bot precisa saber sobre a Coexistência? Que um humano pode já estar conversando. O app do WhatsApp Business continua funcionando no número, então um cliente pode receber uma resposta do celular e outra do bot no mesmo minuto. Defina no fluxo o que acontece quando um eco chega: a maioria das equipes pausa o bot para aquele contato por um tempo, para não falar por cima de quem entrou na conversa. O segundo ponto é o tempo. Um bot que responde mensagens recebidas trabalha dentro da janela de atendimento de 24 horas, em que texto livre é permitido. Um fluxo que envia algo um dia depois, um acompanhamento ou um lembrete, precisa de um template aprovado, e texto livre nesse caso retorna o erro 131047. O guia do Botpress assina os campos de status de template justamente para esse tipo de mensagem proativa. E o throughput é fixo em 20 mensagens por segundo para um número em Coexistência, muito acima do que um bot conversacional envia. - Preencher o Client Secret com o secret do seu próprio app da Meta. A assinatura nunca confere e o Botpress responde 401 a cada entrega. - Escolher a opção OAuth ou sandbox em vez de Manual Configuration. Elas conectam um número pelo app do próprio Botpress, e não pelo que já está conectado. - Ignorar os ecos. Sem uma regra para respostas enviadas pelo celular, o bot responde por cima de uma pessoa que já entrou na conversa. **Ignorar a verificação de assinatura é seguro?** A proteção passa para a URL. O Botpress gera a URL de webhook por integração, então mantenha-a privada. A mídia ainda precisa ser buscada na Meta com o token, algo que um evento forjado não consegue fazer. **O mesmo número também pode alimentar o n8n?** Um número tem um único destino de webhook. Aponte-o para um sistema e encaminhe a partir dele se um segundo precisar dos eventos. **O Botpress precisa do meu WABA id?** A definição o marca como opcional por enquanto e diz que ele será obrigatório em uma versão principal futura, então preencha-o com o dado da conexão. **As mensagens passam pela EasyCoexistence?** Não. A Meta entrega direto na URL de webhook do Botpress, e o conteúdo nunca é armazenado do nosso lado. --- ## Responda mensagens do WhatsApp com um app do Dify https://easycoexistence.com/pt/integrations/dify Aponte o webhook do número para um receptor pequeno, como um workflow do n8n ou uma rota no seu próprio código, que repasse cada mensagem à Send Chat Message API do Dify e devolva a resposta pela Cloud API. Dentro do Dify, o servidor MCP da EasyCoexistence pode ser adicionado como ferramenta para que o agente atue no próprio número. ### A Meta pode enviar mensagens do WhatsApp direto para o Dify? Não de um jeito que complete o handshake. Antes de entregar qualquer coisa, a Meta chama o destino com um GET e espera receber o valor de hub.challenge de volta como corpo bruto da resposta. O Webhook Trigger do Dify aceita um método HTTP por trigger, e a documentação dele diz que um corpo de resposta que não seja JSON é convertido automaticamente em JSON, então OK volta como um objeto de mensagem. O challenge nunca pode ser devolvido exatamente, e a Meta nunca começa a entregar. Por isso, algo pequeno fica na frente. Um nó Webhook do n8n, uma rota em Python ou Node, ou uma função serverless responde ao GET, aceita o POST e repassa o texto ao Dify. Esse receptor também é onde se confere o segredo longo e aleatório na URL do webhook, já que o cabeçalho X-Hub-Signature-256 é assinado com o app secret do Tech Provider e não pode ser validado pelo cliente. ### Como o receptor conversa com o app do Dify? Com uma chamada à Service API do Dify: POST /chat-messages, autenticada com a chave de API do app. O corpo leva query, o texto do cliente, e user, um identificador que você define. Use o número de WhatsApp de quem enviou como user e guarde o conversation_id que o Dify devolve, para que a próxima mensagem da mesma pessoa continue a mesma conversa. O response_mode importa. O modo blocking responde 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 borda. Apps do tipo Agent aceitam apenas streaming, e uma requisição blocking a eles falha com 400. Um receptor que lê o stream e envia uma única mensagem de WhatsApp no final é o formato robusto. A resposta então sai como mensagem de texto da Cloud API para o mesmo número, o que é gratuito dentro da janela de atendimento de 24 horas aberta pela mensagem do cliente. ### O que o servidor MCP acrescenta dentro do Dify? A capacidade de um agente do Dify atuar no número sem que você precise ligar cada chamada. O Dify se conecta a servidores MCP por HTTP e, por padrão, se registra no servidor por registro dinâmico de cliente OAuth, que é o que o servidor MCP da EasyCoexistence suporta. Adicione-o em Tools, entre uma vez, e o agente recebe as ferramentas: listar os números, verificar a saúde de um número, enviar uma mensagem, enviar um template aprovado, ler o status de um template de mensagem. Esse é o lugar certo para o trabalho proativo: um workflow do Dify que faz o acompanhamento no dia seguinte precisa usar send_template, porque texto livre fora da janela devolve o erro 131047, e as descrições das ferramentas avisam o modelo disso. O que o MCP não consegue fazer é acordar o Dify quando um cliente escreve. O protocolo é de requisição e resposta, então as mensagens recebidas continuam chegando pelo webhook e pelo receptor na frente. - Usar a URL de um Webhook Trigger do Dify como destino do webhook. O challenge volta embrulhado em JSON e a Meta nunca verifica o endpoint. - Enviar uma requisição blocking a um app Agent do Dify. Apps Agent aceitam apenas streaming, e a chamada falha com 400. - Usar um valor de user novo a cada mensagem. O Dify delimita as conversas por user, então cada mensagem inicia uma conversa nova, sem memória. **O Dify tem um canal de WhatsApp?** Não na documentação dele. Um app do Dify é acessível pela Service API, então o WhatsApp se conecta por um receptor que chama essa API. **O n8n pode ser o receptor?** Sim. Um nó Webhook recebe, um nó HTTP Request chama o Dify e um segundo nó HTTP Request envia a resposta pela Cloud API. **A equipe ainda pode responder pelo celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no número, e as respostas enviadas pelo celular chegam ao receptor como eventos de echo. **A EasyCoexistence vê a conversa?** Não. A Meta entrega direto ao seu receptor e o conteúdo das mensagens nunca é armazenado do nosso lado. O servidor MCP lê o estado da conta e do número. --- ## Responda mensagens do WhatsApp com um chatflow do Flowise https://easycoexistence.com/pt/integrations/flowise Aponte o destino do webhook do número para um pequeno receptor, como um workflow do n8n ou uma rota no seu próprio código. Ele repassa cada mensagem à Prediction API do Flowise, com o número do remetente como ID de sessão, e envia a resposta de volta pela Cloud API com o token e o phone number id do número. ### Por que o Flowise precisa de algo na frente dele? Porque o webhook da Meta e a API do Flowise falam formatos diferentes. A Meta verifica um destino com um GET que precisa devolver hub.challenge como corpo bruto e depois entrega cada mensagem como um POST em JSON aninhado. A Prediction API do Flowise espera um POST em /api/v1/prediction/ seguido do ID do flow, com um campo question. Nenhum dos dois se adapta ao outro, então um receptor faz a tradução. O receptor pode ser um nó Webhook do n8n, uma rota em Python ou Node, ou qualquer função serverless. Ele responde ao GET de verificação, confere um segredo longo e aleatório colocado na URL do webhook, responde 200 à Meta na hora e só então faz o trabalho. O segredo na URL é a autenticação que funciona aqui: a Meta assina as entregas com o app secret do Tech Provider, que nunca é compartilhado, então o header X-Hub-Signature-256 não pode ser validado do seu lado. ### Como o receptor deve 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 requisição, e um sessionId dentro dele é o que permite aos nós de memória manter uma conversa por pessoa, em vez de misturar todo mundo numa só thread. O número do remetente no payload do webhook é uma chave estável e natural para isso. Se o chatflow estiver protegido por uma API key, o receptor a envia como bearer token. Defina streaming como false, a menos que o receptor esteja preparado para montar um stream, já que o WhatsApp entrega uma mensagem pronta, e não um token por vez. A resposta sai como uma mensagem de texto da Cloud API, do mesmo número. Isso é gratuito e permitido dentro da janela de atendimento de 24 horas que a mensagem do cliente abriu. Qualquer coisa que o flow queira enviar depois, como um lembrete, precisa ser um template aprovado. ### Um agente do Flowise pode usar o servidor MCP da EasyCoexistence? Hoje não. O Custom MCP do Flowise se conecta a um servidor Streamable HTTP com uma URL e um conjunto de headers, normalmente um bearer token estático guardado numa variável do Flowise. O servidor MCP da EasyCoexistence autentica com OAuth, com login no navegador e tokens emitidos por ele mesmo, então não existe uma chave estática para colocar num header. A divisão que funciona é deixar o flow decidir e o receptor enviar. O flow devolve o texto a dizer, ou o nome de um template quando o cliente está em silêncio há mais de um dia, e o receptor 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, conferindo quando o contato escreveu pela última vez, em vez de ficar a cargo de um modelo que pode esquecê-la. As mensagens recebidas continuam chegando apenas pelo webhook, seja qual for a forma de envio. - Omitir o sessionId. Todos os clientes passam a compartilhar a mesma memória, e os dados de uma pessoa podem aparecer na resposta de outra. - Esperar o Flowise para responder à Meta. Um 200 lento faz a Meta repetir a entrega, e a mesma mensagem é processada duas vezes. - Deixar o flow enviar texto livre um dia depois. Fora da janela de atendimento, a Meta recusa com o erro 131047. **O Flowise tem um nó de WhatsApp?** Não na documentação dele. O acesso é pela Prediction API, e por isso um receptor fica entre a Meta e o flow. **O n8n pode ser o receptor?** Sim. Um nó Webhook recebe, um nó HTTP Request chama o Flowise e outro nó HTTP Request envia a resposta pela Cloud API. **Como faço o bot parar quando uma pessoa responde pelo celular?** Observe os eventos de echo. Uma resposta enviada pelo app do WhatsApp Business chega ao receptor, que pode pausar o flow para aquele contato. **A EasyCoexistence armazena a conversa?** Não. A Meta entrega direto ao seu receptor. O Flowise guarda o que os nós de memória dele estiverem configurados para guardar. --- ## Dê um número de WhatsApp a um agente LangChain https://easycoexistence.com/pt/integrations/langchain Um agente LangChain recebe o WhatsApp em duas metades. As mensagens recebidas chegam à sua rota web pelo webhook do número, e a rota invoca o agente. Para agir, o agente carrega as ferramentas MCP do EasyCoexistence pelo MCPAdapter do LangChain com OAuth, ou chama a Cloud API diretamente com o token e o phone number id do número. ### Como um agente LangChain carrega as ferramentas do WhatsApp? Pelo MCPAdapter, o cliente MCP do LangChain, que entrega as ferramentas de um servidor MCP ao create_agent como ferramentas comuns do LangChain. Ele exige langchain[mcp] na versão 1.4.0 ou superior e está marcado como beta. A autenticação é delegada ao FastMCP. Passar auth="oauth" no cliente executa o fluxo OAuth 2.1 completo: descoberta, registro dinâmico de cliente, redirecionamento no navegador e troca de token. É isso que o servidor MCP do EasyCoexistence espera, então não há chave para criar nem colar. Por padrão os tokens ficam na memória e cada execução repete a etapa do navegador; um provedor OAuth do FastMCP com armazenamento de tokens os mantém entre execuções. Depois de carregadas, o agente vê as ferramentas com suas descrições: list_numbers primeiro, porque todas as outras pedem um connection_id vindo dela, depois send_message, send_template, list_templates, get_number_health e as demais. ### Como uma mensagem recebida do WhatsApp chega ao agente? Pelo webhook, porque o MCP não consegue fazer isso. O protocolo é de requisição e resposta, então nada nele permite que um servidor acorde um cliente quando um cliente escreve. Aponte o destino do webhook do número para uma rota da sua própria aplicação, com um segredo longo e aleatório no caminho da URL. A rota responde ao GET de verificação da Meta com o challenge bruto, aceita cada POST, retorna 200 imediatamente e enfileira o trabalho. Um worker então extrai o remetente e o texto do payload e invoca o agente com eles, usando o número do remetente como id da thread para que a memória fique separada por cliente. Verifique o segredo na URL, e não o cabeçalho X-Hub-Signature-256. A Meta assina com o app secret do Tech Provider, que nunca é compartilhado, então esse cabeçalho não pode ser validado pelo cliente. ### O agente deve enviar pelo MCP ou pela Cloud API? Os dois funcionam, e a diferença está em quem guarda as regras. As ferramentas MCP carregam as regras do WhatsApp em suas descrições, como send_message funcionar só dentro da janela de atendimento de 24 horas e send_template ser o caminho para alcançar 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 faz POST no endpoint de mensagens da Cloud API com o token do número, é mais simples quando a tarefa do agente é restrita, como sempre responder a quem acabou de escrever. Aí a checagem da janela fica no seu código, que é onde pertence uma regra que nunca pode ser quebrada. Texto livre fora da janela volta com 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 na memória em um servidor. Cada reinício pede um login no navegador; persista-os com um armazenamento de tokens. - Usar uma única thread para todos os clientes. Associe a memória do agente ao número do remetente. **Isso é só para Python?** O exemplo do MCPAdapter é em Python. O webhook e a Cloud API são HTTP puro, então qualquer linguagem em que o LangChain rode pode receber e enviar. **O agente precisa chamar list_numbers toda vez?** Ele precisa de um connection_id, e list_numbers é o único lugar de onde ele vem. Com um único número, o agente a chama uma vez no início. **A equipe ainda pode responder pelo celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando, e as respostas feitas no celular chegam à sua rota como eventos echo que o agente pode levar em conta. **O EasyCoexistence lê a conversa?** Não. A Meta entrega direto na sua rota e o conteúdo das mensagens nunca é armazenado por nós. As ferramentas MCP leem o estado da conta e do número. --- ## Coloque um agente do OpenAI Agents SDK no WhatsApp https://easycoexistence.com/pt/integrations/openai-agents-sdk Defina o destino do webhook do número como uma rota no seu app Python. A cada mensagem recebida, rode o agente com Runner.run e uma sessão com chave no número do remetente, depois envie result.final_output de volta pela Cloud API com o token do número e o ID do número de telefone. O app do WhatsApp Business continua funcionando no mesmo número. ### Como uma mensagem do WhatsApp vira uma execução do agente? Por uma rota no seu próprio app que a Meta chama. Defina o destino do webhook do número para ela, com um segredo longo e aleatório no caminho. A rota responde ao GET de verificação da Meta devolvendo hub.challenge como texto simples, aceita cada POST, responde 200 imediatamente e enfileira o trabalho, porque a Meta repete respostas lentas e você rodaria o agente duas vezes. Um worker então 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, então a próxima mensagem do mesmo cliente continua de onde a anterior parou, e dois clientes nunca compartilham um histórico. SQLiteSession basta para começar; o SDK também traz sessões Redis e SQLAlchemy para vários workers. O segredo na URL é a autenticação aqui. A Meta assina as entregas com o app secret do Tech Provider, então o cliente não consegue validar o header de assinatura. ### Por que o seu código deve 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 a garante melhor que um prompt. A Meta abre uma janela de atendimento de 24 horas quando um cliente escreve. Dentro dela, texto livre passa. Fora dela, só um template aprovado passa, e o texto livre volta com o erro 131047. Um worker que responde à mensagem que acabou de chegar está sempre dentro da janela, então enviar result.final_output como texto é seguro por construção. O trabalho que acontece depois, um acompanhamento na manhã seguinte ou um lembrete, deve passar por um caminho separado que envia um template e nunca texto livre. O agente ainda pode ter ferramentas. Dê a ele function tools para consultar coisas, como um pedido ou uma reserva, e mantenha o envio do WhatsApp no worker. Isso também mantém o token de acesso fora de qualquer coisa que o modelo possa chamar com argumentos arbitrários. ### O agente pode usar o servidor MCP do EasyCoexistence? Pode, por MCPServerStreamableHttp, com mais configuração do que um header. O SDK aceita um header Authorization ou um httpx.Auth em params["auth"]. O servidor MCP do EasyCoexistence emite os próprios tokens OAuth após um login no navegador, com registro dinâmico de cliente e PKCE, então não existe uma chave estática. O SDK Python do MCP traz OAuthClientProvider, um handler de autenticação HTTP que executa esse fluxo com PKCE e renovação de token, e é isso que vai em params["auth"]. Vale a pena quando o agente deve decidir por conta própria: verificar a saúde de um número, ler o status de um template ou escolher entre send_message e send_template usando as regras nas descrições das ferramentas. Para uma recepção que só responde, o worker acima é mais curto e tem menos o que dar errado. De qualquer forma, o webhook continua. O MCP é requisição e resposta, e a mensagem de um cliente só chega ao agente pela rota que a Meta chama. - Rodar o agente antes de devolver 200 à Meta. Uma resposta lenta é repetida, e o cliente recebe duas respostas. - Usar uma sessão para todos os clientes. Use o número do remetente como chave, ou os históricos se misturam. - Deixar um acompanhamento atrasado enviar texto livre. Depois de 24 horas ele falha com 131047; envie um template. **Isso exige a ferramenta MCP hospedada da OpenAI Responses API?** Não. O worker roda o agente localmente com Runner.run, e o lado do WhatsApp é uma chamada HTTPS simples feita pelo seu código. **Qual versão da Graph API devo usar?** Os exemplos atuais da Meta usam v25.0. Fixe a versão em um único lugar do código, para que atualizar seja uma mudança de uma linha. **Uma pessoa pode assumir pelo celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando, e uma resposta pelo celular chega à sua rota como um evento de echo que o worker pode usar para pausar o agente. **O EasyCoexistence armazena a conversa?** Não. A Meta entrega direto na sua rota. O que a sessão guardar fica no seu próprio banco de dados. --- ## Crie um agente de WhatsApp com o Vercel AI SDK https://easycoexistence.com/pt/integrations/vercel-ai-sdk As mensagens recebidas chegam a um manipulador de rota definido como destino do webhook do número. O manipulador chama generateText e envia a resposta pela Cloud API. Para ferramentas que agem sobre o número, createMCPClient de @ai-sdk/mcp conecta ao servidor MCP do EasyCoexistence por HTTP, entrando com OAuth por meio de um authProvider. ### Como o manipulador de rota recebe as mensagens do WhatsApp? Com dois métodos na mesma rota, definida como destino do webhook do número, com um segredo longo e aleatório 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 por um helper de JSON é o erro clássico: o corpo chega com aspas ao redor e a Meta nunca começa a entregar. O POST recebe os eventos. Devolva 200 rápido e chame o modelo depois, porque a Meta repete respostas lentas e uma inicialização a frio que executa o modelo na hora pode responder à mesma mensagem duas vezes. Em plataformas que encerram a função quando a resposta é enviada, passe o trabalho para uma fila ou para o mecanismo da plataforma para tarefas após a resposta. O segredo no caminho é a autenticação. A Meta assina cada entrega com o segredo do app do Tech Provider, então o cabeçalho X-Hub-Signature-256 não pode ser verificado do seu lado. ### Como o AI SDK carrega as ferramentas do WhatsApp? Com createMCPClient de @ai-sdk/mcp e o transporte HTTP, que a documentação do AI SDK recomenda para produção. O transporte recebe a URL do servidor e um authProvider, e o OAuth por um authProvider é a forma de autorizar o servidor MCP do EasyCoexistence: ele publica os metadados de OAuth, aceita registro dinâmico de cliente e PKCE, e emite os próprios tokens após o login. Não há chave de API para colocar em um cabeçalho. As ferramentas do cliente vão direto para generateText ou streamText. O modelo passa a ver list_numbers, send_message, send_template, get_number_health e as demais, com descrições que informam a janela de atendimento de 24 horas. Feche o cliente quando a chamada terminar, no callback onEnd em um stream ou em um bloco finally nos outros casos, como a documentação do AI SDK pede. Use onde o modelo deve decidir. Para responder à mensagem que acabou de chegar, uma chamada direta à Cloud API a partir do manipulador é mais curta. ### O que muda porque o número está na Coexistência? Duas coisas que o código deve levar em conta. Primeiro, uma pessoa pode já estar na conversa. O app do WhatsApp Business continua funcionando no número, e cada resposta digitada no celular chega à rota como um evento de eco. Um manipulador que pausa o modelo para um contato depois de um eco evita responder por cima de uma pessoa. Segundo, o envio tem um limite fixo de 20 mensagens por segundo para o número. Um agente conversacional nunca chega perto disso, mas um laço de envio em massa escrito com Promise.all sobre uma lista de contatos chega, então agrupe em lotes. Todo o resto é a Cloud API comum. Dentro de 24 horas da última mensagem do cliente, 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 ao redor fazem a verificação da Meta falhar. - Executar generateText antes de responder à Meta. Em uma inicialização a frio, a repetição gera uma segunda resposta. - Esquecer de fechar o cliente MCP. Cada requisição deixa uma conexão aberta até a plataforma encerrá-la. **Isso só funciona na Vercel?** Não. O AI SDK é uma biblioteca TypeScript, e a rota pode rodar em qualquer host 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 resolve. O MCP vale a pena quando o modelo escolhe o que fazer. **Qual provedor o modelo pode ser?** Qualquer um que o AI SDK aceite. O lado do WhatsApp é independente do modelo, então trocar de provedor não mexe na rota nem na chamada à Cloud API. **O EasyCoexistence vê as mensagens?** Não. A Meta entrega direto na sua rota e o conteúdo das mensagens nunca é armazenado do nosso lado. --- ## Envie mensagens de pedido da Shopify pelo WhatsApp https://easycoexistence.com/pt/integrations/shopify A ação Enviar requisição HTTP do Shopify Flow pode enviar um template aprovado à Cloud API quando um pedido é criado, usando o phone_number_id do número conectado e um token guardado como segredo do Flow. Em planos sem essa ação, um webhook do admin da Shopify chama um receptor, como o n8n, que faz a mesma chamada. ### Como o Shopify Flow envia uma mensagem no WhatsApp? Com a ação Enviar requisição HTTP, que faz um POST para qualquer URL, com cabeçalhos e um corpo que podem usar variáveis Liquid do gatilho. Crie um fluxo com o gatilho de criação de pedido e adicione Enviar requisição HTTP. A URL é o endpoint de mensagens da Cloud API para o phone_number_id do número conectado. 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 aparecem na interface do Flow e são ocultados nos logs de execução, que é o lugar certo para um token. O corpo é uma mensagem de template, com o telefone do cliente no campo to e os dados do pedido como parâmetros do template. O Flow considera uma resposta 2XX ou 3XX como sucesso. A Meta responde a uma requisição válida com o id da mensagem, então uma execução bem-sucedida significa que a Meta aceitou a mensagem. ### Por que a mensagem de pedido precisa ser um template? Porque a loja é quem escreve primeiro. A janela de atendimento de 24 horas da Meta só abre quando o cliente escreve para o número. Uma confirmação de pedido, uma atualização de envio ou um lembrete de carrinho abandonado saem antes disso, então texto livre é recusado e só passa um template pré-aprovado. Crie o template uma vez, na categoria utility para atualizações de pedido e envio, e espere a aprovação antes de ligar o fluxo. O nome e o idioma no corpo da requisição precisam ser idênticos aos do template aprovado, e o número de parâmetros precisa corresponder aos placeholders. Há também o consentimento. A Meta exige opt-in antes de uma empresa enviar mensagem a alguém no WhatsApp: a pessoa informou o número e concordou em receber mensagens dessa empresa. Uma caixa de seleção no checkout que diga isso é a forma usual de coletar, e o fluxo deve verificá-la antes de enviar. ### E se o plano da loja não incluir Enviar requisição HTTP? Use um webhook do admin da Shopify. Em Configurações, Notificações, Webhooks, o lojista pode criar um webhook para um evento como a criação de pedido, em JSON, para uma URL. Aponte-o para um receptor: um nó Webhook do n8n ou uma rota em PHP, Python ou Node. O receptor lê o pedido, verifica o consentimento e faz a mesma chamada de template à Cloud API. Por qualquer caminho que envie, as respostas funcionam igual. Quando o cliente responde à mensagem do pedido, a resposta chega no app do WhatsApp Business no celular da loja, porque o número está em Coexistência, e a janela de atendimento de 24 horas passa a estar aberta para texto livre. Se o destino do webhook do número estiver configurado, a resposta também chega ao seu sistema. A própria mensagem do pedido também aparece no app, então quem responde vê a que o cliente está respondendo. - Enviar texto livre na criação do pedido. O cliente ainda não escreveu, então a Meta recusa; precisa ser um template aprovado. - Deixar o tratamento de erros em Repetir para respostas 4XX. O Flow pode repetir por até 24 horas uma requisição que a Meta nunca vai aceitar. - Colocar o token em um cabeçalho como texto simples. Guarde-o como segredo do Flow para que fique fora da interface e dos logs. **Quem paga pelas mensagens de template?** A Meta cobra as mensagens diretamente da empresa, na própria conta do WhatsApp Business. A EasyCoexistence nunca aplica margem. **A equipe ainda pode responder aos clientes pelo celular?** Sim. É isso que a Coexistência preserva: o app do WhatsApp Business funciona no mesmo número de onde a loja envia. **Isso exige um app da Shopify?** Não. A ação Enviar requisição HTTP do Flow, ou um webhook do admin para um receptor, é suficiente. A Cloud API é uma única chamada HTTPS. **Qual formato de telefone o campo to exige?** Formato internacional, com o código do país e só dígitos. Limpe o campo de telefone do checkout antes de enviar, pois os clientes digitam espaços e símbolos. --- ## Envie atualizações de pedidos do WooCommerce pelo WhatsApp https://easycoexistence.com/pt/integrations/woocommerce Crie um webhook do WooCommerce para eventos de pedido apontando para um receptor, como um fluxo do n8n ou uma pequena rota PHP. O receptor verifica a assinatura do WooCommerce, confere se o cliente aceitou receber mensagens no WhatsApp e envia um template aprovado pela Cloud API, com o phone number id e o token do número conectado. ### Como um pedido do WooCommerce dispara uma mensagem no WhatsApp? Por meio de um webhook do WooCommerce e de um receptor. No WooCommerce, vá em Configurações, Avançado, Webhooks e adicione um webhook com um tópico de pedido, como pedido criado ou pedido atualizado, uma URL de entrega e um secret. A partir daí, o WooCommerce envia o pedido em JSON para essa URL sempre que o evento acontece. O payload é fixo, então não dá para apontá-lo direto para a Cloud API. Entre os dois fica um receptor: um nó Webhook do n8n, uma rota no PHP da própria loja ou qualquer serviço pequeno. Ele lê o pedido, escolhe o número de telefone do cliente e os detalhes que a mensagem precisa e faz uma requisição HTTPS ao endpoint de mensagens da Cloud API para o número conectado, com o token de acesso do número como bearer token. O tópico order.updated não está atrelado a um único status, então o receptor deve ler o campo status do pedido e enviar uma vez por transição que lhe interessa. Por padrão, o WooCommerce faz a entrega em segundo plano pelo wp-cron, então a mensagem pode chegar com um pequeno atraso em relação ao pedido. ### Como o receptor sabe que a requisição 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, calculado com o secret definido no webhook. O receptor calcula o mesmo hash sobre o corpo recebido, compara e rejeita tudo o que não coincidir. Esse é o secret da própria loja, então, ao contrário da assinatura da Meta nas mensagens recebidas do WhatsApp, ele pode ser validado. Compare em tempo constante e calcule o hash do corpo bruto antes de qualquer framework interpretá-lo, porque um JSON recodificado gera um hash diferente. Responda rápido 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 receptor fora do ar durante um deploy, ou lento por esperar a Meta antes de responder, pode desligar as mensagens da loja sem que ninguém perceba. ### O que a loja pode enviar, e quando? Um template aprovado, sempre que a loja fala primeiro. A janela de atendimento de 24 horas da Meta só abre quando o cliente escreve para o número, então uma confirmação de pedido ou uma atualização de envio é iniciada pela empresa e texto livre é recusado. Crie um template de utilidade para cada atualização, espere a aprovação e envie-o pelo nome e idioma, com o número do pedido e outros detalhes como parâmetros. A Meta também exige opt-in: o cliente informou o número e concordou em receber mensagens desta empresa no WhatsApp. Uma caixa de seleção no checkout, guardada no pedido, é o registro mais simples, e o receptor deve conferi-la antes de enviar. Quando o cliente responde, a conversa passa a ser Coexistência comum. A resposta aparece no app do WhatsApp Business no celular da loja, a janela fica aberta para texto livre e a equipe responde pelo app como sempre fez. - Fazer a chamada à Cloud API antes de responder ao WooCommerce. Um envio lento ou com falha conta contra o webhook, que é desativado após mais de cinco falhas. - Calcular o hash do JSON já interpretado em vez do corpo bruto. A assinatura nunca coincide e toda entrega legítima é rejeitada. - Enviar a cada entrega de order.updated. O tópico não está atrelado a um único status, então, sem registrar qual transição já foi avisada, os clientes recebem mensagens duplicadas. **Preciso de um plugin do WordPress para isso?** Não. Os webhooks nativos do WooCommerce e um receptor bastam, e o receptor pode ser uma rota na mesma aplicação PHP. **Quem paga pelas mensagens dos pedidos?** A Meta cobra as mensagens diretamente da empresa, na própria conta do WhatsApp Business, e a EasyCoexistence nunca aplica margem. **A equipe ainda pode usar o celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no número da loja, e o template enviado pela loja aparece na conversa. **E se um webhook foi desativado?** Corrija o receptor e volte o status do webhook para ativo no WooCommerce. Os pedidos criados enquanto ele estava desligado não geraram mensagem. --- ## Enviar e receber WhatsApp com PHP e Laravel https://easycoexistence.com/pt/integrations/php-laravel Receber é uma rota do 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 troca pontos por underscores. Enviar é um 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 SDK. ### Como receber mensagens do WhatsApp no Laravel? Com um GET e um POST no mesmo caminho em routes/api.php. Rode php artisan install:api antes, se o arquivo não existir. As rotas de API são stateless e ficam fora do grupo web, então o POST da Meta não é rejeitado por falta de token CSRF, o que acontece em uma rota de 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 pontos em nomes de variáveis recebidas como underscores, então o Laravel enxerga hub_mode, hub_verify_token e hub_challenge. O código que lê os nomes com ponto recebe null e nunca verifica. Devolva o challenge como texto puro, não por response()->json(). O POST entrega o payload a um job em fila e retorna 200 na hora. Coloque uma chave aleatória longa no caminho e confira nas duas rotas: a Meta assina as entregas com o app secret do Tech Provider, então o cabeçalho de assinatura não pode ser validado do seu lado. ### Como enviar uma mensagem do WhatsApp pelo Laravel? Com o cliente HTTP do Laravel: um POST para o endpoint de mensagens do phone number id, com o token de acesso como bearer token. Os dois valores vêm da conexão, aparecem no painel e são devolvidos por get_api_credentials, e devem ficar em config/services.php, apoiados em variáveis de ambiente, e não no código. O formato do corpo depende do momento. Dentro de 24 horas da última mensagem do cliente, um objeto text funciona, como abaixo. Fora dessa janela, a Meta aceita apenas um objeto template com o nome de um template aprovado e seu idioma, e texto livre falha com o erro 131047. A resposta é o lugar para ver isso: uma chamada que falha devolve um objeto error cujo code diz o que deu errado, então registre-o em log em vez de descartá-lo. Nada na requisição é específico do EasyCoexistence. É a chamada da própria documentação da Meta, então qualquer cliente HTTP de PHP, Guzzle ou cURL puro, funciona da mesma forma. ### O que um handler Laravel em produção precisa além disso? Uma fila de verdade, deduplicação e uma verificação da janela. A fila importa porque a Meta repete a entrega quando a resposta demora. HandleWhatsAppEvent::dispatch() só retorna rápido quando a conexão da fila é real e há um worker rodando. No driver sync o job roda dentro da requisição, e uma chamada lenta a um modelo ou uma escrita no banco vira uma entrega duplicada. Deduplique pelo id da mensagem, o wamid de cada mensagem, porque repetições são normais, não exceção. Um índice único nessa coluna, ou um lock de cache com ela como chave, basta. E guarde quando cada contato escreveu pela última vez. Com esse timestamp, o caminho de envio escolhe texto ou template sozinho, em vez de descobrir pelo erro 131047 depois que o cliente já estava esperando. As respostas digitadas no celular, no app do WhatsApp Business, chegam como eventos echo na mesma rota, então o handler também percebe quando uma pessoa assumiu uma conversa. - Ler hub.challenge com ponto. O PHP o renomeou para hub_challenge, então 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 roda antes do 200, o processamento lento é repetido e as mensagens são processadas duas vezes. - Devolver o challenge com response()->json(). As aspas em volta do valor fazem a verificação da Meta falhar. **Existe um SDK de PHP?** Não da nossa parte, e não é preciso. A API é da Meta, documentada pela Meta, e o cliente HTTP do Laravel ou o Guzzle a acessam diretamente. **Isso funciona sem Laravel?** Sim. Em PHP puro, leia $_GET['hub_challenge'], devolva-o como text/plain e envie com cURL. A regra do underscore vale para todo framework PHP. **Por que a 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 é compartilhado, então o segredo na URL é o que impede estranhos de enviar eventos falsos. **A equipe ainda pode usar o celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no número, e as mensagens enviadas pelo celular chegam à sua rota como eventos echo. --- ## WhatsApp Coexistence no Brasil: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-brazil A Coexistência está disponível no Brasil: a documentação de onboarding da Meta para usuários do app do WhatsApp Business não impõe restrição geográfica. Mensagens para números +55 seguem a tabela de tarifas da Meta para o Brasil, que a partir de 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 junto. ### A Coexistência do WhatsApp está disponível no Brasil? Sim. A documentação atual da Meta para conectar usuários do app do WhatsApp Business lista os requisitos que um número precisa cumprir, e nenhum deles é um país. Um número brasileiro se qualifica nas mesmas condições de qualquer outro: já está em uso no app do WhatsApp Business, o app está na versão 2.24.17 ou mais recente, e a conexão passa por um Tech Provider ou Solution Partner usando Embedded Signup. Depois de conectado, o app no celular continua funcionando e o mesmo número +55 ganha acesso à Cloud API. A Meta fixa o throughput desses números em 20 mensagens por segundo para manter a compatibilidade com o app. ### Quanto a Meta cobra por mensagem no Brasil? A Meta cobra por mensagem entregue, por categoria e pelo código de país do destinatário. O Brasil (+55) é um mercado nomeado na tabela de tarifas, então mensagens para números brasileiros são cobradas pelas tarifas próprias do Brasil, e não por uma média regional. Estas são as tarifas de tabela em vigor a partir de 1º de outubro de 2026, retiradas das tabelas da Meta em USD e BRL. As tarifas de utilidade e autenticação podem cair ainda mais conforme as faixas de volume mensal, que a Meta aplica por mercado e categoria. ### Quais mensagens continuam gratuitas? Três coisas não custam nada. As mensagens digitadas no app do WhatsApp Business no celular continuam gratuitas depois da conexão, porque a Meta só aplica o preço da Cloud API ao que é enviado pela API. Cada número de telefone comercial recebe 1,000 mensagens de atendimento gratuitas por mês, as respostas sem template enviadas dentro da janela de atendimento de 24 horas. E tudo o que é enviado dentro de uma janela de ponto de entrada gratuito, aberta quando um cliente chega por um anúncio Click to WhatsApp, é gratuito por até 7 dias. Duas coisas mudaram em 1º de outubro de 2026: as mensagens de atendimento além das primeiras 1,000 de cada mês são cobradas, e os templates de utilidade enviados dentro da janela de atendimento também são cobrados. ### A Meta fatura empresas brasileiras em reais? Agora sim. A Meta iniciou a localização de faturamento para o Brasil em 1º de julho de 2026. Solution Providers e empresas integradas diretamente cujo país Sold-To no Billing Hub é o Brasil podem criar contas de Mensagens em BRL, e as cobranças dessas contas são faturadas em BRL pela Facebook Brasil, a entidade local da Meta. A mudança tem prazo. Clientes elegíveis precisam migrar para BRL todas as contas de Mensagens do seu Portfólio de Negócios 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 estão em BRL. A Meta oferece uma Currency Migration API para a migração, já 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 de Mensagens em USD depois de 30 de junho de 2027 quando o seu país Sold-To é o Brasil. A Meta deixa de entregar as mensagens dela a partir de 1º de julho de 2027. - Tratar toda resposta como gratuita. Desde 1º de outubro de 2026, as mensagens de atendimento além de 1,000 por número por mês são cobradas. - Orçar pelo lugar onde a empresa fica. A Meta cobra pelo código de país do destinatário, então uma mensagem para um número português é cobrada pela tarifa do Resto da Europa Ocidental. **Preciso de uma empresa brasileira para usar a Coexistência?** Não. Os requisitos da Meta tratam do número e do app, não de onde a empresa está registrada. A localização da empresa só importa para definir a moeda e a entidade da Meta que fatura você. **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 lista BRL 0.3217 para marketing e BRL 0.035 para utilidade e autenticação. **As mensagens que envio pelo celular custam algo?** Não. A documentação da Meta diz que as mensagens enviadas pelo app do WhatsApp Business continuam gratuitas depois da conexão. Só os envios pela API seguem o preço da Cloud API. **O que acontece se minha conta não tiver forma de pagamento?** A Meta ainda entrega mensagens de atendimento dentro das 1,000 gratuitas, mas deixa de entregá-las quando essa franquia é usada. Adicione uma no Billing Hub antes de enviar qualquer coisa que a Meta cobre. --- ## Coexistência do WhatsApp no México: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-mexico A Coexistência está disponível no México, já que a documentação de onboarding da Meta para usuários do app do WhatsApp Business não define restrição geográfica. As mensagens para números +52 seguem 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 Coexistência do WhatsApp? Sim. Os requisitos da documentação da Meta para o onboarding de usuários do app do WhatsApp Business dizem respeito ao número e ao app, não ao país: o número já está ativo no app do WhatsApp Business, o app está na versão 2.24.17 ou mais recente, e a conexão é feita pelo Embedded Signup por um Tech Provider ou Solution Partner. Um número +52 que cumpre essas condições continua funcionando no app do celular e ganha acesso à Cloud API no mesmo número. A Meta limita o throughput da API nesses números compartilhados a 20 mensagens por segundo. ### Quanto a Meta cobra por mensagem no México? A Meta cobra por mensagem entregue, e a tarifa depende de duas coisas: a categoria da mensagem e o código de país de quem a recebe. O México (+52) tem linha própria na tabela de tarifas. Estas são as tarifas de tabela em vigor a partir de 1º de outubro de 2026, data em que a Meta também aumentou a tarifa de marketing do México. Um volume mensal maior pode liberar tarifas menores de utilidade e autenticação pelas faixas de volume da Meta. ### O que não custa nada? Tudo o que for digitado no celular, no app do WhatsApp Business, que segundo a documentação da Meta continua gratuito depois que o número é conectado. Só as mensagens enviadas pela Cloud API seguem o preço da Cloud API. No lado da API, cada número de telefone comercial recebe 1.000 mensagens de atendimento gratuitas por mês, que são respostas sem template dentro da janela de atendimento de 24 horas, e a cota é renovada todo mês sem acumular. Um cliente que chega por um anúncio Click to WhatsApp abre uma janela gratuita de ponto de entrada de até 7 dias, na qual a Meta não cobra nada por mensagens de marketing, utilidade, autenticação ou atendimento. ### A Meta pode cobrar uma conta mexicana em pesos? O MXN é uma das 16 moedas que a Meta habilita na WhatsApp Business Platform, lançada em 1º de janeiro de 2026, e a Meta publica uma tabela de tarifas completa em MXN ao lado da tabela em USD. A moeda é escolhida quando a conta de mensagens é criada e não pode simplesmente ser trocada depois. A Meta oferece 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 para cobrança local no México, então 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 você queria pesos. A moeda é fixada na criação e mudá-la exige a Currency Migration API da Meta. - Usar tarifas anteriores a 1º de outubro de 2026. A Meta aumentou a tarifa de marketing do México nessa data. - Presumir que uma resposta é sempre gratuita. Depois de 1.000 mensagens de atendimento por número por mês, a Meta cobra por elas. **Um celular +52 1 é tratado de forma diferente?** A Meta associa todo o código de país +52 ao mercado do México, então todo 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 de 1º de outubro de 2026 da Meta aumentou a tarifa de marketing do México. As tarifas de utilidade e autenticação não estavam nessa lista de mudanças. **Enviar mensagens a clientes nos Estados Unidos custa o mesmo?** Não. Números dos EUA ficam na região América do Norte da Meta, que tem tarifas próprias. O código de país do destinatário define o preço. **Perco o app ao conectar a API?** Não. O número continua no app do WhatsApp Business e o celular segue enviando e recebendo como antes. --- ## Coexistência do WhatsApp na Colômbia: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-colombia A Coexistência está disponível na Colômbia: a documentação de integração da Meta para usuários do app do WhatsApp Business não traz nenhuma restrição de país. Mensagens para números +57 usam a tabela de preços da Meta para a Colômbia, que a partir de 1º de outubro de 2026 lista 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 Coexistência do WhatsApp funciona com números colombianos? Sim. A documentação da Meta para integrar usuários do app do WhatsApp Business descreve as condições que um número precisa cumprir, e nenhuma delas é geográfica. Um número +57 se qualifica quando já está em uso no app do WhatsApp Business, o app está na versão 2.24.17 ou superior e a integração acontece pelo Embedded Signup operado por um Tech Provider ou Solution Partner. Depois da integração, o celular continua funcionando como antes, conversas incluídas, enquanto o mesmo número responde pela Cloud API. O throughput do lado da API é fixo em 20 mensagens por segundo para números compartilhados. ### Quais são as tarifas por mensagem da Meta para a Colômbia? A Meta precifica cada mensagem entregue pela categoria e pelo código de país do destinatário. A Colômbia (+57) é um mercado nomeado e, na tabela de 1º de outubro de 2026, tem as menores tarifas de marketing e utilidade entre os mercados da América Latina que a Meta lista, incluindo a região Resto da América Latina. Os valores abaixo são tarifas de tabela; faixas de volume podem reduzir ainda mais utilidade e autenticação em volumes mensais altos. ### Quais mensagens são gratuitas na Colômbia? As mesmas de qualquer lugar, porque os casos gratuitos da Meta são globais e não por mercado. Mensagens enviadas pelo app do WhatsApp Business no celular continuam gratuitas depois que o número é conectado; o preço da Cloud API vale apenas para envios pela API. Cada número de telefone comercial recebe 1.000 mensagens de serviço gratuitas por mês, para respostas sem template dentro da janela de atendimento de 24 horas. Conversas iniciadas por um anúncio Click to WhatsApp abrem uma janela de ponto de entrada gratuito de até 7 dias, sem cobrança em nenhuma categoria, exceto mensagens do Meta Business Agent. Desde 1º de outubro de 2026, templates de utilidade enviados dentro de uma janela de atendimento aberta são cobrados. ### Uma empresa colombiana pode pagar a Meta em pesos? O COP é uma das moedas que a Meta adicionou em 2026, disponível desde 1º de abril de 2026, com tabela de preços própria. A tabela em COP da Meta precifica todos os mercados em pesos, então uma empresa colombiana que envia mensagens a clientes no México ou na Espanha também vê essas cobranças em COP. A moeda é definida quando a conta de mensagens é criada e não muda. Trocar depois é feito com a Currency Migration API da Meta. A página de preços da Meta descreve migrações obrigatórias de cobrança local apenas para Brasil e Índia, então para a Colômbia o COP é uma opção, não uma exigência. 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 pela tarifa desse mercado, que na tabela de outubro de 2026 é várias vezes maior. - Escolher a moeda de cobrança sem cuidado. Depois que a conta existe, trocar exige a Currency Migration API da Meta. - Deixar a conta sem forma de pagamento. As mensagens de serviço deixam de ser entregues quando as 1.000 gratuitas do mês acabam. **Por que as tarifas da Colômbia são tão menores que as dos vizinhos?** A Meta define tarifas por mercado e não explica cada valor. A tabela de 1º de outubro de 2026 simplesmente lista a Colômbia abaixo dos outros mercados da América Latina. **Autenticação tem preço diferente de utilidade?** Não para a Colômbia. Ambas custam USD 0.0008 na tabela de 1º de outubro de 2026, e nenhuma tarifa de autenticação internacional se aplica. **Eu pago pelas mensagens que os clientes me enviam?** Não. A Meta não cobra mensagens de usuários para empresas, apenas as mensagens que uma empresa entrega. **O app mantém meu histórico de conversas?** Sim. O app do WhatsApp Business continua funcionando no celular, com suas conversas, depois que o número é conectado à API. --- ## Coexistência do WhatsApp na Argentina: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-argentina A Coexistência está disponível na Argentina, porque a documentação de onboarding da Meta para usuários do app do WhatsApp Business não impõe nenhuma restrição geográfica. As mensagens para números +54 são cobradas pelas 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 Coexistência está disponível para números argentinos? Sim. Nada na documentação da Meta sobre o onboarding de usuários do app do WhatsApp Business depende do país. A Meta verifica o número e o app: um número +54 já ativo no app do WhatsApp Business, na versão 2.24.17 ou mais nova, conectado pelo Embedded Signup por um Tech Provider ou Solution Partner. O resultado é um número usado de dois jeitos. A equipe continua respondendo pelo celular, e o software envia e recebe pela Cloud API, com limite da Meta de 20 mensagens por segundo enquanto o número é compartilhado com o app. ### Quanto a Meta cobra por mensagem na Argentina? Cada mensagem entregue é cobrada por categoria, pela tarifa do mercado ao qual pertence o código de país do destinatário. A Argentina (+54) é um mercado independente 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, as faixas de volume mensal da Meta reduzem a tarifa quando um Portfólio de Negócios envia mensagens suficientes para a Argentina em um mês. ### O que uma empresa argentina pode enviar de graça? As respostas digitadas no celular não custam nada: a documentação da Meta afirma que as mensagens enviadas pelo app do WhatsApp Business continuam gratuitas após o onboarding, e só os envios pela API seguem o preço da Cloud API. Pela API, cada número de telefone comercial tem uma franquia mensal de 1,000 mensagens de atendimento gratuitas, ou seja, respostas sem template dentro da janela de atendimento de 24 horas. A franquia é renovada todo mês e as mensagens não usadas não acumulam. Clientes que escrevem a partir de um anúncio Click to WhatsApp abrem uma janela de ponto de entrada gratuita de até 7 dias, durante a qual mensagens de marketing, utilidade, autenticação e atendimento não são cobradas. ### A Meta pode cobrar uma conta argentina em pesos? O ARS passou a estar disponível como moeda da WhatsApp Business Platform em 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 cota todos os mercados em ARS, não só a Argentina. A moeda é definida quando a conta de mensagens é criada e não pode ser trocada livremente depois; a Meta oferece uma Currency Migration API para isso. A página de preços da Meta descreve cobrança local obrigatória apenas para Brasil e Índia, então, para a Argentina, a escolha entre ARS e USD fica com a 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 vale uma tarifa regional da América Latina. A Argentina tem linha própria na tabela da Meta, com valores diferentes 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 templates de utilidade dentro da janela de atendimento. - Ler uma tabela de tarifas sem a data. A Meta publica as tabelas com data de vigência, e os valores aqui são os de 1º de outubro de 2026. **A Meta cobra pelas mensagens que meus clientes me enviam?** Não. A Meta cobra apenas pelas mensagens que uma empresa entrega aos usuários, nunca pelas mensagens que os usuários enviam à empresa. **Os valores em ARS mudam com o câmbio?** A Meta publica a tabela de cada moeda com data de vigência e atualiza as tarifas no próprio calendário. Consulte a tabela em ARS atual 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 lista tarifa de autenticação internacional para a Argentina. **Posso continuar usando o app depois de conectar?** Sim. O app do WhatsApp Business continua funcionando no celular, e o mesmo número ganha acesso à API. --- ## Coexistência do WhatsApp no Chile: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-chile A Coexistência está disponível no Chile: a documentação de onboarding da Meta para usuários do app do WhatsApp Business não estabelece 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 autenticação, ou CLP 78.4917 e CLP 17.6584 na tabela em pesos. ### Empresas chilenas podem usar a Coexistência do WhatsApp? Sim. A documentação da Meta para o onboarding de usuários do app do WhatsApp Business lista condições sobre o número, o app e o parceiro, e nenhuma sobre o país. Um número +56 se qualifica quando está em uso no app do WhatsApp Business, na versão 2.24.17 ou posterior, e é conectado pelo Embedded Signup por um Tech Provider ou Solution Partner. O celular continua funcionando com suas conversas, e o número ganha acesso à Cloud API com um throughput fixo de 20 mensagens por segundo, o limite que a Meta aplica a números compartilhados com o app. ### Quanto a Meta cobra por mensagem no Chile? A Meta cobra por mensagem entregue, por categoria, na tarifa do mercado do destinatário. O Chile (+56) é um mercado nomeado, e sua tarifa de marketing na tabela de 1º de outubro de 2026 é a mais alta entre todas as entradas da América Latina, acima até da região Resto da América Latina. Utilidade e autenticação ficam em USD 0.02, e as faixas de volume mensal da Meta podem reduzir essas duas para portfólios que enviam grandes volumes ao Chile. ### Quais mensagens chilenas a Meta não cobra? Tudo o que é enviado pelo próprio app do WhatsApp Business. A documentação da Meta diz que as mensagens do app continuam grátis após o onboarding e que só os envios pela Cloud API são cobrados. Na API, a Meta não cobra as primeiras 1.000 mensagens de atendimento por número de telefone comercial a cada mês, as respostas sem template enviadas dentro da janela de atendimento de 24 horas. Além disso, uma conversa iniciada por um anúncio Click to WhatsApp abre uma janela gratuita de ponto de entrada de até 7 dias, na qual nenhuma categoria é cobrada, exceto as mensagens do Meta Business Agent. Dada a tarifa de marketing do Chile, a janela gratuita de ponto de entrada é o caminho mais barato para mensagens promocionais no país. ### A Meta oferece cobrança em pesos chilenos? Sim, como opção. O CLP foi habilitado em 1º de abril de 2026 como uma das moedas que a Meta adicionou naquele ano, e a Meta publica uma tabela de tarifas em CLP que cobre todos os mercados, então mensagens para clientes no exterior também aparecem em pesos. A moeda de cobrança é escolhida quando a conta de mensagens é criada e fica fixa depois disso, a menos que a empresa use a Currency Migration API da Meta. A página de preços da Meta descreve cobrança local obrigatória apenas para o Brasil e a Índia; uma empresa chilena escolhe CLP ou USD por conta própria. 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 template de marketing como padrão em todo acompanhamento. No Chile isso custa USD 0.0889 por mensagem, contra USD 0.02 de um template de utilidade categorizado corretamente. - Esperar que a franquia de atendimento se acumule. As 1.000 mensagens de atendimento grátis são renovadas todo mês e as não usadas não passam para o mês seguinte. - Calcular uma campanha chilena com os valores do Resto da América Latina. O Chile é um mercado nomeado, com tarifas próprias. **O Chile é mais barato que a Argentina para 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 meu template?** Sim. A Meta revisa as categorias dos templates e pode alterar a categoria de um template, o que muda a tarifa cobrada por ele. **Mensagens recebidas têm algum custo?** Não. A Meta cobra apenas as mensagens que uma empresa entrega, não as que os clientes enviam. **O número continua funcionando no app?** Sim. O app do WhatsApp Business continua ativo no celular depois que o número é conectado à API. --- ## Coexistência do WhatsApp no Peru: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-peru A Coexistência está disponível no Peru, porque a documentação de onboarding da Meta para usuários do app do WhatsApp Business não traz nenhuma restrição de país. As mensagens para números +51 seguem a tabela de preços do Peru: desde 1º de outubro de 2026, US$ 0.0703 por template de marketing e US$ 0.03 por template de utilidade ou autenticação, ou PEN 0.2339 e PEN 0.0998 na tabela em sol da Meta. ### A Coexistência do WhatsApp está disponível no Peru? Sim. A documentação da Meta para o onboarding de usuários do app do WhatsApp Business impõe requisitos ao número e ao app, não ao país. Um número +51 é elegível quando já está ativo no app do WhatsApp Business, o app está na versão 2.24.17 ou mais recente e o onboarding passa pelo Embedded Signup com um Tech Provider ou Solution Partner. Depois de conectado, o celular continua enviando e recebendo, enquanto o mesmo número passa a ser acessível pela Cloud API. A Meta fixa o throughput da API para números compartilhados com o app em 20 mensagens por segundo. ### Quanto a Meta cobra por mensagem no Peru? A Meta cobra por mensagem entregue, com preço definido pela categoria e pelo mercado do código de país do destinatário. O Peru (+51) tem uma linha própria. Em 1º de outubro de 2026 a Meta aumentou as tarifas de utilidade e autenticação do Peru, que agora ficam em US$ 0.03, a maior tarifa de utilidade entre os mercados da América Latina na tabela. Esses são valores de tabela; faixas de volume podem reduzir utilidade e autenticação para grandes volumes mensais. ### O que continua gratuito para uma empresa peruana? As mensagens enviadas pelo app do WhatsApp Business no celular. A documentação da Meta afirma que elas continuam gratuitas após o onboarding, e apenas as mensagens enviadas pela Cloud API são cobradas. Pela API, a Meta dá a cada número de telefone comercial 1,000 mensagens de atendimento gratuitas por mês, as respostas sem template enviadas enquanto a janela de atendimento de 24 horas está aberta, com renovação mensal. Clientes que chegam por um anúncio Click to WhatsApp abrem uma janela gratuita de ponto de entrada de até 7 dias, na qual a Meta não cobra nada por mensagens de marketing, utilidade, autenticação ou atendimento. Templates de utilidade enviados dentro da janela de atendimento são cobrados desde 1º de outubro de 2026. ### A Meta pode cobrar uma conta peruana em soles? Sim, o PEN está disponível. Foi lançado em 1º de abril de 2026 entre as moedas que a Meta adicionou naquele ano, e a Meta publica uma tabela de preços em PEN que cobre todos os mercados que ela precifica. A moeda é escolhida na criação da conta de mensagens e fica fixa a partir daí, exceto pela Currency Migration API da Meta. A página de preços da Meta descreve migrações obrigatórias de cobrança local apenas para o Brasil e a Índia, então uma empresa peruana decide por conta própria 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çar envios de utilidade com valores anteriores a 1º de outubro de 2026. A Meta aumentou as tarifas de utilidade e autenticação do Peru nessa data. - Apoiar-se em templates de utilidade para respostas. Dentro de uma janela aberta, uma mensagem de atendimento gratuita faz o mesmo trabalho, até 1,000 por mês por número. - Supor que os mercados vizinhos custam o mesmo. A tarifa de utilidade da Colômbia na mesma tabela é US$ 0.0008. **Por que meus custos de utilidade subiram em outubro de 2026?** A Meta aumentou as tarifas de utilidade e autenticação do Peru em 1º de outubro de 2026 e passou a cobrar templates de utilidade enviados dentro da janela de atendimento a partir da mesma data. **A Meta cobra pelas mensagens que os clientes me enviam?** Não. Só são cobradas as mensagens entregues pela empresa. **Existe tarifa de autenticação internacional para o Peru?** Não. A tabela de 1º de outubro de 2026 não lista nenhuma para o Peru, então a autenticação é cobrada a US$ 0.03. **O app no celular continuará funcionando?** Sim. O app do WhatsApp Business continua funcionando no celular depois que o número é conectado à API. --- ## Coexistência do WhatsApp na Costa Rica: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-costa-rica A Coexistência está disponível na Costa Rica, já que a documentação da Meta para quem usa o app do WhatsApp Business não impõe restrição geográfica. A Costa Rica não tem linha própria na tabela de tarifas da Meta: números +506 pagam as tarifas do Resto da América Latina, que desde 1º de outubro de 2026 são USD 0,074 por template de marketing e USD 0,0113 por template de utilidade ou autenticação. ### Um número da Costa Rica pode usar a Coexistência do WhatsApp? Sim. A documentação da Meta para integrar usuários do app do WhatsApp Business impõe condições ao número e ao app, e nenhuma ao país. Um número +506 se qualifica se já estiver em uso no app do WhatsApp Business, se o app estiver na versão 2.24.17 ou mais recente e se a conexão for feita com Embedded Signup por um Tech Provider ou Solution Partner. O celular continua funcionando com as conversas existentes, e o número ganha acesso à Cloud API. A Meta fixa o throughput em 20 mensagens por segundo para números compartilhados entre o app e a API. ### Por que a Costa Rica é cobrada como Resto da América Latina? A tabela de tarifas da Meta nomeia 39 países individuais e agrupa os demais em 8 regiões. A Costa Rica (+506) é um dos 15 mercados da região Resto da América Latina, junto com países como Panamá, Guatemala, Equador e Uruguai. Qualquer mensagem entregue a um número desses mercados é cobrada pela tarifa da região. A região também importa para as faixas de volume de utilidade e autenticação. As faixas são contadas por mercado e categoria, então as mensagens para todos os países do Resto da América Latina contam para a mesma faixa regional, e não para uma da Costa Rica. ### Quais mensagens são gratuitas para uma empresa da Costa Rica? Tudo o que for digitado no app do WhatsApp Business no celular. A documentação da Meta diz que as mensagens do app continuam gratuitas após a integração e que o preço da Cloud API cobre apenas os envios pela API. No lado da API, cada número de telefone comercial recebe 1.000 mensagens de atendimento gratuitas por mês, que são respostas sem template dentro da janela de atendimento de 24 horas, sem acúmulo. Uma conversa iniciada por um anúncio Click to WhatsApp abre uma janela gratuita de entrada de até 7 dias, na qual a Meta não cobra mensagens de marketing, utilidade, autenticação nem atendimento. Templates de utilidade enviados dentro da janela de atendimento são cobrados desde 1º de outubro de 2026. ### Em que moeda a Meta cobra uma conta da Costa Rica? A Meta habilita 16 moedas de cobrança no WhatsApp Business Platform, e o colón costarriquenho não está entre elas. Uma empresa da Costa Rica escolhe uma das moedas publicadas ao criar a conta de mensagens, como USD, e a Meta publica a tarifa do Resto da América Latina em cada uma de suas tabelas. A moeda não pode ser trocada livremente depois que a conta existe. A Meta oferece uma Currency Migration API para fazer a troca. A página de preços da Meta não lista nenhum programa de cobrança 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: +506 é cobrado como Resto da América Latina. - Supor que os vizinhos da América Central têm a mesma tarifa do México. O México é um mercado nomeado, com tarifas de marketing menores que as da região. - Gastar templates de utilidade em respostas. Uma mensagem de atendimento dentro da janela aberta é gratuita até 1.000 por mês por número. **A Costa Rica é mais barata que o México para enviar mensagens?** Não para 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 do México. **Posso pagar a Meta em colones?** Não. O colón não é uma das 16 moedas que a Meta habilita no WhatsApp Business Platform. **As mensagens dos clientes para mim custam alguma coisa?** Não. A Meta cobra apenas as mensagens que as empresas entregam. **Conectar a API faz o app parar?** Não. O app do WhatsApp Business continua funcionando no celular com as conversas. --- ## WhatsApp Coexistência na Espanha: disponibilidade e tarifas da Meta https://easycoexistence.com/pt/docs/whatsapp-coexistence-spain A Coexistência está disponível na Espanha: a documentação de onboarding da Meta para usuários do app do WhatsApp Business não impõe restrição geográfica, inclusive na UE. As mensagens para números +34 usam a tabela de preços própria da Espanha, que desde 1º de outubro de 2026 lista EUR 0.0585 por template de marketing e EUR 0.0166 por template de utilidade ou autenticação, ou USD 0.0707 e USD 0.02. ### A Coexistência do WhatsApp está disponível na Espanha e na UE? Sim. A documentação atual da Meta para o onboarding de usuários do app do WhatsApp Business lista requisitos sobre o número, o app e o parceiro, e nenhuma restrição geográfica. Um número +34 se qualifica quando já está em uso no app do WhatsApp Business, roda a versão 2.24.17 ou mais recente e é conectado por meio do Embedded Signup por um Tech Provider ou Solution Partner. Listas do início do lançamento que deixavam a UE de fora continuam circulando, e a documentação da Meta não as sustenta mais. Depois do onboarding o celular continua funcionando, e o número responde pela Cloud API com throughput fixo de 20 mensagens por segundo. ### Quanto a Meta cobra por mensagem na Espanha? A Meta cobra por mensagem entregue, por categoria e pelo mercado do código de país do destinatário. A Espanha (+34) é um mercado nomeado, separado da região Resto da Europa Ocidental, que cobre Portugal, 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 em 1º de julho de 2026. Faixas de volume podem reduzir utilidade e autenticação para Portfólios de Negócios com alto volume mensal para a Espanha. ### Quais mensagens são grátis para uma empresa espanhola? As mensagens enviadas pelo app do WhatsApp Business no celular. A documentação da Meta afirma que continuam grátis após o onboarding, e os preços da Cloud API se aplicam apenas ao que passa pela API. Pela API, a Meta dá a cada número de telefone comercial 1.000 mensagens de atendimento grátis por mês, as respostas sem template enviadas dentro da janela de atendimento de 24 horas, com renovação mensal. Um cliente que chega por um anúncio Click to WhatsApp abre uma janela de ponto de entrada gratuita de até 7 dias, sem cobrança por mensagens de marketing, utilidade, autenticação ou atendimento. Desde 1º de outubro de 2026, templates de utilidade enviados dentro de uma janela de atendimento aberta são cobrados. ### A Meta pode cobrar uma empresa espanhola em euros? Sim. O EUR já era uma moeda disponível na WhatsApp Business Platform antes de a Meta adicionar mais dez em 2026, e a Meta publica uma tabela de preços completa em EUR, na qual todos os mercados, não só a Espanha, têm preço em euros. A moeda é escolhida quando a conta de mensagens é criada e fica fixa depois, exceto pela Currency Migration API da Meta. A página de preços da Meta descreve migrações obrigatórias de cobrança local apenas para Brasil e Índia, então uma empresa espanhola escolhe por conta própria o EUR ou outra moeda compatível. 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 em uma lista antiga de disponibilidade que exclui a UE. A documentação atual de onboarding da Meta não tem restrição geográfica. - Cobrar clientes portugueses pela tarifa da Espanha. Portugal (+351) está em 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 da Espanha nessa data. **A Coexistência já ficou indisponível na UE?** Listas do início do lançamento a excluíam. A documentação atual de onboarding da Meta para usuários do app Business não indica restrição geográfica, então o próprio fluxo é o teste. **Enviar mensagens da Espanha para a América Latina tem preço da tarifa espanhola?** Não. A Meta cobra pelo código de país do destinatário, então uma mensagem para um número mexicano é cobrada pela tarifa do México. **Eu pago pelas mensagens que os clientes me enviam?** Não. A Meta cobra apenas pelas mensagens que uma empresa entrega aos usuários. **O app continua funcionando depois de conectar?** Sim. O app do WhatsApp Business permanece no celular com suas conversas, e o número ganha acesso à API. --- ## WhatsApp Coexistence na Índia: disponibilidade, tarifas da Meta e cobrança em INR https://easycoexistence.com/pt/docs/whatsapp-coexistence-india A Coexistência está disponível para números indianos: a documentação de onboarding da Meta para usuários do app do WhatsApp Business não cita nenhuma restrição de país. Desde 1º de outubro de 2026, a Meta cobra US$ 0,0118 por template de marketing entregue a um número +91 e US$ 0,0014 por template de utilidade ou autenticação. Empresas cujo país Sold-To no Billing Hub é a Índia devem migrar todas as contas do WhatsApp Business para INR até 31 de dezembro de 2026. ### A Coexistência do WhatsApp está disponível na Índia? Sim. A documentação atual da Meta para o onboarding de usuários do app do WhatsApp Business lista os requisitos (app na versão 2.24.17 ou mais recente, e um Tech Provider ou Solution Partner executando o Embedded Signup) e uma limitação: throughput fixo de 20 mensagens por segundo. Ela não cita restrição de país, região ou código de discagem, então um número +91 ativo no app do WhatsApp Business se qualifica nas mesmas condições de um número de qualquer outro lugar. O que impede um número indiano é o que impede qualquer número: continuar no app WhatsApp comum, usar uma versão do app anterior à 2.24.17 ou já estar vinculado a outro provedor. Se o Embedded Signup não recusar o número, a Coexistência está disponível para ele. ### Quanto a Meta cobra por mensagem na Índia? A Meta cobra por template de mensagem entregue, e a tarifa segue o código de país do destinatário, não a localização da empresa. Um template entregue a um número +91 é cobrado pela tarifa da Índia, esteja o remetente onde estiver. Os valores abaixo vêm das tabelas de tarifas da Meta em USD e INR, em vigor desde 1º de outubro de 2026. Respostas que não são template dentro de uma janela de atendimento de 24 horas aberta são gratuitas, templates de utilidade enviados dentro dessa janela são gratuitos, e mensagens digitadas no app do WhatsApp Business em um número com Coexistência continuam gratuitas. Templates de marketing são sempre cobrados. As faixas mensais de volume da Meta podem reduzir as tarifas de utilidade e autenticação para grandes remetentes. ### O que muda com a cobrança em INR na Índia? A Meta lançou a localização da cobrança em INR em 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 devem ter todas as contas do WhatsApp Business do seu portfólio migradas para INR até 31 de dezembro de 2026. A Meta afirma que, a partir de 1º de janeiro de 2027, deixará de entregar as mensagens de contas que não estejam em INR pertencentes a clientes elegíveis. Em um número com Coexistência, isso afeta os envios pagos pela API, porque a forma de pagamento fica na conta do WhatsApp Business da própria empresa. A Índia também tem 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 aviso prévio de 30 dias. ### Como conectar um número indiano à API e manter o app? Pelo Embedded Signup da Meta com a opção de Coexistência, executado por um Tech Provider. A empresa faz login com o Facebook, seleciona seu Portfólio de Negócios, informa o número +91 já registrado no app do WhatsApp Business e confirma escaneando um QR code exibido no app. O histórico de conversas do app pode então ser sincronizado, com mídia disponível apenas para as duas últimas semanas dele. O número continua funcionando no app e ganha acesso à Cloud API com throughput fixo de 20 mensagens por segundo. A sequência completa, com o que cada tela pede, está na página sobre como conectar um número. - Deixar uma conta do WhatsApp Business em USD depois de 31 de dezembro de 2026 quando o país Sold-To é a Índia. A Meta disse que vai parar de entregar essas mensagens. - Precificar uma campanha pelo país do remetente. A Meta cobra pelo código de discagem do destinatário, então destinatários +91 custam a tarifa da Índia. - Tratar todo template 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?** Respostas que não são template dentro da janela de atendimento de 24 horas são gratuitas, assim como as mensagens digitadas no app do WhatsApp Business. Templates fora da janela são cobrados. **Em qual moeda a Meta cobra as empresas indianas?** Empresas cujo país Sold-To no Billing Hub é a Índia estão migrando para INR, com todas as contas em INR até 31 de dezembro de 2026. A Meta publica uma tabela de tarifas em INR para isso. **Pago a tarifa da Índia se minha empresa fica no exterior?** Sim para marketing e utilidade, porque a tarifa segue o código +91 do destinatário. A autenticação pode passar para a tarifa de autenticação internacional quando a Meta definir uma data de início para a sua empresa. **Posso continuar usando o app no meu celular?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, desde que ele esteja na versão 2.24.17 ou mais recente e seja aberto com regularidade. --- ## Coexistência do WhatsApp na Indonésia: disponibilidade, tarifas da Meta e configuração https://easycoexistence.com/pt/docs/whatsapp-coexistence-indonesia Números indonésios podem usar a Coexistência, já que a documentação de onboarding da Meta para usuários do app do WhatsApp Business não impõe restrição de 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 continuam gratuitas. ### A Coexistência do WhatsApp está disponível na Indonésia? Sim. A página que a Meta publica sobre o onboarding de usuários do app do WhatsApp Business na Cloud API define requisitos sobre a versão do app (2.24.17 ou mais recente) e sobre o parceiro (um Tech Provider ou Solution Partner usando o Embedded Signup), mas não cita nenhum país ou código de discagem excluído. Um número +62 registrado e ativo no app do WhatsApp Business é elegível nas mesmas condições de qualquer outro. Os bloqueios práticos são os gerais: um número ainda no app WhatsApp comum, um app desatualizado ou um número já conectado ao app de outro provedor. A página de elegibilidade cobre cada um deles e o que resolve. ### Quanto a Meta cobra por mensagem na Indonésia? A Meta cobra por template entregue, pela tarifa do código de discagem do país do destinatário. Todo template que chega a um número +62 é cobrado pela tarifa da Indonésia, quer a empresa remetente esteja em Jacarta ou no exterior. As tarifas abaixo vêm das tabelas da Meta em USD e IDR em vigor desde 1º de outubro de 2026. Na Indonésia, utilidade e autenticação têm uma única tarifa, US$ 0.025, cerca de 61% da tarifa de marketing. Respostas livres dentro de uma janela de atendimento de 24 horas aberta não custam nada, um template de utilidade enviado dentro dessa janela é gratuito, e tudo o que a empresa digita no app do WhatsApp Business em um número com Coexistência também é gratuito. ### O que uma empresa indonésia deve saber sobre moeda de cobrança e autenticação? O IDR é uma das moedas de cobrança em que a Meta publica tabelas de tarifas, junto com o USD e outras catorze, então uma empresa indonésia pode ler seus custos em rupias direto na tabela da Meta, sem converter. A Indonésia também consta na lista da Meta de países com tarifa de autenticação internacional. Uma empresa sediada fora da Indonésia que envia códigos de uso único a números +62 pode passar a pagar US$ 0.136 por template de autenticação, mais de cinco vezes a tarifa doméstica. A Meta define a data de início para cada empresa e avisa com 30 dias de antecedência, então um app estrangeiro que verifica usuários indonésios deve se planejar antes de ampliar os cadastros. ### Como conectar um número indonésio sem perder o app? Com o Embedded Signup da Meta, usando a opção para um número de app do WhatsApp Business já existente. A empresa entra com o Facebook, escolhe seu Portfólio de Negócios, informa o número +62 e escaneia o QR code exibido no app. Concluída essa etapa, o parceiro tem 24 horas para iniciar a sincronização de contatos e do histórico de conversas, ou a empresa precisa refazer o fluxo. Depois do onboarding o celular continua funcionando como antes, o número responde também pela Cloud API, e os dois compartilham um throughput fixo de 20 mensagens por segundo. A página sobre como conectar um número mostra cada tela. - Converter um preço em USD para rupias manualmente. A Meta publica uma tabela de tarifas em IDR, e esse é o valor cobrado de uma conta em IDR. - Orçar códigos de uso único pela tarifa doméstica a partir de uma empresa sediada no exterior. A Indonésia tem uma tarifa de autenticação internacional de US$ 0.136. - Abandonar o fluxo depois de escanear o QR code. A sincronização precisa começar em até 24 horas, ou o onboarding deve 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 me cobrar em rupias?** O IDR é uma das moedas de cobrança que a Meta lista em sua página de preços, com tabela de tarifas própria, então os valores em rupias podem ser lidos direto na Meta. **As mensagens enviadas pelo celular são cobradas depois de conectar?** Não. A Meta afirma que as mensagens enviadas pelo app do WhatsApp Business continuam gratuitas após o onboarding da Coexistência. Só os envios pela Cloud API seguem os preços da Cloud API. **E se meu número ainda estiver no WhatsApp comum?** Ele precisa migrar antes para o app do WhatsApp Business. A Coexistência só é oferecida para números que já estão no app Business. --- ## Coexistência no WhatsApp nos Emirados Árabes Unidos: disponibilidade, tarifas da Meta e cobrança em AED https://easycoexistence.com/pt/docs/whatsapp-coexistence-uae A Coexistência está disponível para números dos Emirados Árabes Unidos, porque a documentação de onboarding da Meta para usuários do app do WhatsApp Business não cita nenhuma restrição de 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 autenticação. ### A Coexistência no WhatsApp está disponível nos EAU? Sim. A documentação da Meta para conectar usuários do app do WhatsApp Business à Cloud API lista o que a empresa e o parceiro precisam, principalmente a versão 2.24.17 ou mais recente do app e um Tech Provider ou Solution Partner usando o Embedded Signup, e não traz nenhuma exclusão de país, região ou código de discagem. Um número +971 em uso ativo no app do WhatsApp Business é elegível. Um número dos EAU falha pelos mesmos motivos que um número de qualquer lugar: está no app WhatsApp de consumidor, o app está desatualizado ou o número ainda está vinculado a outro provedor. O próprio Embedded Signup é o teste mais confiável, pois ele aceita o número ou informa por que não. ### Quanto a Meta cobra por mensagem nos EAU? A Meta cobra por template entregue, com preço definido pelo código de país do destinatário. Qualquer template entregue a um número +971 é cobrado pela tarifa dos EAU, não importa onde a empresa remetente esteja registrada. Os EAU têm uma linha própria na tabela de tarifas da Meta, em vez de compartilhar a tarifa do restante do Oriente Médio. Os valores abaixo vêm das tabelas da Meta em USD e AED em vigor a partir de 1º de outubro de 2026. Respostas livres dentro de uma janela de atendimento de 24 horas aberta são gratuitas, um template de utilidade enviado dentro dessa janela é gratuito, e as mensagens enviadas pelo app do WhatsApp Business em um número com Coexistência continuam gratuitas. Os templates de marketing são cobrados toda vez que são entregues. ### O que mudou recentemente nos preços e na cobrança dos EAU? Duas mudanças no histórico de preços da Meta se aplicam diretamente. Em 1º de outubro de 2025, a Meta aumentou a tarifa de mensagens de marketing dos Emirados Árabes Unidos. Em 1º de abril de 2026, adicionou oito moedas de cobrança, entre elas o AED, de modo que uma empresa nos Emirados agora pode ser cobrada em dirhams e consultar seus custos em uma tabela de tarifas em AED. Os EAU também estão na lista de mercados da Meta com tarifa de autenticação internacional. Uma empresa sediada fora dos Emirados que envia códigos de uso único para números +971 pode passar a pagar US$ 0.051 por template de autenticação assim que a Meta definir uma data de início, que ela anuncia com 30 dias de antecedência. ### Como conectar um número dos EAU à API e manter o app? Pelo Embedded Signup da Meta, com a opção de app do WhatsApp Business existente, executado por um Tech Provider. A empresa faz login com o Facebook, escolhe seu Portfólio de Negócios, informa o número +971 e confirma com um QR code exibido no app. A mídia do histórico de conversas sincronizado fica disponível apenas pelas últimas duas semanas. Depois disso, o app do WhatsApp Business continua funcionando no celular e o mesmo número recebe e envia pela Cloud API com um throughput fixo de 20 mensagens por segundo. A página de conexão de número lista cada etapa e o que cada uma exige. - Presumir que os EAU têm o preço do restante do Oriente Médio. Eles têm uma linha própria, mais alta, 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 do exterior pensando na tarifa doméstica. A tarifa de autenticação internacional é mais de três vezes maior. **A Meta pode cobrar uma empresa dos EAU em dirhams?** Sim. O AED passou a ser moeda de cobrança da WhatsApp Business Platform em 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 nos EAU e US$ 0.0107 na Arábia Saudita. **A resposta a um cliente que escreveu primeiro é cobrada?** Não, se for uma resposta livre dentro da janela de atendimento de 24 horas. Templates enviados fora da janela são cobrados. **O app no celular deixa de funcionar?** Não. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, e as mensagens enviadas por ele continuam gratuitas. --- ## WhatsApp Coexistence na Arábia Saudita: disponibilidade, tarifas da Meta e cobrança em SAR https://easycoexistence.com/pt/docs/whatsapp-coexistence-saudi-arabia Números sauditas podem usar a Coexistência: a documentação de onboarding da Meta para usuários do app do WhatsApp Business não define restrição de país. Desde 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 de utilidade ou autenticação. Respostas livres dentro da janela de atendimento não custam nada. ### A Coexistência do WhatsApp está disponível na Arábia Saudita? Sim. A documentação da Meta para levar usuários do app do WhatsApp Business para a Cloud API estabelece condições sobre a versão do app (2.24.17 ou mais recente) e sobre o parceiro que executa o Embedded Signup, e não lista nenhum país, região ou código de discagem excluído. Um número +966 registrado e ativo no app do WhatsApp Business é elegível. Quando um número saudita é recusado, a causa é uma das gerais: o número está no app WhatsApp de consumidor, o app é anterior à versão 2.24.17 ou o número ainda está ligado a outro provedor. A página de elegibilidade explica cada caso e a correção. ### Quanto a Meta cobra por mensagem na Arábia Saudita? A Meta precifica cada template entregue pelo código de país do destinatário. Templates entregues a números +966 são cobrados pela tarifa da Arábia Saudita, não importa onde o remetente esteja sediado, e o país tem uma linha própria na tabela de tarifas. Os valores abaixo vêm das tabelas da Meta em USD e SAR em vigor desde 1º de outubro de 2026. Respostas livres dentro de uma janela de atendimento de 24 horas aberta são gratuitas, templates de utilidade enviados dentro dessa janela são gratuitos, e mensagens enviadas pelo app do WhatsApp Business em um número com Coexistência não custam nada. Templates de marketing são cobrados a cada entrega, e faixas de volume mensal podem reduzir as tarifas de utilidade e autenticação para grandes remetentes. ### O que mudou para empresas sauditas em 2026? O dia 1º de abril de 2026 trouxe duas mudanças no changelog de preços da Meta. A tarifa de mensagens de marketing da Arábia Saudita subiu, e o SAR passou a ser uma das oito novas moedas de cobrança, então uma empresa saudita pode ser cobrada em riyals e conferir seus custos em uma tabela 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 exterior que envia códigos de uso único para números +966 pode passar a pagar US$ 0,0598 por template de autenticação, mais de cinco vezes a tarifa doméstica. A Meta define essa data de início por empresa e avisa com 30 dias de antecedência. ### Como conectar um número saudita e continuar usando o app? Com o Embedded Signup da Meta, escolhendo a opção para um número que já está no app do WhatsApp Business. Um Tech Provider hospeda o fluxo; a empresa entra com o Facebook, seleciona seu Portfólio de Negócios, informa o número +966 e escaneia o QR code exibido pelo app. O parceiro então tem 24 horas para iniciar a sincronização, ou o fluxo precisa ser repetido. Dali em diante, o celular continua funcionando como antes, e o mesmo número envia e recebe pela Cloud API com throughput fixo de 20 mensagens por segundo. Cada etapa está descrita na página sobre como conectar um número. - Orçar envios de marketing na Arábia Saudita 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 seus próprios valores em SAR. - Enviar códigos para números +966 de uma empresa no exterior pela tarifa doméstica. A tarifa de autenticação internacional é US$ 0,0598. **Uma empresa saudita pode ser cobrada em riyals?** Sim. A Meta incluiu o SAR como moeda de cobrança em 1º de abril de 2026 e publica uma tabela de tarifas em SAR. **A Arábia Saudita é precificada como Resto do Oriente Médio?** Não. Ela tem linha própria na tabela da Meta, com US$ 0,0576 para marketing e US$ 0,0107 para utilidade e autenticação. **As mensagens que digito no app são cobradas?** Não. A Meta afirma que mensagens enviadas pelo app do WhatsApp Business continuam gratuitas após o onboarding da Coexistência. **Qual versão do app eu preciso?** App do WhatsApp Business 2.24.17 ou mais recente no celular que tem o número +966. --- ## WhatsApp Coexistence na Turquia: disponibilidade, tarifas da Meta e configuração https://easycoexistence.com/pt/docs/whatsapp-coexistence-turkey Números turcos podem usar a Coexistência, já que a documentação de onboarding da Meta para usuários do app do WhatsApp Business não cita nenhuma restrição de país. A partir de 1º de outubro de 2026, a Meta cobra US$ 0,0109 por template de marketing entregue a um número +90 e US$ 0,0009 por template de utilidade ou autenticação. A Meta reduziu as tarifas de utilidade e autenticação da Turquia em 1º de abril de 2026 e não publica tabela de preços em liras. ### A Coexistência do WhatsApp está disponível na Turquia? Sim. A página que a Meta mantém sobre o onboarding de usuários do app do WhatsApp Business na Cloud API define requisitos para a versão do app (2.24.17 ou mais recente) e para o parceiro (um Tech Provider ou Solution Partner que use o Embedded Signup com registro de sessão), e não traz nenhuma exclusão por país ou código de discagem. Um número +90 ativo no app do WhatsApp Business é elegível. Um número turco só é recusado pelos mesmos motivos de qualquer outro número: está no app WhatsApp de consumidor, o app precisa de atualização ou outro provedor ainda detém o número. Cada um desses problemas se resolve no celular ou com o provedor anterior, e a página de elegibilidade explica como. ### Quanto a Meta cobra por mensagem na Turquia? A Meta cobra por template entregue, com base no código de discagem do país do destinatário, então todo template que chega a um número +90 é cobrado pela tarifa da Turquia, onde quer que o remetente esteja. A Turquia tem sua própria linha na tabela de tarifas. Na tabela em USD da Meta, em vigor desde 1º de outubro de 2026, os valores estão entre os mais baixos: US$ 0,0109 para marketing e US$ 0,0009 para utilidade e autenticação. A tabela em EUR lista €0,009 e €0,0007. A Meta não lista tarifa de autenticação internacional para a Turquia. Respostas livres dentro de uma janela de atendimento de 24 horas aberta são gratuitas, assim como um template de utilidade enviado nela, e as mensagens enviadas pelo app do WhatsApp Business em um número com Coexistência continuam gratuitas. ### Em qual moeda a Meta cobra as empresas turcas? A Meta publica suas tabelas de tarifas da WhatsApp Business Platform em dezesseis 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, então uma empresa turca é cobrada em uma dessas moedas, como USD ou EUR, e seus custos devem ser lidos nessa tabela, sem conversão. A mudança de tarifa mais importante é recente. Em 1º de abril de 2026, a Meta reduziu as tarifas de utilidade e autenticação da Turquia, o que faz atualizações de pedido e senhas de uso único para números +90 custarem uma fração de centavo cada. Orçamentos antigos, feitos antes dessa data, superestimam esses custos. ### Como conectar um número turco e manter o app? Pelo Embedded Signup da Meta, usando a opção para um número que já está no app do WhatsApp Business. Um Tech Provider hospeda o fluxo. A empresa entra com o Facebook, seleciona seu Portfólio de Negócios, informa o número +90 e confirma escaneando um QR code no app. A sincronização precisa começar em até 24 horas, ou o fluxo deve ser executado de novo. Depois de conectado, o celular continua funcionando e o mesmo número ganha acesso à Cloud API com throughput fixo de 20 mensagens por segundo. A página sobre como conectar um número explica tudo tela por tela. - Procurar uma tabela de tarifas em liras turcas. A Meta não publica uma; use a tabela em USD ou EUR em que sua conta é cobrada. - Usar um orçamento feito antes de 1º de abril de 2026. A Meta reduziu as tarifas de utilidade e autenticação da Turquia nesse dia. - Classificar promoções como utilidade para economizar. A Meta revisa as categorias dos templates, e um template de marketing é cobrado pela tarifa de marketing. **Existe tarifa de autenticação internacional para a Turquia?** Não. A tabela de tarifas da Meta em vigor desde 1º de outubro de 2026 a lista como não aplicável para a Turquia. **A Meta pode me cobrar em liras turcas?** Não. A lira não está entre as dezesseis moedas em que a Meta publica tabelas de tarifas. **As respostas a clientes na Turquia são gratuitas?** Respostas livres dentro da janela de atendimento de 24 horas são gratuitas. Templates fora da janela são cobrados por entrega. **Conectar a API faz o app parar de funcionar?** Não. Com a Coexistência, o app do WhatsApp Business continua funcionando no mesmo número, e suas mensagens continuam gratuitas. --- ## Coexistência do WhatsApp na Alemanha: disponibilidade, taxas da Meta e configuração https://easycoexistence.com/pt/docs/whatsapp-coexistence-germany Números alemães podem usar a Coexistência: a documentação de onboarding da Meta para usuários do app do WhatsApp Business não cita 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 autenticação. Respostas livres dentro da janela de atendimento são gratuitas. ### A Coexistência do WhatsApp está disponível na Alemanha? Sim. A documentação da Meta para o onboarding de usuários do app do WhatsApp Business na Cloud API define requisitos sobre a versão do app (2.24.17 ou mais recente) e sobre o parceiro que executa o Embedded Signup, e não cita restrição de país, região ou código de discagem. Também não acrescenta nenhuma condição específica para a União Europeia. Um número +49 registrado e ativo no app do WhatsApp Business é elegível. Se o Embedded Signup recusar um número alemão, o motivo é um dos gerais: o número ainda está no app WhatsApp de consumidor, o app é anterior à versão 2.24.17 ou outro provedor ainda o mantém. A página de elegibilidade cobre cada caso. ### Quanto a Meta cobra por mensagem na Alemanha? A Meta cobra por template entregue, com preço definido pelo código de país do destinatário. Um template entregue a um número +49 custa a taxa da Alemanha, esteja a empresa remetente em Berlim, Viena ou em qualquer outro lugar. A Alemanha tem uma linha própria na tabela de preços da Meta, bem 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 taxa de autenticação internacional para a Alemanha. Respostas livres dentro de uma janela de atendimento de 24 horas aberta são gratuitas, um template de utilidade enviado dentro dela é gratuito, e as mensagens digitadas no app do WhatsApp Business em um número com Coexistência continuam gratuitas. ### O que a taxa alemã significa para o uso da API por uma empresa? Como um template de marketing para um número +49 custa mais de treze centavos de dólar e um template de utilidade cinco centavos e meio, as mensagens mais baratas na Alemanha são as que a Meta simplesmente não cobra. Isso faz da janela de atendimento 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 a janela está aberta também é gratuito. A conta vem das ações ativas que abrem uma conversa com um template. Em um número com Coexistência, tudo o que a equipe digita no celular, no app do WhatsApp Business, também é gratuito, então a API pode ficar reservada para os envios automatizados. ### Como conectar um número alemão e manter o app? Com o Embedded Signup da Meta, usando a opção para um número que já está no app do WhatsApp Business. Um Tech Provider hospeda o fluxo; a empresa faz login com o Facebook, seleciona seu Portfólio de Negócios, informa o número +49 e confirma com o QR code exibido no app. A sincronização precisa começar em até 24 horas após a conclusão, ou o fluxo deve ser refeito. O celular continua funcionando depois, e o mesmo número envia e recebe pela Cloud API com throughput fixo de 20 mensagens por segundo. Cada tela está descrita na página sobre como conectar um número. - Orçar destinatários alemães pela taxa do Resto da Europa Ocidental. A Alemanha tem linha própria, mais que o dobro para marketing. - Abrir conversas com templates quando uma resposta dentro da janela de 24 horas bastaria. Na Alemanha, a diferença entre gratuito e pago é grande. - Classificar promoções como utilidade para pagar menos. A Meta revisa as categorias dos templates e cobra marketing pela taxa de marketing. **A Meta pode cobrar uma empresa alemã em euros?** Sim. O EUR é uma das moedas de cobrança em que a Meta publica tabelas de preços, com a Alemanha a €0,1131 para marketing na tabela de 1º de outubro de 2026. **A Coexistência tem condições extras na UE?** A documentação atual de onboarding da Meta para usuários do app Business não indica nenhuma. Os requisitos são os mesmos em todo lugar: app 2.24.17 ou mais recente e um parceiro do Embedded Signup. **A resposta a um cliente alemão é cobrada?** Não, quando é uma resposta livre dentro da janela de atendimento de 24 horas. Templates fora da janela são cobrados por entrega. **As mensagens enviadas pelo celular continuam gratuitas?** Sim. A Meta afirma que as mensagens enviadas pelo app do WhatsApp Business continuam gratuitas após o onboarding. Só os envios pela Cloud API seguem os preços da Cloud API. --- ## Coexistência do WhatsApp na Itália: disponibilidade, tarifas da Meta e configuração https://easycoexistence.com/pt/docs/whatsapp-coexistence-italy Números italianos podem usar a Coexistência, pois a documentação de onboarding da Meta para usuários do app do WhatsApp Business não cita 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 da Itália em 1º de julho de 2026. ### A Coexistência do WhatsApp está disponível na Itália? Sim. A documentação da Meta para o onboarding de usuários do app do WhatsApp Business na Cloud API lista o que é necessário, principalmente o app na versão 2.24.17 ou mais recente e um Tech Provider ou Solution Partner usando o Embedded Signup, e não contém exclusão de país, região ou código de discagem. Nada nela acrescenta condição para números da União Europeia. Um número +39 em uso ativo no app do WhatsApp Business é elegível. Um número italiano só é recusado pelos motivos gerais: está no app do WhatsApp pessoal, o app precisa de atualização ou outro provedor ainda o mantém. A página de elegibilidade explica cada caso e como resolvê-lo. ### Quanto a Meta cobra por mensagem na Itália? A Meta cobra por template entregue, pela tarifa do código de país do destinatário, então qualquer template que chega a um número +39 é cobrado pela tarifa da Itália, onde quer que a empresa esteja registrada. A Itália tem linha própria na tabela de tarifas, e não a tarifa do restante da Europa Ocidental. Os valores abaixo vêm das tabelas da Meta em USD e EUR em vigor desde 1º de outubro de 2026. A Meta não lista tarifa de autenticação internacional para a Itália. Respostas de formato livre dentro de uma janela de atendimento de 24 horas aberta são gratuitas, um template de utilidade enviado dentro dessa janela é gratuito, e mensagens enviadas pelo app do WhatsApp Business em um número com Coexistência não são cobradas. ### O que mudou nos preços da Itália em 2026? O histórico de preços da Meta registra uma mudança para a Itália neste ano: tarifa de mensagem de marketing mais alta 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. Utilidade e autenticação não fizeram parte dessa mudança. O efeito prático está nas campanhas. Um orçamento para templates promocionais a números +39 feito antes de julho de 2026 subestima o custo, enquanto confirmações de pedido, atualizações de entrega e senhas de uso único têm o mesmo preço de antes. A cobrança 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 conectar um número italiano e manter o app? Pelo Embedded Signup da Meta, escolhendo a opção para um número já registrado no app do WhatsApp Business. Um Tech Provider hospeda o fluxo. A empresa entra com o Facebook, seleciona seu Portfólio de Negócios, informa o número +39 e escaneia o QR code exibido no app. A mídia do histórico de conversas sincronizado cobre apenas as duas últimas semanas. Depois do onboarding o celular continua funcionando, e o mesmo número também envia e recebe pela Cloud API com throughput fixo de 20 mensagens por segundo. A página sobre conectar um número detalha cada etapa. - Usar um orçamento de marketing para destinatários +39 feito antes de 1º de julho de 2026. A Meta aumentou a tarifa de marketing da Itália nesse dia. - Aplicar a tarifa do restante da Europa Ocidental a números italianos. A Itália tem linha própria na tabela da Meta. - Iniciar o onboarding em um número que ainda está no app do WhatsApp pessoal. Ele precisa migrar antes para o app do WhatsApp Business. **A Meta pode cobrar uma empresa italiana em euros?** Sim. O EUR é uma das moedas de cobrança da Meta, e a tabela em EUR lista a Itália a €0.0658 para marketing e €0.0248 para utilidade e autenticação. **As tarifas de utilidade da Itália mudaram em 2026?** Não. A atualização de 1º de julho de 2026 aumentou apenas a tarifa de marketing da Itália. **As respostas a clientes italianos são cobradas?** Respostas de formato livre dentro da janela de atendimento de 24 horas são gratuitas. Templates enviados fora dela são cobrados na entrega. **Minha equipe ainda vai usar o app?** Sim. A Coexistência mantém o app do WhatsApp Business funcionando no mesmo número, e as mensagens enviadas por ele continuam gratuitas. --- ## Como desconectar a Coexistência e voltar a usar só o app https://easycoexistence.com/pt/docs/disconnecting-coexistence A Coexistência é desligada no próprio app do WhatsApp Business: Configurações, Conta, Plataforma Business e Desconectar conta. O app continua funcionando no número, o acesso do provedor termina e um webhook account_update com PARTNER_REMOVED é enviado. O endpoint Deregister da Cloud API não pode ser usado em um número que roda nos dois lugares. ### Como desligo a Coexistência? Pelo celular que tem o número. A Meta documenta um único caminho para um negócio sair da Cloud API quando o número é compartilhado com o app do WhatsApp Business, e ele passa pelo app, não por um painel ou endpoint. Quem tem o celular principal toma a decisão, então uma agência ou um desenvolvedor pede ao negócio que faça isso. - Abra o app do WhatsApp Business no dispositivo principal. - Vá em Configurações, depois Conta, depois Plataforma Business. - Toque em Desconectar conta e confirme. - Espere um webhook account_update com o evento PARTNER_REMOVED no lado da API. ### Por que a API Deregister recusa o número? Porque a Meta exclui de propósito os números em Coexistência. A documentação de registro afirma que o endpoint Deregister não pode cancelar o registro de um número de telefone comercial em uso na Cloud API e no app do WhatsApp Business ao mesmo tempo. Cancelar o registro é a operação que torna um número inutilizável na Cloud API e, em um número só de API, é a forma de tirá-lo da plataforma. Em um número compartilhado, o app é o dono principal do número, então a Meta devolve a decisão a quem está com o aparelho. Um software que tenta o endpoint primeiro recebe um erro, não uma desconexão, e o número continua conectado até alguém tocar no botão do app. ### O que acontece com o app, o histórico e o número? Desconectar não é o mesmo que excluir a conta, e essa diferença é a resposta inteira. O aviso da Meta sobre perda do histórico de mensagens vale para quem exclui a conta do app do WhatsApp Business e registra o número na Cloud API. Desconectar não faz nenhuma das duas coisas. O app continua instalado e registrado, o número continua nele e a equipe segue atendendo os clientes pelo mesmo celular. O que termina é o lado da API. O app do provedor é removido do número, então o envio pela Cloud API e a entrega de webhook para ele param. Os recursos que a Coexistência desligou, como as listas de transmissão, estão na página sobre recursos desativados. ### O número pode ser conectado de novo depois? Sim, executando o fluxo de onboarding de novo 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 reiniciar uma conexão, por exemplo quando a janela de 24 horas para sincronizar contatos e histórico foi perdida. Uma reconexão é um novo onboarding, então as perguntas feitas na primeira vez são feitas outra vez, inclusive se o histórico de conversas será compartilhado. Tudo que foi configurado na conexão antiga, como um override de webhook, precisa ser aplicado de novo. Um número que deve migrar para outro provedor segue o mesmo caminho: desconectar aqui e depois fazer o onboarding com o novo. - Chamar o endpoint Deregister em um número em Coexistência. A Meta recusa; a desconexão é feita no app. - Excluir a conta do app do WhatsApp Business para sair. Esse é o caminho que perde o histórico de conversas. - Tratar PARTNER_REMOVED como uma queda a ser repetida. É uma desconexão deliberada feita pelo negócio. **Vou perder minhas conversas se eu desconectar?** Não. Desconectar remove a API do número; não exclui a conta do app do WhatsApp Business, que é o que a Meta avisa que faz perder o histórico. **Posso desconectar pela API?** Não. A Meta não permite o endpoint Deregister em um número em uso na Cloud API e no app ao mesmo tempo. **Como meu sistema sabe que isso aconteceu?** A Meta envia um webhook account_update com o evento PARTNER_REMOVED quando o negócio se desconecta. **Posso reconectar o mesmo número?** Sim. Execute o fluxo de onboarding de novo desde o início, como na primeira conexão. --- ## Mover um número da Coexistência para só Cloud API https://easycoexistence.com/pt/docs/moving-from-coexistence-to-cloud-api Um número em Coexistência passa a usar só a API ao ser desconectado no app do WhatsApp Business, ter a conta do app excluída e ser registrado na Cloud API com um PIN de verificação em duas etapas. A Meta avisa que o histórico de mensagens existente é perdido, e o número só volta ao app se for removido do registro da Cloud API. ### Por que uma empresa sairia do app? Em geral porque ninguém mais responde pelo celular. Quando toda conversa é tratada por software ou por uma caixa de entrada construída sobre a API, o app só acrescenta obrigações: o dispositivo principal ainda precisa ser aberto com regularidade, e o número continua no throughput fixo da Coexistência. A Meta documenta que números usados ao mesmo tempo no app e na Cloud API têm throughput fixo de 20 mensagens por segundo. Um número só de API começa com até 80 mensagens por segundo por padrão e pode ser elevado automaticamente para 1.000 quando cumpre as condições da Meta. Para um número que envia em volume, essa diferença é o motivo da mudança. ### Qual é a ordem dos passos? São quatro passos, e a ordem importa porque o endpoint Deregister recusa um número que ainda é compartilhado com o app. Cada passo é feito pela empresa no celular, exceto o último, que é uma chamada de API feita por quem vai operar o número daqui em diante. - Faça backup do histórico de conversas no app do WhatsApp Business, como a Meta recomenda. - Desconecte no app: Configurações, Conta, Plataforma Business, Desconectar conta. - Exclua a conta do app: Configurações, Conta, Excluir minha conta, e aguarde até 3 minutos. - Registre o número na Cloud API com um PIN de verificação em duas etapas de 6 dígitos. ### O que a empresa deixa para trás? As conversas do celular e o próprio celular como forma de responder. A Meta afirma que excluir a conta do app do WhatsApp Business e registrar o número na Cloud API faz perder o histórico de mensagens existente. É o oposto do onboarding por Coexistência, em que a Meta indica que o histórico é preservado e os dois apps funcionam ao mesmo tempo. O número também não pode voltar a ser usado no app do WhatsApp Business, a menos que seja removido do registro da Cloud API antes. Portanto, é uma mudança deliberada e sem volta na forma de trabalhar da empresa, e vale confirmar que ninguém na equipe ainda depende do app antes de começar. ### O que continua igual no lado da API? A forma como o software conversa com o número. Continua sendo a Cloud API: valem os mesmos tipos de mensagem, templates, webhooks e preços, porque a Coexistência sempre foi apenas outro onboarding para a mesma plataforma. O que muda é o registro. Um número em Coexistência é registrado pelo fluxo de onboarding; um número só de API é registrado por uma chamada de registro com o PIN de verificação em duas etapas, e a Meta limita essas chamadas a 10 por número em uma janela móvel de 72 horas. Uma tentativa que falha, portanto, tem custo: confira o PIN antes de repetir. - Excluir a conta do app antes de fazer backup das conversas. A Meta afirma que, nesse caminho, o histórico se perde. - Chamar Deregister enquanto o número ainda é compartilhado com o app. A Meta recusa a requisição. - Repetir o registro em loop. A Meta permite 10 requisições de registro por número em 72 horas. **Posso manter o histórico de conversas ao passar para só API?** Não pela API. A Meta avisa que o histórico se perde e recomenda fazer backup pelo app antes. **O número pode voltar ao app depois?** Só depois de ser removido do registro da Cloud API, segundo o guia de migração da Meta. **O throughput melhora?** Sim. Números em Coexistência ficam fixos em 20 mps; números só de API começam com até 80 mps. **Posso usar a API Deregister para começar?** Não enquanto o número for compartilhado com o app. Desconecte-o antes no app do WhatsApp Business. --- ## Migrar um número de outro provedor de WhatsApp https://easycoexistence.com/pt/docs/migrating-a-number-from-another-provider Depende de como o número está conectado hoje. Um número compartilhado com o app do WhatsApp Business por meio de outro provedor é desconectado dentro do app e depois conectado de novo com o novo provedor. Um número só API passa pela migração de número de telefone da Meta, que mantém o nome de exibição, a classificação de qualidade, o limite de mensagens e o status de Official Business Account. ### Em qual caso eu estou? Faça uma só pergunta: alguém ainda atende este número pelo app do WhatsApp Business em um celular? Se sim, o número está em Coexistência com o provedor atual, e quem o mantém é o app. Sair desse provedor acontece no app, e entrar em um novo é um onboarding novo de Coexistência. Se não, o número está registrado apenas na Cloud API, sem app por trás. A Meta tem uma migração separada para isso, que move o número da WhatsApp Business Account de um parceiro para a de outro sem registrá-lo do zero. Confundir os dois casos é o motivo mais comum de uma mudança travar no meio do caminho. ### Como um número em Coexistência troca de provedor? Fazendo offboarding e onboarding de novo. A Meta documenta que a empresa desconecta da Cloud API no app, em Configurações, Conta, Business Platform, usando o botão Disconnect Account, e que o provedor recebe um webhook account_update com PARTNER_REMOVED. Depois de desconectado, o número volta a ser apenas um número do app do WhatsApp Business e pode ser conectado pelo novo provedor por meio do Embedded Signup. As condições são as mesmas da Coexistência: uma versão recente do app, um portfólio que você administra e nenhum outro provedor ainda conectado. A pergunta sobre compartilhar o histórico é feita de novo, e a janela de sincronização de 24 horas recomeça a partir do novo onboarding. ### O que é mantido em uma migração só API? Mais do que a maioria espera, e é por isso que a migração existe em vez de excluir e registrar de novo. O número mantém a reputação que construiu com os clientes, e só o histórico de qualidade dos templates recomeça. - Nome de exibição, classificação de qualidade, limite de mensagens e status de Official Business Account são preservados. - Os templates elegíveis são duplicados na conta de destino com os mesmos status. - As mídias já enviadas no número continuam podendo ser usadas. - As classificações de qualidade dos templates não são mantidas: todo template migrado começa como UNKNOWN. ### O que precisa estar pronto antes de uma migração só API? A Meta lista condições dos dois lados, e as do lado do cliente são onde as mudanças costumam travar. O portfólio da empresa na Meta precisa estar verificado, a WhatsApp Business Account existente aprovada e com uma forma de pagamento válida. O número precisa estar com a verificação em duas etapas desativada, e a Meta não oferece endpoint de API para desativá-la, então o provedor não consegue fazer essa etapa pela API. No lado receptor, pelo menos um app precisa estar inscrito nos webhooks da conta de destino. O registro na nova conta é instantâneo e sem interrupção das mensagens, mas a duplicação dos templates leva tempo, então os templates afetados não podem ser usados até que suas cópias existam. - Fazer o onboarding com um novo provedor enquanto o antigo ainda está conectado. O número precisa ser desconectado no app primeiro. - Iniciar uma migração só API com a verificação em duas etapas ativada. A Meta exige que esteja desativada, e nenhum endpoint faz isso. - Esperar que a qualidade dos templates seja mantida. Os templates migrados recomeçam em UNKNOWN. **Perco meus chats ao trocar de provedor de Coexistência?** O app os mantém o tempo todo. Compartilhar o histórico com a nova conexão é oferecido de novo no onboarding. **Uma migração só API muda 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 status de Official Business Account. **Por que meus templates perderam a classificação de qualidade?** A Meta duplica os templates na conta de destino, e cada cópia começa com a classificação UNKNOWN. **Há tempo fora do ar?** A Meta afirma que o registro em uma migração só API é instantâneo e sem interrupção das mensagens. Os templates ficam utilizáveis depois de duplicados. --- ## Grupos do WhatsApp e a API em um número com Coexistência https://easycoexistence.com/pt/docs/whatsapp-groups-and-the-api A Groups API da Meta permite que um número da Cloud API crie pequenos grupos só por convite e envie mensagens a eles, mas a Meta afirma que ela não está disponível para números do app do WhatsApp Business, que é o caso de um número com Coexistência. Os grupos já existentes no app também não são sincronizados. Em um número compartilhado, grupos continuam sendo um recurso exclusivo do app. ### O WhatsApp tem uma Groups API? Sim. A Groups API da Meta permite que uma empresa crie, liste e atualize grupos em um número da Cloud API, envie mensagens de texto, mídia e template para eles, gerencie o link de convite, aprove ou rejeite pedidos de entrada e remova participantes. Ela é pequena de propósito. Os grupos são só por convite, com entrada por um link que a empresa envia, 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 da empresa. - Uma empresa da Cloud API por grupo. - Texto, mídia, templates de texto e templates com mídia. ### Um número com Coexistência pode usá-la? Não. A página da Groups API afirma que ela não está disponível para números do app do WhatsApp Business, e essa frase leva ao guia da própria Meta para o onboarding de usuários do app do WhatsApp Business, que é a Coexistência. A condição de elegibilidade também é ter uma Official Business Account, um status que a página de OBA da Meta diz não conceder a números do app do WhatsApp Business. Portanto, a exclusão é definida pela Meta para todos os provedores. Um número compartilhado entre o app e a API não consegue criar grupos pela API, não consegue enviar mensagens a eles e não recebe eventos de grupo. ### O que acontece com os grupos que já estão no app? Eles ficam no app e continuam funcionando lá. A documentação de Coexistência da Meta lista as conversas em grupo entre o que não é sincronizado quando um número é conectado, então nem o histórico nem as novas mensagens de grupo chegam à API. A equipe no celular continua podendo criar grupos, publicar neles e lê-los exatamente como antes. O software simplesmente não enxerga esse tráfego. Se um fluxo de trabalho depende de um grupo, como a equipe coordenando entregas, ele segue no app, e qualquer automação em torno dele precisa ser construída a partir de conversas individuais. ### O que usar no lugar de grupos pela API? Conversas individuais, que é em torno do que a plataforma foi construída. Uma mensagem que iria para um grupo de clientes vai para cada um deles individualmente, dentro da janela de atendimento de 24 horas como texto livre, ou fora dela como template aprovado. Se uma empresa realmente precisa de grupos gerenciados pela API, a Groups API exige um número registrado apenas na Cloud API e com uma Official Business Account, o que significa sair da Coexistência para esse número. É uma decisão estrutural sobre o número, não uma configuração, e ela remove o app dele. - Ler que existe uma Groups API e supor que ela vale para um número com Coexistência. A Meta exclui os números do app Business. - Esperar que o histórico de grupos apareça na API após o onboarding. As conversas em grupo não são sincronizadas. - Planejar um fluxo baseado em grupos em torno de um limite de 8 participantes sem verificar se ele cabe. **Posso enviar uma mensagem a um grupo do WhatsApp pela API?** Só a partir de um número exclusivo da API com uma Official Business Account, usando a Groups API. Não a partir de um número com Coexistência. **Meus grupos atuais continuam funcionando?** Sim, no app do WhatsApp Business. Eles não são sincronizados com a API. **Quantas pessoas podem entrar em um grupo da API?** A Meta limita os grupos criados pela Groups API a 8 participantes. **Isso é um limite do meu provedor?** Não. A Meta define a exclusão dos números do app do WhatsApp Business em todos os provedores. --- ## Meta Verified e o selo de conta comercial oficial em um número com Coexistência https://easycoexistence.com/pt/docs/meta-verified-and-coexistence Duas coisas diferentes são chamadas de selo azul. Official Business Account é um status solicitado para um número da Cloud API, e a documentação da Meta diz que ele não é concedido a números do app do WhatsApp Business. Meta Verified for WhatsApp Business é uma assinatura contratada no app, com selo de verificação, acesso multiagente e suporte aprimorado. ### O que é uma Official Business Account? Um status em um número comercial registrado na WhatsApp Business Platform. A Meta o descreve como um número de uma empresa verificada como autêntica, exibido com uma marca de verificação azul ao lado do nome na lista de contatos. Ele é solicitado no WhatsApp Manager, no perfil do número, ou pelo campo official_business_account da API. - A empresa cumpre a WhatsApp Business Messaging Policy. - Está registrada na plataforma há pelo menos 30 dias. - Seu Portfólio de Negócios passou pela Verificação da Empresa. - O número tem verificação em duas etapas ativada e um nome de exibição aprovado. ### Um número com Coexistência pode obter o status de OBA? A documentação de OBA da Meta diz que o status não é concedido a funcionários da empresa, contas de teste e números do app do WhatsApp Business. A Meta usa o mesmo termo, números do app do WhatsApp Business, na página da Groups API e o liga ao guia de onboarding de usuários do app do WhatsApp Business, que é a Coexistência. A Meta não publica uma regra separada para números compartilhados entre o app e a API, então a posição documentada é a acima. Uma solicitação recusada pode ser reenviada após 30 dias, e o perfil comercial continua editável nesse período. ### O que é o Meta Verified for WhatsApp Business? Uma assinatura paga contratada pelo app do WhatsApp Business, separada do processo de OBA da plataforma. A página de recursos da Meta lista o que ela inclui: um selo de verificação, uma página web personalizada, suporte aprimorado, uma conta multiagente que conecta vários dispositivos e atribui conversas a agentes de vendas, e selos de verificação em até 10 Canais do WhatsApp. Como é contratada no app, ela pertence ao lado do app de um número com Coexistência. A página da Meta pede que a empresa confirme que as informações do negócio e da conta estão atualizadas antes de assinar, e não publica um preço fixo ali. ### O selo continua se eu trocar de número? Para a OBA, a Meta documenta um caso de forma explícita: um número migrado de um Solution Partner para outro pelo Embedded Signup mantém o nome de exibição, a classificação de qualidade, o limite de mensagens e o status de Official Business Account. Não existe declaração equivalente para a troca do número em si, e uma OBA pertence a um número comercial específico, então outro número é outra solicitação. A aprovação do nome de exibição é uma das condições da OBA, por isso vale planejar uma mudança de nome antes da solicitação, e não depois. - Tratar OBA e Meta Verified como um único selo. Um é um status da plataforma, o outro uma assinatura do app. - Solicitar a OBA antes de 30 dias na plataforma. A Meta exige esse mínimo, e uma recusa significa esperar 30 dias. - Solicitar a OBA com a verificação em duas etapas desativada ou com o nome de exibição pendente. As duas são condições listadas. **Meta Verified é o mesmo que uma Official Business Account?** Não. A Meta os documenta separadamente: a OBA é um status solicitado para um número da plataforma, e o Meta Verified é uma assinatura contratada no app. **Posso assinar o Meta Verified com um número com Coexistência?** O Meta Verified é contratado pelo app do WhatsApp Business, que um número com Coexistência continua usando. **Quanto tempo preciso esperar para solicitar a OBA?** O número deve estar registrado na WhatsApp Business Platform há pelo menos 30 dias. **E se minha solicitação de OBA for negada?** A Meta pede que você espere 30 dias antes de reenviar. --- ## Vários agentes e sistemas respondendo um número com Coexistência https://easycoexistence.com/pt/docs/multiple-agents-on-one-number Um número com Coexistência pode ser atendido por pessoas e por software ao mesmo tempo. A equipe usa o app do WhatsApp Business e seus dispositivos vinculados, até quatro além do celular principal, enquanto os sistemas usam a Cloud API. Toda mensagem que uma pessoa envia pelo app ou por um dispositivo vinculado chega ao software como um webhook smb_message_echoes, então os dois lados compartilham a mesma conversa. ### Como várias pessoas respondem o mesmo número? Por meio de dispositivos vinculados. O WhatsApp permite usar uma conta em até quatro dispositivos adicionais, além do celular principal, e o anúncio do recurso citou o caso de uso de forma direta: funcionários de uma pequena empresa respondendo clientes de seus próprios celulares, na mesma conta do WhatsApp Business. Em um número com Coexistência isso continua valendo. O celular principal segue como dono da conta, e os demais funcionários trabalham em celulares, tablets, navegadores ou apps de desktop vinculados. Quais clientes complementares são compatíveis, e o que o onboarding faz com eles, está na página sobre dispositivos vinculados. ### Onde o software entra? No lado da API do mesmo número. Um CRM, uma ferramenta de automação ou um agente de IA envia pela Cloud API e recebe as mensagens dos clientes por webhooks, enquanto as pessoas continuam usando o app. O número é o mesmo nos dois lados, então o cliente vê uma única conversa, não importa quem escreveu cada mensagem. As mensagens enviadas pela API aparecem na conversa do app, e a equipe vê o que o sistema já disse. A única restrição compartilhada é o volume: a Meta fixa em 20 mensagens por segundo um número usado ao mesmo tempo no app e na Cloud API. ### Como o software sabe que uma pessoa já respondeu? Pelo eco. O webhook smb_message_echoes da Meta é disparado quando uma empresa integrada por um parceiro envia uma mensagem pelo app do WhatsApp Business ou por um dispositivo vinculado, e também quando uma mensagem é editada ou apagada no app. Isso cobre todas as pessoas que atendem o número, tenham digitado no celular principal ou em um notebook vinculado. Um sistema que lê os ecos pode marcar a conversa como atendida por uma pessoa e interromper a própria resposta, e essa é a diferença entre uma automação que ajuda a equipe e uma que fala por cima dela. - Enviada pelo app ou por um dispositivo vinculado: chega um eco. - Editada no app: chega um eco. - Apagada no app: chega um eco. ### O que cada lado precisa ter em mente? A equipe precisa manter o celular principal em uso. A Meta desconecta um número com Coexistência após cerca de 14 dias de inatividade no dispositivo principal, e um dispositivo vinculado após cerca de 30 dias de inatividade própria, então uma equipe que trabalha só em notebooks pode perder os dois. O software segue as regras da plataforma: texto livre dentro da janela de atendimento de 24 horas e templates fora dela. E nenhum dos lados tem conversas de grupo pela API, que a Meta exclui em números compartilhados com o app. - Ignorar o smb_message_echoes. Sem ele, um bot não percebe que uma pessoa já respondeu de um notebook vinculado. - Tocar toda a equipe em notebooks vinculados enquanto o celular principal fica semanas sem uso. - Vincular o WhatsApp para Windows depois do onboarding. A Meta o lista como incompatível com números em Coexistência. **Quantas pessoas podem responder um número?** O WhatsApp permite até quatro dispositivos vinculados além do celular principal, e cada um pode ser usado por uma pessoa diferente. **As mensagens de um notebook vinculado chegam ao meu CRM?** Sim. A Meta envia o smb_message_echoes para mensagens enviadas pelo app ou por um dispositivo vinculado. **Um chatbot e uma pessoa podem dividir a mesma conversa?** Sim. Os dois escrevem na mesma conversa, e os ecos deixam o bot ver quando uma pessoa respondeu. **Existe limite de assentos no lado da API?** A Meta limita o volume da API, fixando um número compartilhado em 20 mensagens por segundo, e não a quantidade de sistemas. --- ## Dispositivos vinculados e Coexistência: o que é desvinculado https://easycoexistence.com/pt/docs/linked-devices-and-coexistence Ao conectar um número do app do WhatsApp Business à Cloud API, todos os dispositivos complementares da conta são desvinculados. Os complementares com suporte, como o WhatsApp Web e celulares vinculados como complementares, podem ser vinculados de novo depois. O WhatsApp para Windows e o WhatsApp para WearOS não têm suporte em um número com Coexistência, e um complementar deixado inativo por cerca de 30 dias é desconectado. ### O que acontece com os dispositivos vinculados durante o onboarding? Todos são desconectados. A documentação da Meta afirma que, quando uma empresa faz o onboarding na Cloud API com uma conta e um número existentes do app do WhatsApp Business, todos os apps complementares são desvinculados da conta, e a empresa pode então vincular de novo os apps complementares com suporte. Nada se perde com isso: o celular principal mantém a conta e as conversas. Mas uma recepção que atende por um navegador ou por um segundo celular vai se ver desconectada assim que o onboarding terminar, então vale avisar a equipe antes de escanear o QR code, e não depois. ### Quais dispositivos complementares têm suporte depois? Todos, exceto dois. A Meta lista todos os clientes complementares como compatíveis com um número em Coexistência, com exceção do WhatsApp para Windows e do WhatsApp para WearOS. Cada um dos que têm suporte é vinculado de novo do jeito de sempre, escaneando um QR code com o celular principal, e conta no mesmo limite de dispositivos de antes. - WhatsApp Web no navegador: tem suporte, vincule de novo com o QR code. - Celulares adicionais vinculados como complementares: têm suporte. - WhatsApp para Windows: não tem suporte. - WhatsApp para WearOS em um relógio: não tem suporte. ### Quantos dispositivos podem ser vinculados? Até quatro além do celular principal. O anúncio do WhatsApp sobre o multidispositivo em celulares descreveu a vinculação de um celular como um de até quatro dispositivos adicionais, junto com navegadores web, tablets e desktops, e citou como uso a equipe de pequenas empresas atendendo clientes pelos próprios celulares. Em um número com Coexistência, o limite é compartilhado entre os clientes complementares que continuam com suporte. Um escritório que usava o app para Windows costuma migrar esses postos para o WhatsApp Web no navegador, que conta como um dos quatro, como qualquer outro complementar. ### O que mantém os dispositivos vinculados conectados? Duas regras de inatividade, uma para cada tipo de dispositivo, e ambas aparecem como motivos nos dados de desconexão da Meta. PRIMARY_INACTIVITY vale para o celular principal e dispara após cerca de 14 dias sem atividade. O WhatsApp também diz que, quando o dispositivo principal fica inativo por muito tempo, a conta é desconectada de todos os dispositivos complementares, então um celular principal sem uso leva junto todos os dispositivos vinculados. COMPANION_INACTIVITY vale para um dispositivo complementar isolado, após cerca de 30 dias de inatividade. Um notebook pouco usado em uma filial é o caso típico. - Fazer o onboarding sem avisar a equipe que atende pelo WhatsApp Web. Ela é desconectada quando o onboarding termina. - Vincular de novo o app WhatsApp para Windows. A Meta o lista como sem suporte em números com Coexistência. - Deixar o celular principal na gaveta porque todos trabalham em dispositivos vinculados. A inatividade dele desconecta os complementares também. **A Coexistência desvincula o WhatsApp Web?** Sim, no onboarding todos os complementares são desvinculados. O WhatsApp Web tem suporte e pode ser vinculado de novo na hora. **Posso usar o app de desktop do WhatsApp no Windows?** Não em um número com Coexistência. A Meta lista o WhatsApp para Windows como um complementar sem suporte. **A própria Coexistência é um dispositivo vinculado?** Não. Ela é a Cloud API conectada ao número pelo onboarding da Meta e não ocupa uma vaga de complementar. **Quantos complementares posso vincular?** Até quatro além do celular principal, entre os clientes complementares que a Meta suporta. --- ## Trocar o número de telefone em uma conexão Coexistência https://easycoexistence.com/pt/docs/changing-the-phone-number Uma conexão Coexistência pertence a um único número de telefone. Quando a empresa troca o número no app do WhatsApp Business, a Meta desconecta a conexão com o motivo CHANGE_NUMBER. O novo número é outro número de telefone comercial na plataforma e precisa passar pelo fluxo de Coexistência como uma nova conexão. ### O que acontece com a conexão quando o número muda? Ela termina. A Meta inclui a troca de número de telefone entre os motivos de desconexão de uma conexão Coexistência e a informa no disconnection_info do webhook account_update, com o motivo CHANGE_NUMBER. Isso é a plataforma sendo coerente, não rígida. Tudo o que o lado da API conhece está vinculado a um número de telefone comercial: o phone number ID, o nome de exibição, a classificação de qualidade e as assinaturas de webhook. Outro número é outro ativo, então nada do que estava ligado ao antigo se move sozinho, e a conexão antiga deixa de funcionar no momento da troca. ### Como conecto o novo número? Como uma primeira conexão. O novo número precisa cumprir as mesmas condições de qualquer número que entra na Coexistência e depois passar pelo onboarding desde o início. Nada da conexão antiga é reaproveitado, então vale tratar a troca como um pequeno projeto com data marcada. - Estar ativo no app do WhatsApp Business, na versão 2.24.17 ou mais recente. - Estar em um Portfólio de Negócios que você administra. - Não estar vinculado a outro provedor. - Ter o nome de exibição informado no registro, como em qualquer número de telefone comercial. ### O que deve ser atualizado no lado da API? Todos os lugares em que o número antigo ou o ID dele estão guardados. As integrações que enviam pela Cloud API endereçam um phone number ID, então um CRM, um fluxo de automação ou um agente de IA que ainda aponte para o ID antigo vai falhar em vez de migrar. A nova conexão também repete as perguntas do onboarding, incluindo se o histórico de conversas será compartilhado e a janela de 24 horas para sincronizá-lo. O destino de webhook configurado na conexão antiga precisa ser aplicado à nova. Vale conferir também a capacidade do portfólio: a Meta limita um novo portfólio de negócios a dois números de telefone comerciais registrados até que ele seja verificado ou alcance um limite de 2,000 mensagens. ### O que acontece com o número antigo na plataforma? Ele continua como um ativo na conta do WhatsApp Business até que alguém o remova. A Meta só permite que administradores do portfólio de negócios excluam números de telefone comerciais e recusa a exclusão de um número usado para enviar mensagens pagas nos últimos 30 dias. Excluir é uma arrumação opcional, não um requisito para conectar o novo número, mas deixar números antigos na conta facilita que um sistema continue endereçando o número errado. Removê-lo depois que os 30 dias passarem mantém a conta legível. - Trocar o número no app antes de planejar a reconexão. A conexão antiga termina nesse momento. - Deixar o phone number ID antigo nas integrações. Os envios falham em vez de seguir o novo número. - Tentar excluir o número antigo logo após a troca. A Meta bloqueia se ele enviou mensagens pagas em 30 dias. **A conexão acompanha o meu novo número?** Não. A Meta a desconecta com o motivo CHANGE_NUMBER, e o novo número é conectado como uma nova conexão. **Preciso de um novo phone number ID?** Sim. O novo número é um número de telefone comercial separado na plataforma, com ID próprio. **Posso excluir o número antigo imediatamente?** Só se ele não tiver enviado mensagens pagas nos últimos 30 dias, e somente um administrador do portfólio pode excluí-lo. **Preciso escolher o nome de exibição de novo?** Sim. A Meta exige as informações do nome de exibição quando um número de telefone comercial é registrado. --- ## Verificação de empresa da Meta e números em Coexistência https://easycoexistence.com/pt/docs/business-verification A verificação de empresa da Meta vale para um Portfólio de Negócios da Meta, não para um número de telefone. Um portfólio pode enviar sem ela, começando com limite de 250 destinatários únicos por dia e dois números registrados. Verificar é um caminho para o limite de 2.000, eleva o teto de números para 20 e é exigido antes de pedir o selo azul. ### A verificação de empresa é obrigatória para conectar um número? Não. A documentação da Meta trata a verificação como uma forma de ampliar o que um portfólio pode fazer, não como condição para enviar mensagens. Um Portfólio de Negócios recém-criado começa com limite de 250 destinatários únicos fora da janela de atendimento em 24 horas móveis, e com teto de dois números de telefone comerciais registrados. Ambos valem com o portfólio verificado ou não, e a empresa pode falar com seus clientes dentro desses limites desde o primeiro dia. O que a verificação muda é o teto. Ela é um dos três caminhos que a Meta lista para elevar o limite de mensagens de 250 para 2.000, e um dos dois gatilhos para ampliar o teto de números registrados para 20. ### O que a verificação libera no WhatsApp? Três coisas separadas, que muitas vezes são descritas como uma só. - Um caminho para o limite de mensagens: verificar é uma forma de se qualificar para 2.000, e a partir daí o escalonamento automático da Meta assume. - Um teto maior de números: a Meta eleva o portfólio de dois números registrados para 20 e envia um webhook business_capability_update. - Elegibilidade à Conta Comercial Oficial: o portfólio dono do número precisa estar verificado antes de o selo azul poder ser solicitado. - Nenhuma das três muda o funcionamento do app do WhatsApp Business no celular. ### Como a verificação vale para um número em Coexistência? Por meio do portfólio. Um número conectado via Coexistência fica em uma conta do WhatsApp Business que pertence a um Portfólio de Negócios da Meta, e a verificação é uma propriedade desse portfólio. Todos os números dele compartilham o resultado, junto com o limite de mensagens do portfólio. O selo azul é mais restrito. A página de Conta Comercial Oficial da Meta afirma que o status não é concedido, entre outros, a números do app do WhatsApp Business, e não descreve separadamente números usados ao mesmo tempo no app e na Cloud API. Os demais critérios são a verificação, pelo menos 30 dias na plataforma, verificação em duas etapas no número e um nome de exibição aprovado. ### Qual portfólio deve ser verificado? Aquele que é dono da conta do WhatsApp Business, que, para uma empresa que conecta o próprio número, deve ser o portfólio da própria empresa. Isso importa para agências. Se o número de um cliente é conectado dentro do portfólio da agência, valem a verificação, o limite e o teto de números da agência, e o limite do cliente é dividido com todos os outros números que a agência mantém ali. A Meta afirma claramente que um único número pode consumir toda a capacidade de mensagens de um portfólio em um determinado período. Conectar cada empresa dentro do seu próprio portfólio mantém verificação, limites e cobrança com a empresa que de fato está enviando. - Adiar uma conexão até a verificação terminar. O envio funciona sem ela, dentro do limite inicial. - Verificar um portfólio diferente daquele que é dono da conta do WhatsApp Business. O resultado não é transferido. - Manter números de vários clientes em um só portfólio de agência. Eles compartilham um único limite de mensagens e um único teto de números. **Preciso da verificação de empresa para usar a Coexistência?** Não. Um portfólio pode enviar sem ela, com limite inicial de 250 destinatários únicos em 24 horas móveis. **A verificação me dá o selo azul?** Não por si só. Ela é um dos requisitos para o status de Conta Comercial Oficial, que é solicitado separadamente e analisado pela Meta. **A verificação é por número?** Não. Ela pertence ao Portfólio de Negócios da Meta, e todos os números desse portfólio a compartilham. **A verificação muda o app no meu celular?** Não. Ela muda limites e elegibilidade da plataforma, não o comportamento do app do WhatsApp Business. --- ## Limites de envio do WhatsApp: os níveis atuais por Portfólio de Negócios https://easycoexistence.com/pt/docs/messaging-limits-and-tiers Um limite de envio define para quantas pessoas únicas uma empresa pode entregar mensagens fora da janela de atendimento em 24 horas móveis. Desde 7 de outubro de 2025 ele vale por Portfólio de Negócios da Meta e é compartilhado por todos os números dele, começando em 250 e subindo para 2.000, 10.000, 100.000 e ilimitado. ### O que o limite de envio realmente conta? Números de telefone únicos de usuários do WhatsApp para os quais sua empresa entrega mensagens fora de uma janela de atendimento, dentro de 24 horas móveis. Três consequências decorrem dessa formulação. Respostas dentro de uma janela de atendimento aberta não contam, então um número que só responde a quem escreveu primeiro pode operar muito acima do limite sem encostar nele. Enviar vários templates para a mesma pessoa conta essa pessoa uma única vez. E a janela é móvel, não um dia do calendário, então a capacidade volta aos poucos conforme os envios mais antigos saem da contagem. O limite trata de quantas pessoas você alcança primeiro, não de quão rápido ou quanto você envia. ### O que mudou em outubro de 2025? Antes de 7 de outubro de 2025, cada número de telefone tinha o próprio limite, e um número novo começava em 250 independentemente do que os outros tinham conquistado. Desde então o limite pertence ao Portfólio de Negócios e todos os números dele o compartilham. - Um número recém-registrado passa a compartilhar na hora o limite do portfólio. - O primeiro degrau depois de 250 é 2.000, onde antes era 1.000. - Os aumentos chegam 6 horas depois de atendidos os critérios, em vez de 24. - Uma queda na classificação de qualidade de um número não rebaixa mais o limite. - O campo a ler é whatsapp_business_manager_messaging_limit; messaging_limit_tier está obsoleto. ### Como o limite sobe? Em duas etapas. Para sair de 250, o portfólio conclui um caminho de escalonamento: verificar a empresa, fazer o parceiro de onboarding verificá-la, ou entregar 2.000 mensagens fora das janelas de atendimento a destinatários únicos em 30 dias, usando templates com alta classificação de qualidade. Em seguida a Meta analisa a qualidade das mensagens e aprova ou nega, e a negativa chega como um webhook account_alerts que indica a alternativa a seguir. A partir de 2.000 o escalonamento é automático. A Meta sobe o portfólio um nível quando ele envia mensagens de alta qualidade em todos os seus números e templates e usou pelo menos metade do limite atual nos últimos 7 dias. Não há nada a comprar nem formulário a enviar. ### Como o limite de envio difere do throughput? O limite conta pessoas por dia; o throughput conta mensagens por segundo. Eles são definidos separadamente e falham separadamente. Em um número com Coexistência a diferença é nítida. A Meta fixa o throughput em 20 mensagens por segundo para qualquer número usado ao mesmo tempo no app do WhatsApp Business e na Cloud API, para manter a compatibilidade com o app. Esse valor não muda com o nível do portfólio, então um portfólio com limite de envio ilimitado ainda envia a 20 por segundo a partir de um número com Coexistência. O limite por segundo, o limite por destinatário e o limite de chamadas de gerenciamento têm cada um a própria página e os próprios códigos de erro. - Ler messaging_limit_tier. Ele está obsoleto; o campo atual é whatsapp_business_manager_messaging_limit. - Presumir que cada número novo começa em 250. Desde outubro de 2025 ele herda o limite do portfólio na hora. - Contar respostas no limite. Mensagens dentro de uma janela de atendimento aberta não fazem parte dele. - Deixar a campanha de um número esgotar os outros. O portfólio inteiro consome o mesmo limite. **O limite é por número ou por conta?** Por Portfólio de Negócios da Meta desde 7 de outubro de 2025. Todos os números do portfólio o compartilham. **As respostas dos clientes contam no meu limite?** Não. Só contam as entregas fora de uma janela de atendimento, e cada destinatário único conta uma vez a cada 24 horas móveis. **Uma classificação de qualidade baixa pode reduzir meu limite?** Não desde outubro de 2025. A Meta parou de rebaixar limites por quedas de qualidade, embora a qualidade ainda decida se o limite cresce. **Um nível mais alto aumenta o throughput da Coexistência?** Não. O throughput de um número com Coexistência é fixo em 20 mensagens por segundo, qualquer que seja o nível. --- ## Catálogos de produtos em um número com Coexistência https://easycoexistence.com/pt/docs/catalog-and-coexistence Conectar um número por Coexistência mantém inalteradas, no app do WhatsApp Business, as ferramentas de catálogo, pedidos e status, e a Cloud API não expõe essas ferramentas do app. As mensagens de produto pela API usam um catálogo enviado à Meta e conectado à conta do WhatsApp Business, configurado por número de telefone. ### O catálogo do meu app do WhatsApp Business sobrevive à Coexistência? Sim, no celular. A tabela de recursos da Coexistência da Meta lista as ferramentas comerciais, citando catálogo, pedidos e status como exemplos, sem mudança no funcionamento delas no app do WhatsApp Business após o onboarding. A mesma linha as marca como não compatíveis com a Cloud API. É esse o ponto a considerar no planejamento: uma integração não deve esperar ler, editar ou espelhar a ferramenta de catálogo do app pela API. Portanto, uma loja que vende a partir do catálogo do app continua fazendo exatamente isso depois de conectar. O que muda é que ela também ganha a API, com sua própria forma de enviar produtos. ### Como funciona um catálogo de produtos pela Cloud API? Por meio de um catálogo enviado à Meta e conectado à conta do WhatsApp Business. Um catálogo é um inventário estruturado de produtos ou serviços, e cada item traz detalhes como nome, descrição, preço, imagens e disponibilidade. A Meta descreve quatro etapas. - Envio do inventário, pela Commerce API ou pelo 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. - Compartilhamento de produtos com mensagens de catálogo, de produto único, de vários produtos ou de carrossel. - Respostas dos clientes, que chegam como notificações de webhook com detalhes do pedido e dúvidas sobre produtos. ### O que muda entre as mensagens de produto no app e pela API? A Meta documenta uma diferença visível: as mensagens enviadas pela Cloud API não exibem, por enquanto, o ícone de carrinho de compras no cabeçalho da conversa, ao contrário das mensagens de produto enviadas pelo app do WhatsApp Business. O lado da API também tem configurações que o app não expõe da mesma forma. Por padrão, o carrinho de compras fica ativado e o ícone da vitrine fica oculto em todos os números de telefone comerciais da conta, e ambos podem ser alterados por número com o endpoint de configurações de comércio. Desativar o catálogo faz os links de catálogo wa.me e o botão Ver catálogo exibirem um aviso de catálogo inválido ao serem tocados. Fora da janela de atendimento, os produtos continuam saindo dentro de um template aprovado, como qualquer outra mensagem iniciada pela empresa. ### Quem revisa os produtos? A Meta, de forma automática. Os itens adicionados a um catálogo conectado a uma conta do WhatsApp Business são revisados, e um item que viole as políticas é sinalizado, com a empresa direcionada às Políticas de Comércio do WhatsApp. Itens reprovados podem ser contestados no Meta Commerce Manager. Os clientes também podem denunciar um produto específico recebido em uma mensagem, o que gera uma revisão própria. Denúncias sobre a empresa em si são outro assunto: são um dos sinais que a Meta usa para a classificação de qualidade de um número. Empresas sediadas na Índia têm a obrigação adicional de cumprir as leis de venda online, que a Meta expõe por meio da Business Compliance API. - Esperar que a ferramenta de catálogo do app possa ser lida pela API. A Meta a lista como não compatível com a Cloud API. - Desativar o catálogo de um número enquanto links de catálogo wa.me ainda circulam. Esses links passam a exibir um aviso de catálogo inválido. - Enviar produtos fora da janela de atendimento sem um template. Mensagens iniciadas pela empresa ainda exigem um. **Conectar vai apagar meu catálogo?** Não. A Meta lista as ferramentas comerciais do app, incluindo o catálogo, como inalteradas após o onboarding da Coexistência. **A API consegue ler o catálogo do meu app?** A Meta marca as ferramentas comerciais do app como não compatíveis com a Cloud API. As mensagens de produto pela API usam um catálogo conectado à conta do WhatsApp Business. **Quantos produtos cabem em uma mensagem?** Até 30 em uma mensagem com vários produtos, organizados em seções. **Posso desativar o carrinho?** Sim, por número de telefone, pelo endpoint de configurações de comércio. Ele vem ativado por padrão. --- ## Listas de transmissão vs templates de marketing após a Coexistência https://easycoexistence.com/pt/docs/broadcast-lists-vs-templates Depois que um número é conectado pela Coexistência, as listas de transmissão do app do WhatsApp Business ficam somente 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 no limite de mensagens do portfólio, é cobrado pela Meta e respeita as preferências de marketing de cada pessoa. ### O que substitui uma lista de transmissão na API? Um template de marketing aprovado, enviado uma vez a cada destinatário pela Cloud API. Não existe um objeto de lista no lado da API: a integração guarda a audiência e envia o template para cada número dela. Isso muda três coisas ao mesmo tempo. O conteúdo passa pela revisão de templates da Meta antes de poder ser enviado. Cada envio fora da janela de atendimento abre uma conversa que a Meta cobra no meio de pagamento da própria conta do WhatsApp Business da empresa. E cada destinatário único conta no limite de mensagens do portfólio nas últimas 24 horas. A desativação em si, e os motivos que a Meta dá para ela, estão na página sobre os recursos que a Coexistência desliga. ### Quem pode receber um template de marketing? Pessoas que passaram o número à empresa e aceitaram receber mensagens dela. A Política de Mensagens Comerciais da Meta deixa as duas condições explícitas, e o opt-in precisa citar a empresa e informar que a pessoa concorda em receber as mensagens dela. A Meta deixa o método a critério da empresa, desde que cumpra esses requisitos e a lei aplicável: SMS, formulário em site, ligação de URA ou formulário em papel assinado são exemplos listados. A prova do opt-in fica, portanto, nos registros da própria empresa, e não na lista de contatos de um celular. Enviar para quem nunca deu opt-in também é o jeito mais rápido de acumular bloqueios e denúncias, que são o que reduz a qualidade. ### Por que alguns templates de marketing não chegam? Porque a API aplica controles por destinatário que as listas de transmissão nunca exibiram. - Limites de marketing por usuário: o WhatsApp pode reter templates de marketing para uma pessoa com menor chance de interagir, retornando 131049. - Marketing interrompido: a pessoa pode parar de receber mensagens de marketing da empresa na configuração Ofertas e anúncios, retornando 131050. - Números dos Estados Unidos: atualmente o WhatsApp não entrega templates de marketing a usuários com números de telefone dos EUA. - Regiões excluídas: os limites por usuário não estão ativos atualmente no EEE, no Reino Unido, no Japão nem na Coreia do Sul. ### A ferramenta de mensagens de marketing do app ainda funciona? A tabela de recursos da Coexistência da Meta reúne as ferramentas de mensagens do app em uma só linha, citando mensagens de marketing, mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas, e não registra mudança nelas no app do WhatsApp Business após o onboarding. A mesma linha as marca como não suportadas na Cloud API. Assim, o recurso de mensagens de marketing do app e os templates de marketing da API são duas rotas separadas no mesmo número. A Meta também afirma que as mensagens enviadas pelo app do WhatsApp Business continuam gratuitas após o onboarding, enquanto as enviadas pela Cloud API seguem o preço da Cloud API. As listas de transmissão são a exceção que muda de fato, e por isso precisam de um substituto. - Repetir um 131049 de imediato. A Meta pede pelo menos 24 horas, e repetições antecipadas podem bloquear novas tentativas por até um dia. - Repetir um 131050. A pessoa parou de receber mensagens de marketing da empresa, e a mensagem não será recebida. - Importar uma lista de transmissão como lista de opt-in. Ter salvo o número não é o opt-in descrito pela política. **Minhas listas de transmissão são apagadas?** Não. As listas existentes ficam somente leitura, e não é possível criar novas enquanto o número estiver conectado. **Preciso de um template para falar com a audiência da minha lista de transmissão?** Fora da janela de atendimento, sim. O template de marketing é a rota da API para promoção iniciada pela empresa. **Por que um template falhou com 131050?** Esse destinatário escolheu parar de receber mensagens de marketing da sua empresa. A Meta diz para não repetir. **O recurso de mensagens de marketing do app acabou?** A Meta lista as ferramentas de mensagens do app, incluindo mensagens de marketing, como inalteradas no app após o onboarding. --- ## Requisitos de opt-in do WhatsApp para mensagens iniciadas pela empresa https://easycoexistence.com/pt/docs/opt-in-requirements Antes de uma empresa enviar mensagem a alguém no WhatsApp, a política da Meta exige duas coisas: a pessoa deu seu número de telefone à empresa, e a empresa recebeu um opt-in confirmando que ela quer receber suas mensagens. Desde novembro de 2024, o opt-in pode ser geral, sem ser específico do WhatsApp, mas deve citar a empresa e cumprir a lei local. ### O que a política de opt-in da Meta exige? Duas condições, e ambas precisam ser verdadeiras antes de uma empresa contatar alguém no WhatsApp. A pessoa deu à empresa o número do seu celular, e a empresa recebeu dela um opt-in confirmando que quer receber mensagens ou ligações posteriores da empresa. O opt-in em si tem três requisitos. Deve dizer com clareza que a pessoa está aceitando receber comunicações da empresa. Deve informar com clareza o nome da empresa. E deve cumprir a lei aplicável, o que a Meta deixa inteiramente a cargo da empresa determinar. A atualização de política da Meta de novembro de 2024 flexibilizou um ponto: o opt-in pode ser geral e não precisa mencionar o WhatsApp, desde que a lei local seja seguida. ### Quais métodos de opt-in a Meta aceita? Qualquer método que atenda aos três requisitos. A Meta afirma que esse método está de acordo com a política, deixa a escolha com a empresa e dá exemplos de métodos aceitos. Seja qual for o método, a Meta também recomenda deixar claro o que a pessoa ganha ao receber as mensagens. - SMS. - Um formulário em site. - Por telefone, em um fluxo de resposta de voz interativa. - Pessoalmente ou em papel, com um documento físico assinado. - Seja qual for o método, a empresa é responsável pelos avisos e permissões que a lei aplicável exigir. ### Um contato no app do WhatsApp Business conta como opt-in? Não por si só. A política da Meta vincula a permissão à confirmação da pessoa de que quer receber mensagens da empresa, e um número de telefone na lista de contatos cumpre, no máximo, a primeira das duas condições. Isso importa em um número com Coexistência, porque a conexão pode sincronizar os contatos do app, e a base de clientes existente é o público óbvio de uma primeira campanha de template. Ter o número de alguém não é o mesmo que ter a confirmação dessa pessoa. Um cliente que escreve para a empresa é outro caso: a mensagem dele abre uma janela de atendimento, 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. A orientação de opt-in da Meta observa que as pessoas podem bloquear ou denunciar uma empresa, ou parar de receber suas mensagens de marketing, e que os sistemas da Meta aplicam limite de taxa a uma empresa cuja classificação de qualidade permanece baixa por um período prolongado. O conselho prático da Meta decorre disso. Defina expectativas cobrindo as categorias de mensagem que a empresa vai enviar, ou colete o opt-in por categoria. Dê instruções claras para sair da lista de categorias específicas e respeite-as. Deixe os fluxos de opt-in e de saída da lista evidentes, e acompanhe de perto a classificação de qualidade quando um novo método de opt-in entrar no ar. A política também exige respeitar toda requisição de bloqueio, interrupção ou saída da lista, dentro ou fora do WhatsApp, inclusive removendo essa pessoa das listas de contatos. - Tratar os contatos sincronizados do app como uma lista de opt-in. A política pede a confirmação de cada pessoa, não apenas o número. - Coletar um opt-in que nunca cita a empresa. A Meta exige que o nome da empresa seja informado com clareza. - Respeitar pedidos de saída da lista só quando chegam pelo WhatsApp. A política cobre pedidos feitos por qualquer canal. **O opt-in precisa mencionar o WhatsApp?** Não. Desde a atualização da política de novembro de 2024, um opt-in geral é permitido, desde que cumpra a lei local. **Preciso de opt-in para responder a um cliente que escreveu primeiro?** A mensagem do cliente abre uma janela de atendimento, dentro da qual as respostas são permitidas. O opt-in rege as mensagens que a empresa inicia. **O opt-in pode ser coletado offline?** Sim. A Meta lista pessoalmente ou em papel, com documento assinado, entre os métodos aceitos. **O que deve acontecer quando alguém sai da lista?** Pare de enviar mensagens, qualquer que seja o canal usado no pedido, e remova a pessoa das suas listas de contatos, como a política exige. --- ## Como bloqueios e denúncias afetam a classificação de qualidade do WhatsApp https://easycoexistence.com/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 mais peso para as recentes. Os sinais são bloqueios, denúncias, silenciamentos, arquivamentos e os motivos que as pessoas dão ao bloquear. Qualidade baixa sustentada leva a limite de taxa, ao erro 131048 nos envios e a templates pausados. ### Que feedback reduz a classificação de qualidade do WhatsApp? A Meta cita os sinais diretamente: bloqueios, denúncias, silenciamentos, arquivamentos e os motivos que os usuários dão ao bloquear uma empresa. A qualidade se baseia em como as mensagens foram recebidas nos últimos sete dias e tem peso maior para o mais recente, então um envio ruim de ontem pesa mais do que um de seis dias atrás. Duas consequências decorrem disso. Uma única campanha mal segmentada pode mexer na classificação rapidamente, e a Meta observa que números com muito tráfego costumam ver a qualidade mudar em minutos. E, como a avaliação cobre apenas os últimos sete dias, o feedback mais antigo deixa de contar. Os templates têm a própria classificação, construída a partir de feedback e taxas de leitura, ao lado da classificação do número. ### O que acontece quando a qualidade cai? Várias coisas, em níveis diferentes. - Os envios podem falhar com 131048, que a Meta associa a mensagens demais bloqueadas ou marcadas como spam. - Templates classificados como YELLOW ou RED ainda podem ser enviados, mas correm o risco de ser pausados ou desativados. - A qualidade entra no ritmo de envio dos templates, o que pode deixar a entrega de uma campanha mais lenta. - A política permite que o WhatsApp limite quantas mensagens uma empresa pode enviar com base em bloqueios e denúncias. - Desde 7 de outubro de 2025, uma queda não reduz mais o limite de mensagens do portfólio, mas pode impedir que esse limite aumente. ### Como recuperar uma classificação de qualidade baixa? Primeiro, interrompa a origem do feedback negativo e deixe a janela de sete dias passar por ele. As diretrizes da Meta para mensagens de alta qualidade servem de checklist. Envie apenas para quem aceitou receber mensagens da empresa. Torne as mensagens personalizadas e úteis. Evite mensagens de boas-vindas ou de apresentação abertas demais. Evite enviar mensagens em excesso por dia. Mantenha conteúdo e tamanho enxutos. Na prática, isso significa pausar a campanha ou o template que está gerando bloqueios, verificar para qual segmento de público ele foi enviado e conferir o consentimento que esse público deu. A orientação da própria Meta sugere coletar o consentimento por categoria de mensagem, justamente porque categorias inesperadas são o que as pessoas bloqueiam. ### Onde a classificação de qualidade aparece? No WhatsApp Manager, em Ferramentas da conta e Números de telefone, junto com o status e o limite de mensagens do número, e no objeto do número de telefone pela Graph API como quality_rating. As classificações dos templates ficam em cada template como quality_score, e no painel Gerenciar templates como High, Medium, Low ou Quality pending. Nada disso aparece no app do WhatsApp Business no celular, e é por isso que um número em Coexistência pode piorar sem que ninguém na loja perceba. A classificação não é entregue pelo webhook phone_number_quality_update, apesar do nome do campo, e esse webhook tem uma página própria que explica o que ele de fato traz. - Enviar uma mensagem de boas-vindas aberta demais para uma lista recém-importada. A Meta a cita como algo a evitar, e ela atrai bloqueios. - Repetir envios que falharam com 131048. A restrição é do número, e mais envios somam ao feedback que a causou. - Olhar apenas a classificação do número. Os templates têm a própria, e um template RED pode ser pausado enquanto o número parece estar bem. **Um único bloqueio reduz minha classificação?** A Meta não publica um limiar. A qualidade reflete o feedback geral sobre as mensagens dos últimos sete dias, com mais peso para as recentes. **Uma classificação baixa pode reduzir meu limite de mensagens?** Não desde 7 de outubro de 2025. Ela ainda pode impedir o limite de subir e restringir envios. **Quanto tempo leva a recuperação?** A Meta não publica um prazo de recuperação. A avaliação cobre os últimos sete dias, então o feedback mais antigo não conta mais. **Chats silenciados contam?** Sim. A Meta lista silenciamentos e arquivamentos ao lado de bloqueios e denúncias como sinais de qualidade. --- ## GDPR e Coexistência: para onde vão os dados das mensagens https://easycoexistence.com/pt/docs/gdpr-and-coexistence Quando um número é conectado pela Coexistência, as mensagens dele são espelhadas entre o app do WhatsApp Business e a Cloud API. A Meta afirma que, na Cloud API, atua como operadora de dados em nome da empresa, retém as mensagens por no máximo 30 dias e espera que cada empresa cumpra as próprias obrigações do GDPR. ### O que muda para os dados das mensagens quando um número usa Coexistência? As conversas passam a ficar visíveis para a Cloud API, além do celular. A documentação de Coexistência da Meta afirma que as mensagens enviadas e recebidas são espelhadas entre a Cloud API e o app do WhatsApp Business, que os contatos com número de WhatsApp podem ser sincronizados e que as mensagens dos últimos seis meses podem ser sincronizadas durante a integração. Conversas em grupo não são sincronizadas. A partir daí, as mensagens individuais do número passam pela Cloud API, que a Meta descreve como descriptografando a mensagem recebida e encaminhando-a à empresa, e criptografando as mensagens enviadas com o protocolo Signal antes da entrega. Esta página apresenta o que a Meta documenta e o que a EasyCoexistence faz. Não é aconselhamento jurídico, e cabe à empresa e aos seus assessores decidir se uma configuração atende ao GDPR. ### O que a Meta diz sobre o próprio papel perante o GDPR? A página de privacidade de dados da Cloud API da Meta expõe a posição da empresa com as próprias palavras. - Onde a lei reconhece o operador de dados, a Meta atua como tal em nome da empresa ao fornecer a Cloud API. - A Cloud API usa as mensagens que processa somente em nome da empresa e sob a instrução dela, salvo orientação em contrário. - As mensagens são retidas por no máximo 30 dias; os identificadores de usuário são excluídos em até 30 dias após a última atualização de status de uma mensagem. - Os clientes da Cloud API devem cumprir as próprias obrigações previstas em leis como o GDPR. - Clientes na Região Europeia são cobertos 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 em um país escolhido, após um curto período de uso. Na Cloud API, esse período de uso é de até 60 minutos, e nele o conteúdo pode ser processado em data centers da Meta em outros países. As opções europeias são Alemanha para a UE, Suíça e Reino Unido. O armazenamento local é definido no registro do número, e alterá-lo em um número já registrado exige cancelar o registro e registrar de novo. A documentação de registro da Meta também afirma que o endpoint de cancelamento de registro não pode ser usado em um número em uso simultâneo com a Cloud API e o app do WhatsApp Business, e não descreve um caminho separado para ativar o armazenamento local em um número em Coexistência. ### Para onde vão as mensagens depois da Meta? Para o endpoint que receber os webhooks da conta do WhatsApp Business. O override de webhook da Meta permite que um app envie os webhooks de uma determinada conta para uma URL de callback diferente da URL do próprio app. A EasyCoexistence usa esse override para apontar os eventos de mensagens para o sistema da própria empresa. Assim, a Meta entrega o conteúdo das conversas lá, e não a nós, e a EasyCoexistence nunca armazena o conteúdo das conversas. O que guardamos são os eventos operacionais, como estado da conexão e qualidade, dos quais o monitoramento é feito. A Meta também documenta que possui relatórios SOC 2 Type II e ISO 27001 para a Cloud API, publicados no Business Messaging Compliance Center. - Presumir que o papel de operadora da Meta cobre as obrigações da própria empresa. A Meta afirma que os clientes devem cumprir as próprias obrigações do GDPR. - Aceitar a sincronização do histórico sem decidir onde ele vai parar. Até seis meses de conversas podem ser entregues ao sistema receptor. - Planejar ativar o armazenamento local depois. Ele é definido no registro, e alterá-lo significa registrar de novo. **A Meta é operadora ou controladora na Cloud API?** A Meta afirma que atua como operadora de dados em nome da empresa na Cloud API, onde a lei reconhece esse conceito. **Por quanto tempo a Meta guarda o conteúdo das mensagens?** A Meta declara um período máximo de retenção de 30 dias para as mensagens da Cloud API, para recursos como a retransmissão. **A EasyCoexistence vê as minhas conversas?** Os eventos de mensagens são roteados pela Meta para o seu próprio sistema, e a EasyCoexistence nunca armazena o conteúdo das conversas. **Esta página é aconselhamento jurídico?** Não. Ela apresenta o que a Meta documenta e o que a EasyCoexistence faz. A avaliação de conformidade cabe à empresa e aos seus assessores.