--- title: "WhatsApp Business app ou API: quando migrar" description: "Migrar do app WhatsApp Business para a API pode ser feito de duas maneiras. O que muda em cada uma, quais funções se perdem e como a StudioChat acompanha você." url: https://studiochat.io/pt/blog/whatsapp-business-app-o-api locale: pt translations: { en: https://studiochat.io/blog/whatsapp-business-app-o-api.md, es: https://studiochat.io/es/blog/whatsapp-business-app-o-api.md } site: https://studiochat.io --- [ Voltar ao blog](/pt/blog) O app WhatsApp Business é gratuito e basta para um negócio pequeno que responde à mão. Em algum momento ele deixa de bastar. A API do WhatsApp Business é outra coisa: não é um app, é uma conexão que permite que sistemas e agentes operem sobre o número. Vale entender a diferença antes de decidir, e saber como se faz a migração. ## [Qual é a diferença entre o app e a API do WhatsApp Business?](#qual-e-a-diferenca-entre-o-app-e-a-api-do-whatsapp-business) O app é usado por uma pessoa, a partir de um celular ou de um computador, respondendo mensagens. A API conecta o número a um software (um CRM, uma plataforma de atendimento, um agente de IA) que envia e recebe mensagens por programa. Na API não existe uma tela própria: a interface é a do software que a utiliza. ## [Quando o app é suficiente?](#quando-o-app-e-suficiente) Quando uma ou poucas pessoas atendem, o volume é administrável à mão, não é preciso automatizar respostas e não se precisa de registro em um sistema. Muitos negócios começam assim, e tudo bem. ## [Quando vale migrar para a API?](#quando-vale-migrar-para-a-api) Sinais de que o app ficou pequeno: * **Várias pessoas atendem e uma atrapalha a outra.** Falta um lugar onde se veja quem responde o quê. * **As perguntas se repetem e consomem tempo.** É onde um agente de IA faz sentido. * **É preciso conectar o WhatsApp a outro sistema.** Um CRM, um sistema de pedidos ou uma agenda. * **Você quer medir.** Tempos de resposta, consultas resolvidas, transferências. * **Você quer enviar mensagens proativas com modelos de mensagem aprovados** (confirmações, lembretes). ## [Como se faz para migrar do app para a API?](#como-se-faz-para-migrar-do-app-para-a-api) Existem duas rotas. A escolha depende de você querer ou não continuar usando o número no app. **Rota 1: conectar o número que você já usa, com coexistência.** A Meta permite que um número em uso no app WhatsApp Business seja conectado à API sem deixar de usá-lo no app. Segundo a documentação da Meta, o negócio precisa estar com o app na versão 2.24.17 ou superior. A migração é feita por meio de um provedor autorizado, com o fluxo de cadastro que a Meta chama de Embedded Signup. Os contatos são sincronizados. Essa rota tem limites que convém conhecer antes. Um número usado no app e na API ao mesmo tempo tem uma taxa de transferência fixa de 20 mensagens por segundo, suficiente para a maioria das operações. E algumas funções do app não existem do lado da API: as chamadas de voz e vídeo, as ferramentas de catálogo e pedidos, e os canais. Se você depende de alguma delas, precisa mantê-la pelo app. **Rota 2: abrir um número novo para a API.** Registra-se uma linha nova só para o agente e a API. O número de sempre continua no app como está. Tem uma vantagem: permite separar o atendimento da captação, com duas linhas e duas franquias de mensagens gratuitas. E uma desvantagem: os clientes que já conhecem você precisam ficar sabendo que existe um número novo. ## [O que muda nos custos?](#o-que-muda-nos-custos) A API cobra por mensagem, conforme a tarifa da Meta para cada país, mais o que o provedor cobrar pela plataforma. Desde 1º de outubro de 2026, as mensagens de serviço são cobradas depois das primeiras 1.000 por número e por mês. Vale fazer a conta com o seu volume antes de migrar. ## [Qual conexão escolher?](#qual-conexao-escolher) A conexão oficial com a API. As integrações não oficiais correm o risco de bloqueio do número, e perder o número é perder o canal e o histórico dos clientes que já conhecem você por esse contato. ## [Como a StudioChat ajuda na migração?](#como-a-studiochat-ajuda-na-migracao) Nós cuidamos da parte técnica: conectamos o número pela via oficial, ajudamos você a escolher entre as duas rotas conforme a forma como o seu time atende, e montamos o agente sobre essa linha com acesso aos sistemas que você já usa. Não cobramos as integrações nem a implementação. Recomendamos que a conta do WhatsApp Business fique em nome da sua empresa, assim, se um dia você trocar de provedor, leva o canal com você. Para ver o passo a passo da conexão, confira [o guia para deixar sua conta pronta](/pt/blog/conectar-whatsapp-a-un-agente-de-ia). ## [O que é preciso revisar antes de migrar?](#o-que-e-preciso-revisar-antes-de-migrar) Seis pontos, que se resolvem em uma tarde: 1. **A versão do app.** A coexistência exige o app WhatsApp Business na versão 2.24.17 ou superior. 2. **Quais funções você usa hoje.** Se o catálogo, as chamadas de voz e vídeo ou os canais fazem parte de como você atende, saiba que eles não existem do lado da API e são mantidos pelo app. 3. **Quem tem acesso ao portfólio da Meta.** A conexão é autorizada a partir dele, com permissões de administrador. 4. **Quantas pessoas atendem e de quais dispositivos.** Com a API, o time trabalha na plataforma do provedor e não no telefone de cada um. 5. **Quais modelos de mensagem você vai precisar.** Confirmações, lembretes, acompanhamentos. Solicitá-los com antecedência evita atrasos. 6. **Quais sistemas você quer conectar.** O CRM, o sistema de pedidos ou a agenda. É o que justifica a migração e convém ter isso claro desde o começo. ## [Como é o dia da migração?](#como-e-o-dia-da-migracao) Com coexistência, a parte técnica fica por conta do provedor e dura pouco. Você autoriza a conexão em uma tela da Meta, os contatos são sincronizados e o time começa a ver as conversas na plataforma. Para o cliente nada muda: ele continua escrevendo para o mesmo número. Para o time muda o lugar onde responde, e aí vale dedicar tempo para explicar como se usa a caixa de entrada compartilhada, como as conversas são atribuídas e como se deixa uma nota interna. Com um número novo, o dia da migração é o dia em que a linha é aberta. O que exige planejamento é o aviso: uma mensagem para os clientes que já conhecem você, uma mudança no site e nas redes sociais e um período em que as duas linhas convivem. ## [O que acontece com o histórico e os contatos?](#o-que-acontece-com-o-historico-e-os-contatos) Segundo a documentação da Meta para o onboarding de usuários do app, os contatos com número de WhatsApp podem ser sincronizados. O histórico de conversas e seu detalhe dependem de como a plataforma do provedor o trata, e é uma pergunta para fazer antes de migrar: qual histórico fica visível para o time e a partir de que data. ## [Quanto custa operar a API em comparação com o app?](#quanto-custa-operar-a-api-em-comparacao-com-o-app) O app não tem custo. A API tem dois componentes: o que a Meta cobra por mensagem, conforme a categoria e o país do cliente, e o que o provedor cobra pela plataforma. No StudioChat Ops, o plano de entrada custa USD 49 por mês e inclui uma linha de WhatsApp sobre a conexão oficial, usuários e contatos sem limite, um agente de IA conectado ao modelo que você escolher, 200 conversas ativas com IA por mês e campanhas de envio em massa com modelos de mensagem aprovados. As mensagens da Meta são cobradas à parte, e o método de pagamento da Meta fica por nossa conta, com o excedente visível no painel e um limite de gasto configurável. Se você precisa integrar seus sistemas ou montar um agente sob medida, existe um plano gerenciado, cotado conforme a operação, depois de uma análise sem custo. Antes de decidir, convém fazer uma conta simples: quantas mensagens ativas você envia por mês, quantas são de serviço, quantas são modelos de mensagem, e comparar com as 1.000 gratuitas por número. ## [Quais três tipos de negócio costumam escolher cada rota?](#quais-tres-tipos-de-negocio-costumam-escolher-cada-rota) Três exemplos hipotéticos: * **Uma loja com uma pessoa que atende pelo celular.** Fica no app. Não tem consultas repetidas nem sistemas para conectar, e a API só acrescentaria complexidade. * **Um comércio com quatro vendedores que usam o mesmo número em seus telefones.** Coexistência. Precisa que o time trabalhe em um só lugar, com histórico e atribuição, e não quer deixar de usar o número que os clientes conhecem. * **Uma empresa com um processo de qualificação de leads vindos de anúncios.** Número novo para o agente. Quer separar a captação do atendimento a clientes, medir cada parte separadamente e usar a janela gratuita dos anúncios sem misturar custos. ## [Que erros aparecem ao migrar?](#que-erros-aparecem-ao-migrar) * **Não avisar o time.** Se os vendedores continuam respondendo pelo app de seus telefones sem saber que agora existe uma plataforma, há respostas duplicadas e conversas sem dono. * **Misturar prospects e clientes em uma única linha sem regras.** Torna impossível separar custos e complica o atendimento. * **Não ter modelos de mensagem aprovados no dia em que são necessários.** O primeiro acompanhamento fora da janela de 24 horas fica travado por isso. * **Esperar ter o agente perfeito para começar.** A migração vem primeiro, o agente é ajustado depois com conversas reais. ## [Quanto tempo leva a migração?](#quanto-tempo-leva-a-migracao) Depende da rota. Com um número novo, a linha pode estar operacional em poucas horas, e o que leva tempo é a parte humana: avisar os clientes e organizar o time. Com coexistência, a conexão técnica é rápida, mas convém reservar alguns dias para testar se o que o time fazia pelo app (responder, transferir, deixar notas) funciona igual pela plataforma. As integrações com outros sistemas são outra etapa e dependem de quais forem: entre uma e quatro semanas, na nossa experiência com o StudioChat Ops, conforme o que precise ser conectado. ## [Como decidir?](#como-decidir) Com três perguntas: quantas pessoas atendem, que parte das consultas se repete e se você precisa conectar o canal a outros sistemas. A ferramenta abaixo organiza as respostas e diz se o app basta ou se já é hora da API. Ferramenta do post ### App ou API? Quatro perguntas sobre a sua operação. Quantas pessoas respondem no seu time?Uma ou duasTrês ou mais Quantas das consultas se repetem?PoucasMuitas Você precisa conectar o WhatsApp a outro sistema (CRM, pedidos, agenda)?NãoSim Você quer medir tempos de resposta e de resolução?Não por enquantoSim Responda as 4 perguntas para ver o resultado (0 de 4). Este objeto também tem [página própria](/app-ou-api-do-whatsapp), caso queira mandar só ela. Perguntas frequentes ### A API do WhatsApp Business é um app separado? Não. É uma conexão que permite que um software, como uma plataforma de atendimento ou um agente de IA, envie e receba mensagens pelo número. ### Posso continuar usando meu número no app se conectá-lo à API? Pode, com coexistência: a Meta permite que um número em uso no app seja conectado à API sem deixar de ser usado nele, com algumas funções do app que não existem do lado da API. ### A API custa mais que o app? O app é gratuito. A API cobra por mensagem conforme a tarifa da Meta, mais o que o provedor da plataforma cobrar. Compartilhar [ X](https://x.com/intent/post?text=WhatsApp%20Business%20app%20ou%20API%3A%20quando%20vale%20migrar%20para%20a%20API%20e%20como%20se%20faz&url=https%3A%2F%2Fstudiochat.io%2Fpt%2Fblog%2Fwhatsapp-business-app-o-api) [ LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fstudiochat.io%2Fpt%2Fblog%2Fwhatsapp-business-app-o-api) [ WhatsApp](https://wa.me/?text=WhatsApp%20Business%20app%20ou%20API%3A%20quando%20vale%20migrar%20para%20a%20API%20e%20como%20se%20faz%20https%3A%2F%2Fstudiochat.io%2Fpt%2Fblog%2Fwhatsapp-business-app-o-api)Copiar link Ignacio Puig Moreno Ignacio Puig Moreno · Co-fundador · Negócios, StudioChat Quer ver agentes assim trabalhando para a sua equipe? [Fale conosco agora](https://cal.com/studiochat)