Guias

Integrações via API no WhatsApp


Resposta rápida (TL;DR)

Integrar o WhatsApp via API significa ligar o número oficial da empresa aos sistemas que já rodam: CRM, ERP, e-commerce, agenda, financeiro e base de conhecimento. Existem três caminhos. A integração nativa da própria plataforma de atendimento é a mais barata e a mais limitada. O conector (plataforma de automação entre sistemas) resolve casos intermediários com custo mensal e manutenção leve. O desenvolvimento próprio faz qualquer coisa, custa projeto mais sustentação e exige equipe. Antes de escolher, defina três pontos: quem é dono do histórico de conversa, o que acontece se você trocar de fornecedor e quem responde quando a integração cai.


O que dá para integrar

A pergunta útil não é o que a API permite, é qual trabalho manual some quando a ligação existe. Toda integração que se paga elimina uma digitação repetida ou uma consulta feita em outra tela no meio do atendimento.

SistemaO que a integração resolveDado que atravessa
CRM de vendasLead cai no funil já com origem e histórico, sem cadastro manualContato, etapa, origem, resumo da conversa
ERP ou financeiroConsulta de pedido, nota, boleto e segunda via dentro da conversaDocumento do cliente, número do pedido, status
E-commerceAviso de pedido, rastreio e recuperação de carrinhoPedido, produto, código de rastreio
Agenda e sistema de gestãoMarcação, confirmação e remarcação sem telefonemaHorário disponível, profissional, unidade

O limite prático não é a API do WhatsApp, é o outro lado: sistema antigo sem API aberta decide o projeto antes de qualquer discussão sobre WhatsApp. Vale checar isso primeiro, como detalha o guia de como integrar o WhatsApp ao ERP.

Os três caminhos possíveis

Toda integração cai em um destes três modelos, ou numa combinação. A escolha erra quando se compara só o preço de entrada.

CaminhoServe quandoCusto típicoManutenção
Integração nativaO sistema de destino está na lista pronta do fornecedorIncluída na mensalidade da plataformaDo fornecedor, você não mexe
ConectorPrecisa ligar sistemas que não se conhecem, com regra simplesMensalidade por volume de execuçõesSua, leve, mas alguém precisa saber onde mexer
Desenvolvimento próprioRegra de negócio específica ou sistema internoProjeto mais sustentação mensalSua, integral, inclusive plantão

Caminho 1: integração nativa

É a ligação que a própria plataforma de atendimento já traz pronta para sistemas conhecidos. Liga em minutos, com login e autorização, e não exige ninguém de tecnologia. A vantagem real vai além do preço: quando o fornecedor do outro lado muda alguma coisa, quem conserta é a plataforma, não você.

A limitação é o que ela não faz. Integração nativa costuma cobrir os campos padrão (contato, empresa, negócio, etapa) e parar aí. Campo personalizado, regra condicional e sentido inverso (o sistema disparando mensagem a partir de um evento interno) já ficam de fora em boa parte dos casos. O exemplo mais comum no Brasil está no guia de como integrar o WhatsApp ao HubSpot.

Caminho 2: conector

Conector é a plataforma que fica no meio, escuta um evento de um lado e executa uma ação do outro, com regras montadas em tela, sem código. Resolve muito bem o que é linear: chegou mensagem, cria registro; mudou etapa, dispara modelo; fechou pedido, manda aviso.

Duas advertências. A cobrança quase sempre é por execução, então volume alto de conversas transforma custo pequeno em custo relevante sem aviso. E o conector vira o sistema que ninguém documenta: quando quem montou sai da empresa, sobra uma teia de automações que ninguém entende. Documentar cada regra em uma linha, com dono, é o antídoto barato.

Caminho 3: desenvolvimento próprio

Aqui a empresa fala direto com a API oficial, ou com a API da plataforma de atendimento, e escreve a lógica que quiser. É o único caminho quando a regra é específica, o sistema é interno ou o volume torna o custo por execução do conector inviável.

O custo que costuma ser esquecido não é o de construir, é o de manter: acompanhar mudança de versão da API, tratar reenvio de evento, manter fila, monitorar e ter alguém disponível quando cai de madrugada. Boa parte disso mora no mecanismo de recebimento de eventos, explicado no guia sobre como funciona o webhook no WhatsApp.

Custo e manutenção, com os números do mercado

Nas faixas praticadas no Brasil, uma plataforma de chatbot no-code fica entre R$ 100 e R$ 300 por mês, um CRM de vendas com caixa unificada entre R$ 66 e R$ 300 por usuário ao mês, um helpdesk omnichannel entre R$ 210 e R$ 550 por agente ao mês e uma plataforma enterprise parte de R$ 1.000 a R$ 5.000 por mês. Sobre esses valores incidem as conversas cobradas pela Meta, que variam por categoria de modelo.

Para desenvolvimento próprio não existe faixa de mercado confiável, porque o preço acompanha o escopo. O que dá para afirmar é a estrutura: um valor de projeto, um valor mensal de sustentação e um custo de indisponibilidade que ninguém coloca na planilha. Ao comparar propostas, some sempre três anos, não um mês. A comparação de mensalidades está detalhada em quanto custa um CRM para WhatsApp.

Limite de requisições e limite de mensagens

São dois limites diferentes, e confundi-los gera projeto dimensionado errado.

Limite de mensagens. Vale por destinatários únicos em 24 horas e é o que trava campanha. Um portfólio novo começa em 250 destinatários únicos por 24 horas e sobe para 2.000, 10.000, 100.000 e ilimitado conforme o histórico de qualidade. O detalhe que pega quem tem vários números: o limite é calculado no nível do portfólio de negócios e compartilhado entre todos os números dele. Abrir um segundo número não dobra a capacidade.

Limite de requisições. Vale por chamadas à API em um intervalo curto e é o que trava integração mal feita. Sistema que consulta a API a cada poucos segundos para saber se chegou mensagem, em vez de esperar o aviso do webhook, esbarra nesse teto sem nunca ter enviado uma campanha. Os patamares e as regras de subida estão em limites da API oficial do WhatsApp.

Quem é dono do dado

Esta é a pergunta que menos aparece na negociação e a que mais custa depois. Cinco pontos precisam estar escritos em contrato, não combinados por telefone.

  1. Propriedade do histórico de conversa. As conversas são da empresa, não do fornecedor. Deixe explícito que o dado é seu e que o fornecedor é operador dele.
  2. Direito e formato de exportação. Exportar não é favor. Peça o formato (planilha, arquivo estruturado ou acesso por API), o prazo de entrega e se contatos, mensagens e anexos vêm juntos.
  3. Titularidade do número e da conta de negócios. O número precisa estar na conta da sua empresa, com você como administrador. Número registrado no portfólio do fornecedor é o que trava migração.
  4. Retenção e exclusão. Por quanto tempo o histórico fica disponível, o que acontece após o cancelamento e como se pede exclusão, ponto que a LGPD cobra do controlador, que é você.
  5. Subcontratados. Quem mais toca o dado: provedor de nuvem, fornecedor de IA, serviço de transcrição. A lista precisa existir.

Na troca de fornecedor a conta chega toda junta: sem exportação, sem histórico e com o número preso, a migração vira recomeço.

A ordem de implantação que evita retrabalho

Comece pelo caminho da mensagem recebida: contato entra, vira registro, aparece para o time. Só depois ligue o sentido inverso, em que o sistema dispara mensagem a partir de um evento interno, porque é aí que aparecem os erros visíveis para o cliente. Consulta de dado sensível fica para o fim, quando já existe controle de acesso.

Erros comuns em integração de WhatsApp

  • Escolher pelo preço de entrada. Conector barato com cobrança por execução costuma custar mais que desenvolvimento em dois anos de volume alto.
  • Registrar o número no portfólio do fornecedor. É o erro mais caro de desfazer e o mais fácil de evitar na largada.
  • Sincronizar tudo. Passar todos os campos entre sistemas cria conflito de versão e dado divergente. Escolha o sistema que manda em cada campo.
  • Consultar em vez de escutar. Integração que pergunta à API se chegou mensagem gasta requisição e atrasa a resposta.
  • Não prever o modo manual. Quando a integração cai, alguém precisa conseguir atender e registrar do jeito antigo, sem parar a operação.
  • Ignorar quem mantém. Toda integração precisa de um dono nomeado. Sem isso, ela funciona até a primeira mudança de versão do outro lado.

Perguntas frequentes (FAQ)

O que dá para integrar com o WhatsApp via API?

CRM de vendas, ERP e financeiro, e-commerce, sistema de agenda e base de conhecimento são os casos mais comuns. Na prática, integra-se o que elimina digitação repetida ou consulta em outra tela durante o atendimento: lead que entra no funil sozinho, consulta de pedido dentro da conversa, aviso de rastreio e confirmação de horário. O limite costuma ser a API do outro sistema, não a do WhatsApp.

Qual a diferença entre integração nativa, conector e desenvolvimento próprio?

A nativa já vem pronta na plataforma de atendimento, liga em minutos e é mantida pelo fornecedor, mas cobre só campos padrão. O conector fica entre dois sistemas e monta regras em tela, sem código, cobrando por execução. O desenvolvimento próprio fala direto com a API e faz qualquer coisa, ao custo de projeto, sustentação mensal e equipe disponível quando algo quebra.

Quanto custa integrar o WhatsApp com o CRM da empresa?

No mercado brasileiro, plataformas de chatbot no-code ficam entre R$ 100 e R$ 300 por mês, CRMs de vendas com caixa unificada entre R$ 66 e R$ 300 por usuário ao mês e helpdesks omnichannel entre R$ 210 e R$ 550 por agente ao mês. Some as conversas cobradas pela Meta. Desenvolvimento próprio não tem faixa de mercado: tem valor de projeto mais sustentação mensal.

Existe limite de requisições na API do WhatsApp?

Sim, e são dois limites diferentes. Um é o de destinatários únicos em 24 horas, que começa em 250 para um portfólio novo e sobe para 2.000, 10.000, 100.000 e ilimitado, calculado no nível do portfólio de negócios e compartilhado entre todos os números dele. O outro é o de chamadas à API em intervalo curto, que penaliza integração que fica consultando em vez de escutar o webhook.

De quem é o histórico das conversas de WhatsApp da empresa?

Da empresa, desde que isso esteja escrito no contrato. Garanta quatro pontos: propriedade do histórico, direito de exportação com formato e prazo definidos, número registrado na conta de negócios da própria empresa e regra clara de retenção e exclusão. Número registrado no portfólio do fornecedor é o principal motivo de migração travada quando se decide trocar de plataforma.


Continue lendo


Histórico de revisões

  • 2026-07-27 · v1.0 · publicação inicial.

Sobre as marcas mencionadas

Este portal cita marcas de terceiros para fins editoriais e comparativos. Todas as marcas são propriedade de seus respectivos donos e não possuem vínculo formal com este site. Os dados apresentados foram coletados de fontes públicas e podem mudar. Em caso de erro factual, escreva para contato@botaihub.com.br.