Actions (Ações do Agent)

Actions são tarefas que o agent executa automaticamente durante a conversa — sem precisar de código adicional no seu site.

O que são Actions?

Enquanto o agent responde perguntas (RAG), ele também pode agir: salvar um email, abrir um ticket, gerar um link de pagamento ou chamar qualquer API externa.

O agent decide quando usar uma Action com base no contexto da conversa. Você configura a intenção, o Simple Agent cuida da lógica.

---

Actions disponíveis

Captura de Lead

O agent solicita o email (e opcionalmente nome e telefone) quando detecta intenção de compra ou solicitação de contato.

Quando usar: Quando o usuário perguntar sobre preço, querer falar com vendas ou solicitar demonstração.

Configuração:

1. Dashboard → Actions → Captura de Lead
2. Configure os campos (email obrigatório, nome e telefone opcionais)
3. Defina as intenções de gatilho:
   • preço, plano, orçamento → solicitar contato
   • falar com humano, vendas → solicitar contato

Integração: Os leads são salvos em Leads → CRM e podem ser exportados como CSV ou sincronizados via webhook com seu CRM.

---

Abertura de Ticket (Helpdesk)

O agent cria um ticket automaticamente quando não consegue resolver ou quando o usuário pede suporte humano.

Integrações disponíveis:

• Email (envia para o endereço configurado)
• Webhook (envia o JSON para o seu helpdesk)
• Zendesk, Intercom, Freshdesk via webhook

Payload do ticket:

{
  "conversation_id": "conv_xxx",
  "user_email": "usuario@exemplo.com",
  "summary": "Usuário relatou erro ao gerar relatório em PDF",
  "transcript": [...],
  "created_at": "2026-05-14T10:30:00Z"
}

---

Stripe Checkout Link

O agent gera e envia um link de pagamento Stripe na conversa.

Quando usar: E-commerce, cursos, assinaturas — quando o usuário demonstra intenção de compra.

Configuração:

1. Conecte sua conta Stripe em Integrações → Stripe
2. Em Actions → Stripe Link, selecione o produto ou price ID
3. O agent gera https://checkout.stripe.com/pay/... em tempo real

Exemplo:

Usuário: Quero assinar o plano mensal
Agent: Ótimo! Aqui está o link de pagamento seguro: [Assinar agora →]
       O link expira em 24 horas.

---

Webhook Customizado

Chame qualquer API externa quando uma intenção for detectada.

Casos de uso:

• Agendar demo no Calendly
• Criar contato no HubSpot
• Disparar automação no n8n ou Zapier
• Consultar disponibilidade de estoque em tempo real

Configuração:

{
  "url": "https://suaapi.com/endpoint",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer {seu_token}"
  },
  "body": {
    "user_email": "{{conversation.user_email}}",
    "message": "{{conversation.last_message}}",
    "agent_id": "{{agent.id}}"
  }
}

As variáveis {{...}} são substituídas em tempo real com dados da conversa.

---

Variáveis disponíveis em Actions

Variável	Descrição
{{conversation.id}}	ID único da conversa
{{conversation.user_email}}	Email coletado (se disponível)
{{conversation.last_message}}	Última mensagem do usuário
{{conversation.transcript}}	Array completo da conversa
{{agent.id}}	ID do agent
{{agent.name}}	Nome do agent
{{session.ip}}	IP do usuário (mascarado se LGPD ativo)
{{session.locale}}	Idioma detectado

---

Encadeamento de Actions

Você pode configurar múltiplas actions que se ativam em sequência:

1. Lead capturado → Salvar no CRM (webhook)
2. Lead no CRM → Enviar email de boas-vindas (Zapier)
3. Usuário pediu pagamento → Gerar link Stripe + salvar lead

Configure a sequência em Actions → Fluxo de ações.

---

Limites

Plano	Actions por conversa	Webhooks customizados
Starter	2	—
Growth	5	3
Agency	Ilimitado	Ilimitado

Captura de lead em detalhe → · Webhook customizado → · API Reference →