Integre Agentes de IA com WhatsApp

Introdução

A integração com WhatsApp permite que agentes de IA interajam diretamente com usuários através de uma das plataformas de mensagens mais populares do mundo. Este guia vai te orientar pelo processo de conectar seus agentes SipPulse AI com a API do WhatsApp Business, abrindo novas possibilidades para engajamento automatizado com clientes.

Pré-requisitos

• Uma conta SipPulse AI com pelo menos um agente configurado
• Uma conta Meta Business
• Uma conta WhatsApp Business API
• Um número de telefone comercial verificado
• Uma URL de webhook com SSL habilitado para receber mensagens

Processo de Integração Passo a Passo

1. Configurando a API do WhatsApp Business

1. Acesse o Portal de Desenvolvedores Meta (developers.facebook.com)
2. Crie um novo aplicativo ou selecione um existente
3. Adicione o produto WhatsApp Business API ao seu aplicativo
4. Complete o processo de verificação do negócio
5. Configure seu perfil do WhatsApp Business

2. Selecione um Número de Telefone

Após completar esta etapa, você pode configurar os números de telefone necessários na seção WhatsApp do seu aplicativo de desenvolvedor do Facebook. Após a conclusão bem-sucedida, você receberá um ID do Número de Telefone e um ID da Conta WhatsApp Business.

Com esses IDs, você pode configurar um webhook no SipPulse.AI. Na mesma página, você pode criar tokens para acesso temporário de 24 horas. Para um token permanente, você precisará acessar as configurações do sistema e criar um token com as permissões apropriadas (mais informações disponíveis em https://developers.facebook.com/blog/post/2022/12/05/auth-tokens/).

Configure seus dados no SipPulse AI e defina uma palavra de verificação do token. Em seguida, vá para a página de integrações e crie uma nova Integração do WhatsApp.

3. Gerando um Token do Sistema

• Acesse o Meta Business Manager – Vá para "Configurações do Negócio" > "Usuários" > "Usuários do Sistema"
• Clique em "Adicionar" e crie um novo Usuário do Sistema
• Defina a função (Administrador é recomendado para acesso total)
• Gere um token para este Usuário do Sistema
• Selecione "Nunca" para expiração do token
• Selecione as permissões necessárias:
  • whatsapp_business_management
  • whatsapp_business_messaging

4. Crie a Integração no SipPulse AI

5. Complete a Integração

Nas opções avançadas, defina o tempo limite de inatividade do agente. Após um período sem mensagens, o thread será removido. Você também pode definir uma mensagem para ser enviada se a integração estiver desativada. Adicionalmente, você pode definir uma mensagem de encerramento do thread que será enviada quando o thread for fechado devido à inatividade.

Após completar a integração, crie um webhook. Quando você salvar a página de integração, receberá uma identificação de webhook. Copie esta URL para a definição de webhook no Meta.

6. Configure o Callback

Configure a callback_url e o token de verificação na configuração do WhatsApp.

Uma vez que seu token esteja configurado no SipPulse AI, o sistema está pronto para enviar mensagens. Com a configuração do callback_url, ele também está pronto para receber mensagens. Para testar a integração, use seu celular para enviar uma mensagem para o número de telefone associado ao agente e verifique se você recebe uma resposta. Se encontrar algum problema, entre em contato com nosso suporte técnico através do canal Slack.

7. Teste o Sistema

Envie uma mensagem para o número de telefone configurado e aguarde uma resposta para verificar se a integração está funcionando corretamente.