Principais Recursos
- Notificações Push em Tempo Real: Alimentado pelo Google Cloud Pub/Sub, e-mails recebidos disparam a execução do bot em milissegundos sem necessidade de verificação periódica (polling).
- Execução Automatizada de Fluxos: Extrai automaticamente assunto, corpo da mensagem e anexos, enviando-os diretamente para o seu bot ou agente de IA no Studio.
- Respostas Diretas por E-mail: Envia respostas diretamente a partir do seu endereço do Gmail ou Google Workspace conectado, preservando o histórico da conversa.
- Renovação Automática do Watch: As notificações do Google Pub/Sub expiram após 7 dias. O SendBot renova automaticamente as assinaturas ativas em segundo plano para manter seu bot 100% online.
Como Funciona
- E-mail de Entrada: Um cliente ou lead envia um e-mail para o seu endereço do Gmail conectado.
- Notificação Pub/Sub (Webhook): O Google Cloud Pub/Sub envia uma notificação push instantânea para o SendBot (
POST /v3/integrations/gmail/webhook). - Execução do Bot: O SendBot processa o conteúdo da mensagem, associa ao bot do seu workspace e executa a lógica configurada (ex: Agente de IA, qualificação de lead ou FAQ).
- Envio da Resposta: Respostas geradas pelo bot ou pela equipe de atendimento são entregues utilizando a sua conta do Gmail autenticada.
Passo a Passo de Configuração
Passo 1: Conectar sua Conta do Google
- No SendBot Studio, abra o seu projeto e navegue até Publicar > Gmail (Publish > Gmail).
- Clique em Conectar Conta do Gmail e autorize o SendBot via Google OAuth2.
Passo 2: Ativar o Monitoramento (Watch)
- Selecione sua conta autenticada no menu suspenso.
- Clique em Iniciar Watch (Start Watch) para ativar as notificações em tempo real.
- Você verá um indicador de status indicando
Watch active until [Data].
Requisitos & Solução de Problemas
Erro: Mail service not enabled
Erro: Mail service not enabled
Este erro ocorre quando a conta do Google autenticada não possui uma caixa de e-mail do Gmail ativa.
- Usuários do Google Workspace: Verifique se o administrador da sua organização ativou o serviço do Gmail para a sua conta.
- Projetos GCP Próprios: Certifique-se de que a Gmail API (
gmail.googleapis.com) está ativada na biblioteca de APIs do Google Cloud Console.
Preciso renovar o Watch manualmente a cada 7 dias?
Preciso renovar o Watch manualmente a cada 7 dias?
Não. O SendBot possui um worker em segundo plano (
gmailWatchRenewal) que renova automaticamente todos os watches ativos antes que eles me expirem.Minhas credenciais OAuth estão seguras?
Minhas credenciais OAuth estão seguras?
Sim. O SendBot nunca armazena a sua senha do Google. As conexões usam tokens de atualização OAuth2 criptografados com isolamento estrito por workspace.