Wafly › Blog › Tempo para integrar

Quanto tempo leva para integrar uma API de WhatsApp? O que 104 cadastros mostram

Atualizado em 5 de setembro de 2026 · baseado em dados da nossa própria operação e em fontes primárias citadas ao longo do texto

Quem está avaliando uma API de WhatsApp costuma perguntar quanto tempo vai levar para integrar. A resposta honesta, com dado, é: muito menos do que você imagina, e o risco está em outro lugar. Este texto mostra o que medimos na nossa própria base, sem enfeite, com o método e os limites da medição.

O que medimos e como

Contamos todos os cadastros feitos na Wafly entre 16 de julho e 5 de setembro de 2026, quando passamos a registrar a origem de cada cadastro. São 104 cadastros entre 16 de julho e 5 de setembro de 2026. Para cada um, olhamos quatro coisas:

1. Se a pessoa criou pelo menos uma instância (o "número" que vai conectar ao WhatsApp).
2. Se essa instância conectou de fato, isto é, leu o QR Code ou usou o código de pareamento e apareceu como conectada.
3. Se a instância registrou pelo menos uma mensagem enviada ou recebida pela API.
4. Quantos dias se passaram entre o cadastro e essa primeira mensagem.

Dois limites importam. O registro de mensagens tem granularidade de dia, então "no mesmo dia" significa que a data da primeira mensagem é a data do cadastro, não que passaram poucos minutos. E não existe um carimbo de hora da conexão: consideramos conectada a instância que aparece como conectada no painel, tem telefone pareado ou registrou mensagem. Os números abaixo vêm direto do banco de produção, verificados em 05/09/2026.

O resultado, etapa por etapa

Leia a tabela de baixo para cima. Quem conecta o número, integra: 93% de quem conectou já registrou mensagem pela API. A integração em si, o código que chama o endpoint ou o fluxo no n8n, quase nunca é o problema.

Onde a base afina é antes disso: 30 dos 104 cadastros nunca criaram uma instância, e 26 das 70 instâncias criadas (37%) nunca leram o QR Code. A conexão do número, um passo que parece trivial, é o maior ponto de perda do processo inteiro.

Quanto tempo leva de verdade

Entre os 41 que enviaram ou receberam a primeira mensagem:

• 39 de 41 (95%) fizeram isso no mesmo dia do cadastro.
• os 2 restantes enviaram no dia seguinte, ou seja, 100% em até um dia.
• Ninguém levou dois dias ou mais.

Não há cauda longa. Não existe o cliente que "voltou na semana seguinte para terminar a integração". Ou a pessoa integra no primeiro dia, ou não integra. Isso vale para quem entrou por busca orgânica, por indicação de uma ferramenta de IA e por tráfego direto; a proporção é parecida em todas as origens.

O que isso diz sobre o esforço técnico: do cadastro ao primeiro POST cabe em uma hora. O roteiro é criar a instância, ler o QR com o celular, copiar o token e chamar o endpoint de envio. O comando pronto está em enviar mensagem de WhatsApp por API, em curl, Node.js e Python. Quem usa n8n faz o mesmo sem código, com o community node, seguindo como integrar WhatsApp no n8n.

Onde as pessoas travam: o QR Code

Se mais de um terço das instâncias criadas nunca conecta, vale entender por quê. Não fizemos pesquisa com essas pessoas, por decisão nossa, então o que segue vem dos atendimentos de suporte, em ordem de frequência:

1. O QR expirou antes da leitura. O código vale cerca de um minuto. A pessoa abre o WhatsApp, procura o menu de dispositivos conectados, e quando aponta a câmera o código já mudou. Basta gerar um novo, mas muita gente conclui que "não funcionou".
2. O número já estava conectado em outra ferramenta. Quem está trocando de API costuma deixar a sessão antiga viva. A conexão nova derruba a antiga, ou o contrário, e o resultado parece instabilidade.
3. Celular sem internet ou WhatsApp desatualizado no momento da leitura.
4. A pessoa está no próprio celular. Não dá para escanear a tela do aparelho com o mesmo aparelho. O código de pareamento resolve, mas nem todo mundo sabe que ele existe.

Por causa desses números, a tela da instância passou a mostrar as quatro causas, um botão para gerar QR novo e o atalho para conectar por código, abrindo sozinha quando o QR fica mais de um minuto na tela sem leitura. Vamos medir se a taxa de conexão sobe. O compromisso é publicar o resultado aqui, suba ou não.

O que acontece depois da primeira mensagem

O trial da Wafly dura 3 dias, sem cartão. Nos últimos 30 dias da medição, 48 pessoas se cadastraram, 39 criaram instância, 26 conectaram, 23 registraram a primeira mensagem e 7 assinaram. Dos que enviaram a primeira mensagem, 7 assinaram dentro do trial ou logo depois, o que dá 30% de conversão entre quem chegou à primeira mensagem.

Isso importa para quem está avaliando fornecedor por um motivo simples: a decisão de contratar acontece no mesmo dia da integração, porque a integração acontece no mesmo dia do cadastro. O que a pessoa vê nessa primeira hora é o que ela vai lembrar do produto. Não há segunda chance dentro do trial.

Como usar isso na sua avaliação

Se você vai testar uma API de WhatsApp, os dados sugerem um roteiro:

• Reserve uma hora, não uma semana. Se em uma hora você não conseguiu conectar e enviar, o problema é do serviço, não seu. Troque.
• Use um chip secundário. Testar no número principal expõe o canal que sustenta o seu atendimento a um serviço que você ainda não conhece.
• Teste o caminho de volta. Envie uma mensagem para o número conectado e veja se o webhook chega na sua URL. O envio é a metade fácil; o recebimento é o que faz um bot existir.
• Force um erro. Envie para um número que nunca falou com você e veja como o serviço reporta a recusa. Se a mensagem some em silêncio, você vai descobrir isso em produção. O erro em questão é o 463, e um bom serviço devolve o motivo nomeado.
• Compare a mensalidade só depois. A tabela de preços do mercado está em quanto custa uma API de WhatsApp, mas preço só importa para quem conectou.

O que ainda não sabemos

Três coisas que esta medição não responde, para não fingir que responde:

• Quanto tempo leva em minutos. Nosso registro é por dia. Vamos passar a gravar o horário da conexão para publicar a distribuição em minutos.
• Se quem integra por n8n leva mais ou menos tempo do que quem integra por código. Não separamos os dois grupos na origem do cadastro.
• Por que 30 cadastros nunca criam instância. A hipótese mais simples é curiosidade sem intenção de uso. Não vamos perguntar a eles; vamos observar se o número muda conforme o cadastro fica mais direto.

Estes números serão atualizados a cada mês, com a data de verificação no topo. Se você mede algo parecido na sua operação e chega a resultados diferentes, escreva para a gente.

Perguntas frequentes

Continue lendo

WhatsApp e Meta são marcas de seus respectivos donos, sem relação com a Wafly. Os preços de terceiros citados foram verificados na data indicada em cada tabela e mudam sem aviso: confira na fonte antes de decidir. Encontrou algo desatualizado ou discorda de alguma conclusão? Fale com a gente.