"Integração com WhatsApp: 40 horas." É a linha mais otimista de qualquer orçamento de software house — e a que mais estoura.

Não porque quem estimou é ruim. Porque as 40 horas cobrem o caminho feliz, e o caminho feliz é a menor parte do trabalho.

O que a estimativa de 40 horas cobre

Autenticar, montar o POST, enviar texto, receber no webhook, salvar no banco. Isso é real, e é mesmo perto de 40 horas.

O que ela não cobre

A burocracia da Meta (imprevisível). Criar o app, configurar produto e permissão, passar pela verificação de negócio — no CNPJ do cliente. Você depende de documento de terceiro, de revisão que pode ser manual e de um prazo que não é seu. Ninguém consegue estimar isso porque não depende de ninguém do time.

Mídia (16–24h). Imagem, PDF, áudio e vídeo têm limite de tamanho, formatos aceitos e regras de URL. Cada tipo tem seu detalhe, e o áudio costuma dar o dobro de trabalho do resto junto.

Erro (24–40h). Número sem WhatsApp, fora da janela de 24 horas, template não aprovado, limite atingido, instância desconectada. Cada um pede tratamento diferente, e é a diferença entre um módulo que funciona e um que funciona quando dá.

Webhook de verdade (16–24h). Reentrega, evento fora de ordem, mensagem processada duas vezes, assinatura, responder rápido. Coisas que só aparecem com volume, e que estão em webhook em produção.

A janela de 24 horas (8–16h). Descobrir que fora dela só sai template aprovado e refazer o fluxo de notificação por causa disso é um clássico. Quase sempre acontece depois de o módulo estar "pronto".

Homologação (16h). Um número de teste que não seja o do cliente, um ambiente separado, uma forma de testar sem mandar mensagem para gente de verdade.

O suporte depois (para sempre). Este não entra em nenhum orçamento, e é o que mais custa: a Meta muda algo, o número do cliente cai, alguém pergunta por que a mensagem não chegou.

Somando: 120 a 160 horas de trabalho, mais uma espera que não depende de você. Daí os 200.

E se forem três canais?

Se o cliente também quer Instagram e Messenger, a conta não dobra — ela quase triplica. Três apps, três formatos de payload, três parsers, três tratamentos de erro.

A não ser que os três cheguem no mesmo envelope, o que reduz a diferença a um campo no JSON.

A conta com API gerenciada

O que desaparece:

O que sobra, que é o seu trabalho de verdade:

O envio funciona no mesmo dia — o primeiro envio nos três canais leva minutos com o SDK PHP ou o SDK JavaScript. Um módulo completo leva de uma a duas semanas.

E some a espera imprevisível, que é o que de fato quebra prazo combinado com cliente.

O segundo projeto

Aqui está o ponto que muda o negócio, e quase ninguém coloca na conta.

Construindo do zero: o segundo cliente repete quase tudo. App novo, verificação nova, espera nova. O código você reaproveita; a burocracia, não.

Com API gerenciada: o segundo cliente é uma chamada de API para criar a instância. O módulo já existe. Provisionar por API faz o décimo cliente custar o mesmo que o segundo.

É a diferença entre um custo que se repete por cliente e um custo que você paga uma vez.

Quando construir do zero ainda faz sentido

Três casos, e eles existem:

A integração é o seu produto. Se você vende a plataforma de mensageria, ela é o núcleo do negócio. Faz sentido dominá-la inteira.

Escala muito grande com equipe dedicada. Em volume alto o suficiente, a diferença de custo por mensagem justifica gente cuidando disso em tempo integral.

Restrição de conformidade que exige infraestrutura própria. Alguns contratos exigem que o dado não passe por terceiros. Aí não há escolha.

Fora desses três, a conta raramente fecha — e o custo que mata não é o de construir, é o de manter, para sempre, uma coisa que não é o seu produto.

Como orçar isso para o cliente

Duas linhas, separadas:

Implantação. As 44 a 80 horas, ao seu valor-hora. É trabalho real e você cobra por ele.

Mensalidade. A operação: instância, suporte, monitoramento, acompanhar mudança da Meta. Este é o item que quase todo mundo esquece de colocar, e é o que paga o suporte que vai existir de qualquer forma. Como estruturar está em quanto cobrar pelo módulo.

Orçar só a implantação é assinar suporte vitalício de graça.

Conclusão

A estimativa honesta de uma integração de WhatsApp num sistema é de uma a duas semanas, usando API gerenciada, mais o tempo de encaixar no seu produto.

Construir do zero é de três a cinco vezes isso, com uma espera que você não controla no meio — e a conta se repete a cada cliente novo.

Se WhatsApp não é o seu produto, mas é o que o seu cliente pede em toda proposta, a página para software house tem o desenho completo, inclusive a parte comercial.

Perguntas frequentes

Quanto tempo leva para integrar WhatsApp num sistema?+

Usando uma API gerenciada, o envio funciona no mesmo dia e um módulo completo com recebimento, histórico e tratamento de erro leva de uma a duas semanas. Construindo a integração oficial do zero, o prazo é dominado pela aprovação da Meta, que não depende de você e costuma levar semanas.

Por que a estimativa de 40 horas vira 200?+

Porque as 40 horas cobrem o caminho feliz — enviar e receber texto. O que estoura o prazo são as etapas invisíveis: burocracia da Meta, mídia, tratamento de erro, reentrega de webhook, ambiente de homologação e o suporte depois da entrega, que não estava no orçamento.

Vale a pena construir a integração direto na Cloud API da Meta?+

Só se a integração for o seu produto. Se ela é uma funcionalidade dentro de um sistema que você vende, o esforço de manter app aprovado, token, verificação de negócio e três formatos de webhook não retorna. A conta muda se você tiver escala muito grande e equipe dedicada.

Quanto tempo leva a verificação de negócio da Meta?+

É a etapa mais imprevisível de todas: pode sair em dias ou levar semanas, dependendo da documentação e de eventual revisão manual. E ela acontece no CNPJ do cliente, não no seu — o que significa depender de documento de terceiro para cumprir o seu prazo.

O que muda usando uma API gerenciada?+

Somem as etapas que você não controla. Não há app para criar, verificação de negócio, Tech Provider nem token para renovar, e os três canais chegam num único formato de webhook. Sobra o que é de fato o seu trabalho: onde a mensagem entra no seu sistema e o que ela dispara.

Continue lendo

Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp

Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.

Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.

Erros da API do WhatsApp: o que cada um significa e como tratar

A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.