Guia da API do WhatsApp Business: como começar a usar o aplicativo passo a passo

O WhatsApp Business API é a ferramenta definitiva para empresas que precisam escalar suas comunicações com os clientes. Ao contrário do aplicativo normal do WhatsApp Business, a API permite automações, integrações de CRM, chatbots inteligentes e o gerenciamento de milhares de conversas simultâneas. No entanto, o processo de configuração pode ser confuso para usuários iniciantes.

Neste guia completo, explicamos passo a passo como configurar a API do WhatsApp Business, desde os pré-requisitos até o envio de sua primeira mensagem. Quer você escolha a API direta da Meta na nuvem ou trabalhe com um BSP (Business Solution Provider) como o Aurora Inbox, aqui você encontrará tudo o que precisa saber.

O que é a API do WhatsApp Business e por que você precisa dela?

A API do WhatsApp Business é uma interface de programação que permite que empresas de médio e grande porte integrem o WhatsApp em seus sistemas de comunicação. Ao contrário do aplicativo gratuito do WhatsApp Business, a API oferece:

• MultiagenteVários agentes podem atender a conversas do mesmo número.
• Automação avançadaChatbots, respostas automatizadas e fluxos de conversação.
• IntegraçõesConexão com CRM, ERP, plataformas de comércio eletrônico e muito mais.
• Mensagens em massaEnvio de notificações e sinos para listas de contatos com modelos aprovados.
• EscalabilidadeManuseio de milhares de conversas simultâneas sem limitações.
• Métricas e análisesRelatórios detalhados de entrega, leitura e resposta.

Se a sua empresa recebe mais de 50 mensagens por dia, precisa automatizar as respostas ou exige que vários agentes atendam a partir de um único número, a API é a solução para você.

Pré-requisitos para configurar a API do WhatsApp Business

Antes de iniciar o processo de configuração, verifique se você atende a esses requisitos:

Lista de verificação

• Conta comercial do Facebook (Meta Business Suite)Você precisa de uma conta comercial verificada no Meta.
• Negócio verificadoSua empresa deve passar pelo processo de verificação do Meta com documentação legal.
• Número de telefone dedicadoUm número que NÃO está registrado atualmente no WhatsApp ou no WhatsApp Business.
• Site ativoUm site funcional que representa sua empresa.
• Documentação legalRegistro comercial, RUT, NIT ou documento equivalente do seu país que comprove a existência legal da sua empresa.
• E-mail comercialDe preferência, com seu próprio domínio (não Gmail ou Hotmail).
• Política de privacidadeUma política de privacidade publicada em seu site.
• Conformidade com as políticas da TargetSua empresa não deve pertencer a categorias restritas (armas, tabaco, conteúdo adulto, etc.).

Sobre o número de telefone

Esse é um ponto crítico que muitos ignoram. O número que você usa para a API:

• Não pode ser vinculado em qualquer conta pessoal do WhatsApp ou no aplicativo WhatsApp Business.
• Deve ser capaz de receber chamadas ou SMS para verificação.
• Pode ser um número de telefone fixo (a verificação será feita por chamada) ou um número de celular.
• Uma vez registrado na API, você não poderá usar esse número no aplicativo normal do WhatsApp.

Recomendamos que você adquira um novo número dedicado exclusivamente à API. Isso evita conflitos e perda do histórico de conversas.

Etapa 1: Crie uma conta no Meta Business Suite

A primeira etapa é ter uma conta comercial no Meta (antigo Facebook Business Manager).

1. Faça login em business.facebook.com.
2. Clique em Criar uma conta.
3. Digite o nome de sua empresa, seu nome e endereço de e-mail comercial.
4. Preencha os detalhes da sua empresa: endereço, site e número de telefone para contato.
5. Confirme seu endereço de e-mail.

Se você já tiver uma conta do Facebook Business Manager, poderá usá-la diretamente. Certifique-se de que você tenha permissões de administrador.

Dicas importantes

• Use o nome legal de sua empresa, não um nome informal.
• Verifique se as informações correspondem aos seus documentos legais.
• Não use contas pessoais para gerenciar a conta comercial.

Etapa 2: Verifique sua empresa no Meta

A verificação de negócios é obrigatória para acessar a API do WhatsApp. Esse processo confirma que sua empresa é uma entidade legal real.

1. No Meta Business Suite, vá para Configuração > Centro de Segurança > Verificação de negócios.
2. Insira os detalhes legais da sua empresa: nome registrado, endereço fiscal e número de registro.
3. Faça o upload da documentação necessária:
   • Certificado de registro comercial ou incorporação de uma empresa.
   • Conta de serviços públicos em nome da empresa.
   • Extrato bancário da empresa.
   • Declarações fiscais recentes.
4. A Meta analisará sua solicitação dentro de 1 a 5 dias úteis.
5. Você receberá uma notificação por correio com o resultado.

Documentos aceitos por país

• MéxicoCertificado de incorporação, comprovante de situação fiscal do SAT.
• ColômbiaCâmara de Comércio, RUT.
• ArgentinaCertificado CUIT, artigos de associação.
• ChileEscritura de incorporação, certificado SII.
• PeruArquivo RUC, escritura pública.
• Espanha: Memorando de Associação, Código de Identificação Fiscal.

Etapa 3: Escolha entre a API direta da nuvem ou um BSP

Aqui você tem uma decisão importante a tomar. Há duas maneiras de acessar a API do WhatsApp Business:

Opção A: API de nuvem diretamente do Meta

O Meta oferece acesso direto por meio de sua API na nuvem. Essa opção é gratuita em termos de infraestrutura (você só paga por conversa).

Vantagens:

• Não há custos adicionais de infraestrutura.
• Acesso direto aos recursos mais recentes.
• Documentação oficial do Meta.

Desvantagens:

• Requer conhecimento técnico avançado.
• Você deve desenvolver sua própria interface de usuário.
• Suporte Meta limitado para configuração.
• Você precisa de uma equipe de desenvolvimento dedicada.

Opção B: usar um BSP (Business Solution Provider)

Um BSP como Caixa de entrada Aurora fornece a infraestrutura, a interface de usuário e o suporte técnico necessários para usar a API sem complicações técnicas.

Vantagens:

• Configuração rápida e guiada.
• Interface visual pronta para uso (caixa de entrada compartilhada, chatbots, etc.).
• Suporte técnico especializado.
• Funcionalidades adicionais, como CRM integrado, chatbots com IA e análises avançadas.
• Você não precisa de uma equipe de desenvolvimento.

Desvantagens:

• Custo mensal da plataforma BSP.
• Dependência do fornecedor para atualizações.

Para a maioria das empresas, especialmente aquelas sem uma equipe técnica dedicada, trabalhar com um BSP como o Aurora Inbox é a maneira mais eficiente e rápida de estar operacional.

Etapa 4: Registre seu número de telefone

Depois que sua empresa for verificada, é hora de registrar o número de telefone na plataforma do WhatsApp Business.

Se você usar a API direta da nuvem:

1. No Meta Business Suite, vá para a seção de Whatsapp no painel esquerdo.
2. Selecione Início e siga o assistente de configuração.
3. Digite o número de telefone que deseja registrar.
4. Selecione o método de verificação: SMS ou chamada telefônica.
5. Digite o código de verificação recebido.
6. Configure seu perfil comercial: nome de exibição, categoria, descrição e foto do perfil.

Se você usar o Aurora Inbox como um BSP:

1. Faça login em sua conta do Aurora Inbox.
2. Ir para Configuração > Canais > Whatsapp.
3. Siga o assistente integrado que o guiará pelo processo Meta.
4. O Aurora Inbox gerencia automaticamente o registro e a configuração técnica.
5. Em minutos, você terá seu número pronto para operar.

Etapa 5: obter acesso à API

Para a API direta da nuvem:

1. Ir para desenvolvedores.facebook.com.
2. Crie um novo aplicativo do tipo Negócios.
3. Adicionar o produto Whatsapp em seu aplicativo.
4. Gerar um token de acesso permanente a partir da configuração do sistema.
5. Anote suas ID do número de telefone e ID da conta do WhatsApp Business.
6. Configure o webhook para receber mensagens.

Para a caixa de entrada do Aurora:

O processo é transparente. O Aurora Inbox cuida de toda a configuração técnica da API em segundo plano. Quando seu número estiver conectado, a API estará pronta para ser usada por meio da plataforma sem a necessidade de mexer no código.

Etapa 6: Envie sua primeira mensagem

Com a API configurada, é hora de enviar sua primeira mensagem. É importante entender que a API do WhatsApp Business tem dois tipos de mensagens:

• Mensagens da sessãoRespostas em até 24 horas após a última mensagem do cliente. Elas são gratuitas na maioria dos casos.
• Mensagens de modeloMensagens iniciadas pela empresa fora do período de 24 horas. Elas exigem aprovação prévia da Meta e têm um custo por conversa.

Envie uma mensagem de teste com a API do Cloud:

curl -X POST "https://graph.facebook.com/v17.0/TU_PHONE_NUMBER_ID/messages" \
-H "Autorização: Portador TU_ACCESS_TOKEN" \
H "Content-Type: application/json" -H "Content-Type: application/json" curl -X POST "-X POST " \
-d '{
  "messaging_product": "whatsapp",
  "to": 'DESTINATION_NUMBER',
  "type": 'template',
  "template": {
    "name": "hello_world",
    "language": { "code": "en" }
  }
}'

Enviar uma mensagem da Caixa de entrada do Aurora:

Basta abrir a caixa de entrada, selecionar um contato e escrever sua mensagem. A plataforma cuida de toda a comunicação com a API.

Etapa 7: Criar modelos de mensagens

Os modelos são essenciais para iniciar as conversas com os clientes. Cada modelo deve ser aprovado pela Meta antes de ser usado.

Categorias de modelos:

• MarketingPromoções, ofertas, lançamentos de produtos.
• UtilidadeConfirmações de pedidos, atualizações de remessas, lembretes de compromissos.
• AutenticaçãoCódigos OTP, verificação em duas etapas.

Práticas recomendadas para aprovação:

1. EspecificadoIndicação clara do objetivo da mensagem: Indica claramente o objetivo da mensagem.
2. Use as variáveis corretamente: Marca com {{1}}, {{2}} campos dinâmicos.
3. Evite conteúdo ambíguoNão use linguagem que possa ser interpretada como spam.
4. Inclui opção de cancelamento de registroEspecialmente em mensagens de marketing.
5. Não mencione outras plataformasEvite referências ao Telegram, ao Signal ou a outros concorrentes.

Exemplo de um modelo de utilitário:

Olá {{1}}, seu pedido #{2}} foi despachado.
Você pode rastreá-lo aqui: {{3}}
Tempo estimado de entrega: {{4}}}

Obrigado por sua compra.

Etapa 8: Conecte-se à sua plataforma de gerenciamento

A última etapa é integrar a API com as ferramentas que você já usa em sua empresa.

Integrações comuns:

• CRMHubSpot, Salesforce, Zoho.
• Comércio eletrônico: Shopify, WooCommerce, Magento.
• Central de atendimentoZendesk, Freshdesk.
• AutomaçãoZapier, Make (Integromat).
• Plataforma tudo em umAurora Inbox (CRM + caixa de entrada compartilhada + chatbots + API).

Com o Aurora Inbox, todos esses recursos são integrados de forma nativa, eliminando a necessidade de várias ferramentas e configurações complexas.

Detalhamento de custos da API do WhatsApp Business

Compreender a estrutura de custos é fundamental para planejar seu orçamento.

Modelo de preço de conversação (2024-2025):

Meta-taxas para Conversa de 24 horasnão por mensagem individual:

Categoria	Preço aproximado (USD)
Marketing	$0.035 – $0.080
Utilidade	$0.020 – $0.050
Autenticação	$0.030 – $0.060
Serviço (iniciado pelo cliente)	Gratuito* Gratuito* Gratuito

*As primeiras 1.000 conversas de serviço por mês são gratuitas.

Os preços variam de acordo com o país do destinatário. Consulte a tabela oficial do Meta para obter os preços exatos em sua região.

Custos adicionais a serem considerados:

• BSP (se aplicável)Planos mensais que variam de acordo com o provedor e as funcionalidades.
• Desenvolvimento (se estiver usando a API direta da nuvem)Custos de equipamentos técnicos para desenvolvimento e manutenção.
• Número de telefoneCusto do número dedicado se você comprar um novo.

Motivos comuns de rejeição e como evitá-los

Muitas empresas enfrentam rejeições no processo de verificação ou aprovação de modelos. Aqui estão as causas mais frequentes:

Recusa de verificação de negócios:

1. Informações inconsistentesSolução: Os dados no Meta não correspondem aos documentos. Solução: Verifique se o nome, o endereço e os números correspondem exatamente.
2. Documentação ilegívelSolução: imagens borradas ou documentos incompletos. Solução: faça upload de documentos completos e em alta resolução.
3. Site não funcionalSolução: O site não carrega ou não tem informações sobre a empresa. Solução: certifique-se de ter um site ativo com detalhes de contato visíveis.
4. Categoria restritaSua empresa pertence a um setor não permitido. Solução: verifique as políticas comerciais do Meta antes de se candidatar.

Rejeição de modelos de mensagens:

1. Conteúdo genéricoSolução: modelos muito vagos, como "Olá, temos uma oferta para você". Solução: seja específico com relação à oferta ou às informações.
2. Falta de variáveisSolução: use textos completamente estáticos sem personalização. Solução: inclua pelo menos uma variável.
3. Conteúdo do ganchoPromessas exageradas ou informações falsas. Solução: seja honesto e transparente.
4. Pressão excessivaLinguagem artificial de urgência, como "ÚLTIMA CHANCE". Solução: use um tom profissional e respeitoso.

Como o Aurora Inbox simplifica todo o processo

O Aurora Inbox é um BSP oficial do WhatsApp que elimina a complexidade técnica do processo de configuração. Com o Aurora Inbox, você obtém:

• Configuração guiada em minutosUm assistente passo a passo que o orienta desde a verificação até o envio da primeira mensagem.
• Caixa de entrada compartilhadaVários agentes que atendem do mesmo número com atribuição inteligente.
• Chatbots com inteligência artificialAutomatiza respostas frequentes e qualifica leads sem intervenção humana.
• CRM integradoGerencie contatos, funis de vendas e acompanhamentos na mesma plataforma.
• Modelos pré-aprovadosAcesso a uma biblioteca de modelos otimizados para taxas de aprovação mais altas.
• Análise avançadaMétricas de desempenho, tempos de resposta e satisfação do cliente.
• Suporte em inglêsEquipe de suporte que o acompanha durante todo o processo de configuração.

Em vez de passar semanas em uma configuração técnica, com o Aurora Inbox você pode começar a trabalhar em menos de 24 horas.

Perguntas Frequentes (FAQ)

1) Quanto tempo leva todo o processo de configuração da API do WhatsApp Business?

O tempo total depende do método escolhido. Com o Cloud API Direct, o processo pode levar de 1 a 3 semanas, considerando a verificação da empresa (1 a 5 dias), o desenvolvimento técnico (1 a 2 semanas) e a aprovação do modelo (24 a 48 horas). Com um BSP como o Aurora Inbox, você pode começar a operar em 24 a 72 horas, pois o processo de verificação é simplificado e a configuração técnica é imediata.

2. Posso migrar meu número existente do WhatsApp Business App para a API?

Sim, é possível migrar seu número, mas você deve estar ciente de que perderá o histórico de conversas do aplicativo. O processo requer a exclusão da conta do WhatsApp Business App primeiro e, em seguida, o registro do número na API. Recomendamos que você informe seus contatos antes da migração e considere o uso de um novo número para evitar interrupções no serviço.

3. O que acontecerá se minha verificação de empresa for rejeitada?

Se a sua verificação for rejeitada, a Meta o notificará sobre o motivo. Você poderá corrigir as informações e reenviar a solicitação. Os motivos mais comuns são documentação inconsistente ou ilegível. Não há limite para o número de tentativas, mas cada revisão pode levar de 1 a 5 dias úteis. Com o Aurora Inbox, nossa equipe o orienta sobre a documentação correta antes de enviar a solicitação, reduzindo significativamente as chances de rejeição.

4. Quantas mensagens posso enviar por dia com a API do WhatsApp Business?

A API do WhatsApp Business tem limites de mensagens em camadas. As novas contas começam com um limite de 250 conversas iniciadas por empresas em 24 horas. À medida que você mantém uma boa qualidade (sem denúncias de spam), seu limite aumenta progressivamente: 1.000, 10.000 e, finalmente, ilimitado. As mensagens de resposta dentro da janela de 24 horas não têm limite. É importante manter uma classificação de alta qualidade para que seus limites não sejam reduzidos.

5. a API do WhatsApp Business funciona para pequenas empresas ou somente para grandes empresas?

A API do WhatsApp Business é viável para empresas de todos os tamanhos. Com provedores como o Aurora Inbox oferecendo planos acessíveis, até mesmo as pequenas empresas podem aproveitar os benefícios da API: vários agentes, automações básicas, integração com ferramentas de vendas e mensagens em massa. O segredo é avaliar se o seu volume de mensagens justifica o investimento. Se você recebe mais de 50 mensagens por dia ou precisa de vários membros da equipe para lidar com o WhatsApp simultaneamente, a API é a escolha certa, independentemente do tamanho da sua empresa.

---

A configuração da API do WhatsApp Business não precisa ser um processo complicado. Com a orientação correta e as ferramentas certas, qualquer empresa pode aproveitar o poder da API para transformar a comunicação com o cliente. Se você preferir um caminho técnico rápido e descomplicado, o Aurora Inbox está pronto para ajudá-lo a dar o primeiro passo.