API | Help Services

Configurar API Oficial do WhatsApp — Meta

Neste tutorial, você aprenderá a configurar a API Oficial do WhatsApp, disponibilizada pela Meta, e integrá-la ao Help IA CRM.

aviso

Considerações importantes

Antes de iniciar a configuração, verifique os seguintes pontos:

É necessário utilizar a versão 15.0.7 ou superior do Help IA CRM.
A API Oficial do WhatsApp não oferece suporte a grupos.
O envio de templates deve ser configurado separadamente. Consulte o tutorial de templates.
A API Oficial não exibe a foto do contato.
Após o cliente enviar uma mensagem, você terá uma janela de 24 horas para responder normalmente pelo Help IA CRM.
Depois desse período, uma nova conversa somente poderá ser iniciada utilizando um template aprovado pela Meta.
Mesmo sendo uma API oficial, o número ainda pode sofrer restrições ou bloqueios caso as políticas da Meta não sejam cumpridas.

Dica:

Antes de iniciar, tenha em mãos uma conta do Facebook com acesso administrativo ao Gerenciador de Negócios da Meta e ao número de telefone que será utilizado.

Etapa 1: Criar o aplicativo na Meta

Acesse o painel de desenvolvedores da Meta:

Meta for Developers

Em seguida:

Faça login utilizando sua conta do Facebook.
Clique em Criar aplicativo.
Selecione a opção Outro.
Escolha o tipo de aplicativo Empresa.
Preencha as informações solicitadas.
Finalize a criação do aplicativo.

Etapa 2: Adicionar o WhatsApp ao aplicativo

Dentro do aplicativo criado:

Acesse a área de Produtos.
Localize o produto WhatsApp.
Clique em Configurar.
Selecione a empresa que será vinculada ao aplicativo.
Clique em Começar a usar a API.

Caso ainda não exista uma empresa vinculada à sua conta, será necessário criá-la antes de continuar.

Etapa 3: Configurar as informações básicas do aplicativo

No menu lateral do aplicativo, acesse:

Configurações do App > Básico

Preencha os seguintes campos obrigatórios:

URL da Política de Privacidade: informe o endereço da página que contém a política de privacidade da sua empresa.
URL dos Termos de Serviço: informe o endereço da página que contém os termos de serviço da sua empresa.

Após preencher os campos:

Clique em Salvar alterações.
No topo da página, altere o status do aplicativo de Em desenvolvimento para Ativo.

Aviso:

O aplicativo precisa estar ativo para funcionar corretamente em produção.

Etapa 4: Registrar o número de telefone

No menu lateral, acesse:

WhatsApp > Configuração da Produção

Em seguida:

Clique em Registrar seu número de telefone do WhatsApp.
Informe os dados solicitados.
Conclua a validação do número.
Habilite a opção Assinar webhooks.

Etapa 5: Adicionar as informações de pagamento

Ainda em:

WhatsApp > Configuração da Produção

Adicione as informações de pagamento da conta.

Aviso:

Caso as informações de pagamento não sejam cadastradas, a API Oficial do WhatsApp poderá não funcionar corretamente.

Etapa 6: Configurar o usuário do sistema

Acesse as configurações empresariais da Meta:

Configurações do negócio

No menu lateral:

Acesse Usuários > Usuários do sistema.
Selecione o usuário do sistema que será utilizado.
Clique em Atribuir ativos.

Na tela de atribuição de ativos, configure os seguintes acessos.

Aplicativo

Selecione o aplicativo criado anteriormente.
Ative a permissão Gerenciar aplicativo em Controle total.

Conta do WhatsApp

Selecione sua conta do WhatsApp.
Ative a permissão Gerenciar contas do WhatsApp Business em Controle total.

Após concluir, clique em Atribuir ativos.

Etapa 7: Gerar o token

Ainda na tela do usuário do sistema:

Clique em Gerar token.
Selecione o aplicativo criado.
Escolha a duração disponível para o token.
Adicione as seguintes permissões:

business_management

whatsapp_business_messaging

whatsapp_business_management

Clique em Gerar token.
Copie o token gerado.
Guarde-o em um local seguro.

Aviso:

O token permite acesso à sua conta do WhatsApp Business. Não compartilhe essa informação com pessoas não autorizadas.

Etapa 8: Criar a conexão no Help IA CRM

No Help IA CRM, acesse:

Conexões > Nova conexão > WhatsApp API Oficial

Campos da conexão

Nome: informe um nome para identificar a conexão dentro do Help IA CRM.
Phone Number ID: acesse seu aplicativo na Meta e vá em WhatsApp > Configuração da Produção. Copie o valor do campo Identificação do número de telefone.
Business ID: acesse seu aplicativo na Meta e vá em WhatsApp > Configuração da Produção. Copie o valor do campo Identificação da conta do WhatsApp Business.
WABA ID: na mesma tela do app na meta, no topo veja o campo Identificação do App.
Send Token: cole o token gerado anteriormente no usuário do sistema da Meta.
Phone Number: informe o número de telefone conectado à API Oficial, utilizando apenas números.

Exemplo:

5511999999999

Aviso:

Não utilize espaços, parênteses, traços ou o símbolo + no campo Phone Number.

Após preencher todos os campos, clique em Salvar.

Etapa 9: Copiar o Callback URL e o token

Após salvar a conexão, o Help IA CRM gerará as informações necessárias para configurar o webhook.

Localize a conexão criada.
Clique em Editar.
Copie o Callback URL.
Copie o Token da conexão.

Informação:

Essas duas informações serão utilizadas para validar a comunicação entre a Meta e o Help IA CRM.

Etapa 10: Configurar o webhook na Meta

Retorne ao aplicativo no painel da Meta.

No menu lateral, acesse:

WhatsApp > Configuração da Produção

Na área de configuração do webhook:

Cole o Callback URL gerado pelo Help IA CRM.
Cole o Token da conexão gerado pelo Help IA CRM.
Clique em Verificar e salvar.

Aviso:

O Callback URL e o token devem ser copiados exatamente como aparecem no Help IA CRM. Espaços extras ou informações incorretas podem impedir a validação.

Etapa 11: Testar a conexão

Após concluir a configuração:

Envie uma mensagem de outro número para o WhatsApp conectado.
Acesse o Help IA CRM .
Verifique se a nova conversa foi recebida.
Responda à mensagem para confirmar o envio e o recebimento.

Dica:

Faça o primeiro teste dentro da janela de 24 horas iniciada pela mensagem do cliente. Fora dessa janela, poderá ser necessário utilizar um template aprovado.

Finalização

Pronto! A API Oficial do WhatsApp foi configurada e integrada ao Help IA CRM.

A partir de agora, as mensagens recebidas pelo número cadastrado poderão ser visualizadas e respondidas diretamente pela plataforma, respeitando as regras e políticas estabelecidas pela Meta.