API oficial do WhatsApp: os três caminhos para atender, e o que cada um cobra

A API oficial é uma porta, não um aplicativo

A API oficial do WhatsApp é o canal que a plataforma abre para uma empresa conversar por programa, e não pelo aparelho: não há tela, não há celular e não há nada para instalar. Quem entrega a tela é um provedor contratado à parte. O que a API dá é o direito de receber e enviar mensagem com o número da empresa, dentro de regras declaradas.

Ninguém “compra a API”. Contrata-se um provedor que já tem acesso a ela e entrega o painel onde a equipe atende, o histórico e a ligação com os sistemas da empresa. A plataforma cobra pelo tráfego, o provedor cobra pelo resto.

Daí a separação que costuma vir embaralhada numa proposta só: por onde a conversa entra é uma decisão, e o que se automatiza é outra — esta segunda está nos quatro níveis de automação do guia da família.

Os três caminhos até uma conversa no WhatsApp

Há três formas de uma empresa atender pelo WhatsApp: o aplicativo instalado num aparelho, a API oficial contratada por um provedor, e as bibliotecas não oficiais que dirigem o aplicativo web por fora. As três funcionam numa demonstração. O que as separa não é o que elas fazem, é o risco que cada uma carrega quando o volume cresce.

O que cada caminho serve e o que cada um cobra está comparado lado a lado no guia da família. O que interessa aqui é a consequência de escolher o oficial: janela, modelo aprovado, cadastro e virada vêm no mesmo pacote, e nenhum deles se contrata em separado.

Três perguntas decidem qual caminho serve, e nenhuma é técnica: quantas pessoas atendem o mesmo número, se alguma mensagem precisa sair quando ninguém está olhando, e se aquele número é o que a empresa divulga.

O custo entra depois delas, e está no guia de quanto custa automatizar o atendimento. Setor com regra própria muda a resposta: em consultório, agenda e dado de saúde antecipam decisões que estão no guia de atendimento para clínicas.

O caminho não oficial é dívida, e a garantia é o número

O caminho não oficial é tentador porque entrega numa tarde o que a API entrega em dias, sem cadastro e sem aprovação de texto nenhum. A dívida que ele contrai é a conta: ela opera fora do que a plataforma prevê para empresa e pode ser desligada sem aviso e sem recurso. O que se perde não é o software — é o número.

E o número é o ativo. Ele está salvo no celular de cada cliente, impresso no cartão e em toda peça de anúncio que já rodou. Trocá-lo é pedir a cada cliente que atualize um contato que ele não tem motivo para atualizar — e junto com ele vai o histórico.

O desligamento também não avisa, e chega quando o volume sobe — a semana em que o canal está sendo mais usado. Não há suporte para acionar, porque não há contrato.

A janela de vinte e quatro horas

A janela de 24 horas é o período em que a empresa responde livremente, contado a partir da última mensagem que o cliente enviou. Dentro dela vale texto escrito na hora, áudio, imagem e documento. Fora dela, qualquer contato exige um modelo aprovado antes pela plataforma. Cada nova mensagem do cliente reabre a contagem.

O que a regra faz com o desenho do atendimento — o que se resolve na mesma conversa, quais avisos valem virar modelo aprovado, o que a equipe precisa enxergar na tela — está no guia da família. A mecânica é o que decide aqui: cada conversa parada carrega um prazo próprio, e quem fala depois dele não está respondendo, está enviando.

O modelo de mensagem é escrito por quem conhece o processo

Um modelo de mensagem é um texto submetido à plataforma e aprovado antes do envio, com lacunas para o que muda de pessoa para pessoa: nome, horário, número do pedido. Ele é o único jeito previsto de falar com quem está fora da janela. A aprovação julga a categoria declarada, a clareza do texto e se ele entrega o que promete.

• Passa. Confirmação de agendamento, aviso de mudança no status de um pedido, lembrete que o cliente pediu, código de acesso.
• Não passa. Promoção declarada como utilidade, texto que abre com uma lacuna solta, e mensagem vaga do tipo “oi, tudo bem?”, que não diz de onde vem nem por quê.
• Reprova por detalhe. Erro de digitação, lacunas seguidas sem texto entre elas, e texto que promete uma coisa e entrega outra.

Escrever modelo parece tarefa de fornecedor e não é: o texto precisa caber na regra da empresa — o que se pode prometer, em que prazo —, e isso mora com quem atende.

O que precisa estar de pé antes de pedir a habilitação

Habilitar a API oficial exige cinco coisas prontas: a conta comercial da empresa na plataforma, a verificação do negócio, um número que não esteja em uso no aplicativo, um nome de exibição que se sustente e o provedor escolhido. Nenhuma é difícil. Todas travam quando a empresa descobre o item na hora de usá-lo.

Duas perguntas ao provedor, antes de assinar, evitam a maior parte do arrependimento: o histórico sai daqui em formato aberto, e quem fica com a titularidade da conta comercial? A resposta certa para a segunda é a empresa.

O dia da virada, e o que não vai junto

No dia da virada o número sai do aplicativo e passa a ser atendido pela tela do provedor. O aparelho para de receber aquelas conversas na mesma hora, e quem atendia passa a atender em outro lugar. O que não vai junto é o histórico: as conversas antigas ficam onde estavam, e a caixa nova começa vazia.

Não é defeito de provedor nem de plataforma, e não há como contornar: é por isso que a virada precisa de data escolhida, e não do dia em que o cadastro ficar pronto.

1. Exporte as conversas antes

   Do aparelho, enquanto ele ainda tem o número. Depois não há de onde exportar.

2. Escolha uma janela de volume baixo

   Fora de data comercial e de campanha no ar. Desfazer a virada é outro pedido, com outro prazo.

3. Treine a tela nova antes

   A equipe precisa achar a conversa, a busca e a transferência antes da primeira mensagem real.

4. Refaça o perfil e deixe alguém de plantão

   Foto, descrição e catálogo não migram — e o primeiro dia sempre revela uma integração que ninguém testou.

E vale dizer o que não muda: para o cliente, o número é o mesmo e a conversa abre no mesmo lugar.

Perguntas frequentes