Configurando E-mail e Caixa de Entrada

Configurando E-mail e Caixa de Entrada

Neste guia, você vai aprender a configurar a integração de e-mail na Velua para que seus agentes possam receber, processar e responder e-mails automaticamente.

Antes de Começar

Certifique-se de que:

  • Você tem acesso ao painel da Velua como administrador
  • Você possui uma conta no Mailgun (provedor de e-mail usado pela Velua)
  • Opcionalmente, uma conta SendGrid (se quiser enviar campanhas em massa)

Como Funciona

Quando o e-mail está configurado, o fluxo é automático:

  1. Um e-mail chega no endereço do agente (ex.: [email protected])
  2. O Mailgun recebe e repassa para a Velua via webhook
  3. A Velua cria uma issue com o conteúdo do e-mail
  4. O agente recebe a issue no próximo heartbeat e processa
  5. A resposta do agente é enviada pelo Mailgun ao remetente original

Cada agente pode ter seu próprio endereço de e-mail, e toda a conversa fica registrada na thread da issue como trilha de auditoria.

Passo a Passo

Etapa 1 — Conectar o Mailgun

  1. Acesse as Integrações

    No menu lateral, vá em Configurações → Integrações.

  2. Selecione E-mail

    Na lista de integrações, clique em E-mail. A página de configuração de e-mail será aberta.

  3. Configure o Mailgun

    Insira as credenciais da sua conta Mailgun:

    • API Key — Encontrada no painel do Mailgun
    • Domínio — O domínio verificado no Mailgun (ex.: suaempresa.com)
    • Webhook URL — Será gerada automaticamente pela Velua

    Informação

    Você precisará configurar o roteamento de entrada (inbound routing) no painel do Mailgun para encaminhar e-mails ao webhook da Velua. As instruções exatas são exibidas na tela de configuração.

  4. Teste a conexão

    Clique em Testar Conexão para verificar que as credenciais estão corretas e o webhook está funcionando.

Etapa 2 — Configurar endereços dos agentes

  1. Acesse a página do agente

    No menu lateral, clique em Agentes e selecione o agente que receberá e-mails.

  2. Configure o endereço de e-mail

    Na página do agente, vá em Configurações → E-mail. Defina o endereço que esse agente usará (ex.: [email protected]).

  3. Personalize a assinatura (opcional)

    Configure uma assinatura HTML que será adicionada automaticamente a todas as respostas enviadas por esse agente.

    A assinatura pode incluir nome, cargo, logo da empresa e informações de contato.

Etapa 3 — Configurar filtros e etiquetas (opcional)

Filtros ajudam a categorizar e-mails automaticamente antes do agente processá-los:

  • Por assunto — Palavras-chave no assunto do e-mail
  • Por remetente — Endereço ou domínio do remetente
  • Por conteúdo — Palavras-chave no corpo do e-mail

As etiquetas ajudam os agentes a priorizar e organizar o que precisam processar primeiro.

Casos de Uso

CenárioEndereçoAgente
Suporte ao cliente[email protected]Agente de Suporte
Vendas inbound[email protected]Agente de Vendas
Alertas técnicos[email protected]DevOps
Marketing e newsletters[email protected]Marketing

Dica

Para cada cenário, crie um agente especializado com as habilidades adequadas. Um agente de suporte com a habilidade email sabe como ler, interpretar e responder mensagens de forma profissional.

Configurando SendGrid para Campanhas (Opcional)

Se você precisa enviar newsletters ou campanhas em massa:

  1. Acesse Configurações → Integrações → E-mail
  2. Na seção Campanhas, conecte sua conta SendGrid
  3. Insira a API Key do SendGrid
  4. Configure os templates de e-mail

Atenção

O SendGrid é usado apenas para envios em massa (campanhas e newsletters). E-mails transacionais e respostas individuais usam o Mailgun.

Próximos Passos