Skip to content

Conectando seu Agente a Canais de Comunicação

Conectar seu Agente Nation a plataformas de mensagens como WhatsApp, Telegram e Discord é fundamental para interagir com seus clientes onde eles já estão. Esta documentação guia você pelo processo, seja você um empreendedor querendo expandir seu alcance ou um desenvolvedor integrando a solução.

Para Microempreendedores

Por que conectar seu agente?

Imagine seu negócio funcionando 24/7, respondendo a perguntas, agendando serviços e capturando leads, tudo isso diretamente nos aplicativos de mensagens que seus clientes mais usam. Integrar seu agente permite exatamente isso:

  • Esteja Onde Seus Clientes Estão: Aumente o engajamento e a conveniência, oferecendo suporte e vendas nos canais de comunicação preferidos do seu público.
  • Automatize o Atendimento: Libere seu tempo enquanto o agente cuida de tarefas repetitivas, como responder a perguntas frequentes ou qualificar clientes.
  • Nunca Perca uma Oportunidade: Capture contatos e inicie conversas de vendas automaticamente, mesmo fora do horário comercial.

Como funciona em cada canal?

  • WhatsApp: Ideal para comunicação direta e profissional. Use-o para enviar notificações, confirmações de agendamento e oferecer suporte ao cliente de forma personalizada.
  • Telegram: Excelente para criar comunidades e engajar grupos de usuários. O agente pode atuar como um moderador, enviar atualizações ou interagir com os membros do grupo.
  • Discord: Perfeito para comunidades de nicho, gamers ou projetos colaborativos. Seu agente pode gerenciar cargos, responder a comandos e integrar-se a um ecossistema de bots.

Para Desenvolvedores

Visão Geral da Arquitetura

A integração com canais de comunicação geralmente segue um padrão baseado em Webhooks.

  1. Configuração: Você registra um Bot ou Aplicativo na plataforma desejada (ex: Meta for Developers para WhatsApp, BotFather para Telegram).
  2. Webhook: Você informa à plataforma um URL de webhook (um endpoint da sua aplicação).
  3. Recebimento de Mensagens: Quando um usuário envia uma mensagem para o seu bot, a plataforma envia uma requisição HTTP (geralmente POST) para o seu URL de webhook com os dados da mensagem.
  4. Processamento: Sua aplicação recebe a requisição, processa a mensagem com a lógica do Agente Nation e determina uma resposta.
  5. Envio de Respostas: Sua aplicação utiliza a API da plataforma para enviar a resposta de volta ao usuário.

Configuração Técnica

WhatsApp
  • Plataforma: A integração é feita através da API do WhatsApp Business, gerenciada pela Meta.
  • Passos:
    1. Crie um aplicativo no Meta for Developers.
    2. Configure o produto "WhatsApp" no seu aplicativo.
    3. Obtenha um ID de número de telefone e um Token de acesso.
    4. Configure um endpoint de webhook no seu servidor para receber as mensagens. Verifique a assinatura da requisição para garantir que ela veio da Meta.
    5. Use a API de Mensagens para enviar respostas. Lembre-se que conversas iniciadas pelo bot fora da "janela de 24 horas" exigem o uso de Message Templates pré-aprovados.
  • Placeholder de Configuração: WHATSAPP_ACCESS_TOKEN=<SEU_TOKEN_DE_ACESSO> WHATSAPP_PHONE_ID=<SEU_ID_DE_TELEFONE> WHATSAPP_VERIFY_TOKEN=<SUA_CHAVE_SECRETA_PARA_WEBHOOK>
Telegram
  • Plataforma: A criação de bots é gerenciada pelo BotFather.
  • Passos:
    1. Inicie uma conversa com o @BotFather no Telegram.
    2. Use o comando /newbot para criar um novo bot e obter seu token de acesso.
    3. Configure o webhook usando o método setWebhook da API do Telegram, apontando para o seu endpoint.
    4. Trate os diferentes tipos de Update (mensagens, comandos, callbacks de botões).
  • Placeholder de Configuração: TELEGRAM_BOT_TOKEN=<SEU_TOKEN_DO_BOTFATHER>
Discord
  • Plataforma: Os aplicativos e bots são criados no Discord Developer Portal.
  • Passos:
    1. Crie uma "Application" no Discord Developer Portal.
    2. Na aba "Bot", crie um novo bot e obtenha seu token.
    3. Configure os Gateway Intents para definir quais eventos seu bot irá receber (ex: GUILD_MESSAGES para mensagens em servidores).
    4. A comunicação pode ser feita via WebSockets (Gateway API) para tempo real ou via Webhooks para interações mais simples. Para um agente de conversação, a Gateway API é a mais indicada.
  • Placeholder de Configuração: DISCORD_BOT_TOKEN=<SEU_TOKEN_DE_BOT> DISCORD_CLIENT_ID=<SEU_CLIENT_ID_DE_APLICATIVO>

Principais Desafios

  • Verificação e Políticas (WhatsApp): O processo de verificação da empresa e a aprovação de templates de mensagem no WhatsApp podem ser lentos e rigorosos.
  • Gerenciamento de Estado: Manter o contexto da conversa entre diferentes mensagens e plataformas é um desafio. É crucial implementar um bom sistema de gerenciamento de sessão.
  • Limites de Taxa (Rate Limiting): Todas as plataformas impõem limites no número de mensagens que você pode enviar em um determinado período. Sua aplicação deve ser capaz de lidar com esses limites de forma elegante.
  • Segurança de Webhooks: Seu endpoint de webhook deve ser protegido. Verifique sempre as assinaturas das requisições (ex: X-Hub-Signature-256 do WhatsApp) para garantir que a solicitação é legítima.