Logo da Verso Software House verso. Orçamento grátis
Início › Integração WhatsApp API
Integração WhatsApp API

Integração WhatsApp API no seu sistema: enviar, receber e automatizar

Seu sistema já roda, só falta ele conversar no WhatsApp sozinho. A gente pluga a API oficial da Meta (ou uma não-oficial) no seu CRM, ERP ou loja pra mandar, receber e automatizar mensagem sem ninguém copiar e colar o dia inteiro.

Você já tem o sistema rodando: o CRM, o ERP, a loja virtual, o painel interno. Agora falta a parte que o seu cliente mais usa no dia a dia, o WhatsApp. Você quer que o próprio sistema envie a confirmação do pedido sozinho, receba a resposta do cliente e dispare o próximo passo sem ninguém ficar copiando e colando mensagem o dia inteiro. Isso é integração WhatsApp API, e é exatamente o tipo de coisa que a gente faz.

A parte fácil é mandar uma mensagem. O difícil é tudo em volta: escolher entre a Cloud API oficial da Meta e uma API não-oficial, aprovar template na categoria certa, respeitar a janela de 24 horas, tratar o webhook de status quando a mensagem é entregue ou lida, e principalmente não tomar bloqueio quando o volume sobe. A gente já pisou nesse campo minado dezenas de vezes e sabe onde estão as minas. Você fala direto com quem programa, sem gerente de conta no meio, e o orçamento fecha em até 24h no WhatsApp.

A dor de quem tenta plugar o WhatsApp no sistema sozinho

Quem já tentou integrar o WhatsApp na mão conhece a novela. Primeiro vem a papelada: criar a WhatsApp Business Account no Business Manager, verificar o número, subir o Facebook Business, esperar aprovação. Depois vem a documentação da Cloud API, que muda de tempos em tempos e não explica o que fazer quando dá errado de verdade.

Aí começam os problemas de produção. O template foi reprovado e ninguém sabe por quê. A mensagem sai como "enviada" mas nunca chega, e o webhook de status não estava configurado pra você descobrir. O número entrou em tier de qualidade vermelho e o limite de disparo caiu do nada. No número não-oficial, a sessão caiu e parou tudo até alguém escanear o QR de novo. E o clássico: soltou 300 mensagens de uma vez pra base fria e o número tomou soft-ban em duas horas.

Esses não são bugs do seu código. São regras da plataforma que só se aprende apanhando. A gente já apanhou por você. Se você está travado em qualquer um desses pontos agora, chama a gente no WhatsApp que a gente diz na hora se dá pra resolver.

Como a gente faz a integração WhatsApp API

API oficial da Meta ou não-oficial: a gente escolhe com você

Não existe resposta única, existe a resposta certa pro seu caso. A Cloud API oficial da Meta é o caminho quando você precisa de estabilidade, número verificado com selo, e não quer risco de ban por infringir os termos. É o padrão pra notificação transacional (pedido, boleto, agendamento) e pra escala grande com previsibilidade. O custo é por conversa iniciada, dividido em categorias (utility, marketing, authentication, service).

A API não-oficial (feita em cima de bibliotecas como Baileys, ou de provedores tipo Evolution e uazapi) resolve quando você quer subir rápido, rodar multi-instância e não pagar por conversa. Ela pede mais cuidado com aquecimento de número e anti-bloqueio, e a gente sabe montar essa camada de proteção porque é o coração de um dos nossos produtos. Na primeira conversa a gente já te fala qual dos dois faz sentido pro seu volume e pro seu tipo de mensagem.

Envio, recebimento e webhooks de status

Integração de verdade é mão dupla. No envio, o seu sistema dispara texto, mídia (imagem, PDF, áudio), botões de resposta rápida, listas e templates aprovados, tudo por uma chamada de API que a gente expõe do seu jeito. No recebimento, a gente monta o webhook que captura a mensagem que o cliente respondeu e joga dentro do seu fluxo (abre chamado, atualiza o lead, aciona o robô, o que você precisar).

E tem a camada que quase todo mundo esquece: o webhook de status. É ele que te diz se a mensagem foi entregue, lida ou falhou, com o id certo da mensagem pra casar no seu banco. Sem isso você fica no escuro achando que mandou e o cliente nunca recebeu. A gente trata os quatro estados e ainda deixa um relatório de entrega e leitura pra você enxergar o que está acontecendo.

Templates, janela de 24h e opt-in sem tomar bloqueio

Na API oficial, você só pode iniciar conversa com o cliente usando um template aprovado pela Meta. Se o cliente respondeu nas últimas 24 horas, abre a janela de conversa livre e aí você manda o que quiser. A gente estrutura seus templates na categoria correta (utility barato pra transacional, marketing pra promoção), cuida do opt-in pra ficar dentro da LGPD, e organiza o disparo pra não queimar a reputação do número. Menos bloqueio, mais mensagem chegando.

4 casos de uso reais do dia a dia

  • Notificação transacional automática. Pedido pago, o cliente recebe a confirmação na hora. Nota emitida, chega o link. Pedido despachado, sai o código de rastreio. Boleto vencendo, o lembrete dispara sozinho. Tudo puxado direto do evento no seu sistema, sem ninguém apertar botão.
  • Atendimento e agente de IA que responde 24h. O cliente manda mensagem, o robô entende, responde dúvida, mostra produto e passa pro humano só quando precisa. A gente construiu no Forja um agente de IA que vende no WhatsApp 24 horas por dia, com checkout, cálculo de frete em 4 transportadoras e split de pagamento, tudo dentro da conversa.
  • Disparo em massa com anti-bloqueio. Campanha, aviso, recompra pra base inteira sem o número cair. É o que o nosso ZapFlow faz: disparo multi-instância com camada anti-bloqueio, dedup por telefone e relatório de entrega e leitura. A gente pluga essa lógica no seu sistema em vez de você reinventar do zero.
  • Cobrança e recuperação na entrega. Carrinho abandonado volta com um toque, cobrança sai pelo WhatsApp com o Pix já embutido, confirmação de entrega fecha o ciclo. No LogMoney a gente rodou pagamento na entrega em escala de verdade: mais de 119 mil pedidos e R$ 16 milhões processados, com o WhatsApp no meio do fluxo.

Com o que a gente integra

A gente conecta o WhatsApp no que você já tem, não pede pra você trocar de sistema. Integramos com CRM, ERP, plataforma de e-commerce, painel interno feito em casa e ferramentas de mercado via API ou webhook. Do lado da mensageria, trabalhamos com a Cloud API oficial da Meta e com provedores não-oficiais (Evolution, uazapi, Baileys). Do lado do código, a stack é PHP e Laravel, Node, Python, MySQL, com OpenAI pra parte de IA, Pagar.me e Pix pra pagamento, tudo rodando em Docker e AWS quando o projeto pede.

Se o seu sistema já tem uma API, a gente consome. Se não tem, a gente cria o endpoint e a fila de envio pra aguentar volume sem travar. Você não precisa entender de webhook nem de template, isso é problema nosso.

Por que fechar a integração com a Verso

Porque a gente não vende teoria de WhatsApp, a gente roda WhatsApp em produção todo dia. O ZapFlow, o Forja e o LogMoney são sistemas nossos que mandam e recebem mensagem de verdade, em volume, com cliente real do outro lado. Quando você contrata a Verso, você compra essa estrada já asfaltada em vez de abrir picada sozinho.

E a gente é software house de Porto Alegre que atende o Brasil inteiro, com mais de 150 projetos rodados. Você conversa direto com quem escreve o código, o orçamento fecha em até 24h, e hospedagem, domínio e SSL ficam por nossa conta. Sem fila de chamado, sem enrolação, sem projeto que some no meio do caminho.

Se você quer o seu sistema mandando, recebendo e automatizando mensagem no WhatsApp sem dor de cabeça de bloqueio e template reprovado, bora conversar. Chama a gente no WhatsApp e conta o que você já tem rodando que a gente te diz o caminho mais curto pra integrar.

Perguntas frequentes

Qual a diferença entre a API oficial da Meta e uma API não-oficial do WhatsApp?

A Cloud API oficial da Meta dá número verificado, estabilidade e zero risco de ban por termos de uso, mas cobra por conversa iniciada e exige template aprovado pra começar o papo. A não-oficial (Baileys, Evolution, uazapi) sobe mais rápido, roda multi-instância e não cobra por conversa, em troca de mais cuidado com aquecimento e anti-bloqueio. Na primeira conversa a gente te fala qual encaixa no seu volume.

Dá pra usar o meu número atual do WhatsApp?

Depende do caminho. Na API oficial, o número precisa migrar pra WhatsApp Business Account e passa a viver dentro da API (você perde o app comum naquele número). Na não-oficial, dá pra conectar um número via QR, mas o ideal é usar um número dedicado e aquecido pra não misturar com o seu pessoal. A gente orienta a melhor escolha no seu caso.

Quanto tempo leva pra integrar o WhatsApp no meu sistema?

Uma notificação transacional simples (pedido pago, rastreio) sai em poucos dias depois de a conta estar aprovada. Fluxos maiores com recebimento, webhook de status e automação levam mais, mas a gente fecha o escopo e o prazo com você em até 24h no WhatsApp antes de começar, sem surpresa no meio.

O WhatsApp pode bloquear o meu número no disparo?

Pode, e é o erro mais comum de quem faz sozinho: soltar muita mensagem de uma vez pra base fria toma soft-ban rápido. A gente monta a camada de anti-bloqueio (aquecimento, ritmo de envio, dedup por telefone, opt-in), a mesma lógica que roda no nosso ZapFlow em volume real. Reduz muito o risco, mas nenhuma solução honesta promete risco zero.

Preciso pagar alguma coisa pra Meta pra usar a API?

Na API oficial, sim: a Meta cobra por conversa iniciada, com preço que varia por categoria (utility, marketing, authentication, service) e alguns tipos de service saem de graça. Na não-oficial não tem essa cobrança por conversa. A gente te mostra a conta dos dois caminhos pra você decidir com número na mão, não no achismo.

Vocês integram com o CRM ou ERP que eu já uso?

Sim. Se o seu CRM, ERP ou loja já tem API ou webhook, a gente consome e conecta o WhatsApp em cima. Se não tem, a gente cria o endpoint e a fila de envio pra aguentar volume. A ideia é plugar no que você já tem, não te obrigar a trocar de sistema.

Bora plugar o WhatsApp no seu sistema?

Conta pra gente qual sistema você já tem rodando e o que precisa que ele faça no WhatsApp. A gente te diz na hora se usa a API oficial ou não-oficial e fecha o orçamento em até 24h. Chama no WhatsApp.

Pedir orçamento no WhatsApp
Falar no WhatsApp