Visão Geral dos Gatilhos

Um gatilho define de onde vem a mensagem que aciona o seu agente. Cada agente pode ter vários gatilhos ativos ao mesmo tempo — por exemplo, atender na URL Pública, no Telegram e por API simultaneamente, usando o mesmo prompt e as mesmas ferramentas.

Para configurar, abra o agente no painel admin e vá em Gatilhos (no menu lateral do editor de agente).

Tipos de gatilho

• URL Pública — link único squados.io/a/<slug> para qualquer pessoa conversar com o agente sem login. Veja URL Pública e Widget.
• Widget de Site — bolinha de chat embedável em qualquer site externo via snippet. Veja URL Pública e Widget.
• Telegram — bot do Telegram conectado ao agente. Use para testes rápidos em app de mensagem e para automações pessoais. Veja Telegram.
• WhatsApp Oficial (Cloud API) — Cloud API da Meta. Recomendado para produção. Estável, com SLA e limites oficiais. Veja WhatsApp Oficial.
• WhatsApp QR Code — conexão não oficial via QR Code gerenciada pelo próprio SquadOS. Use só para testes — pode desconectar a qualquer momento. Veja WhatsApp.
• WhatsApp via Z-API — conecta o agente a uma instância Z-API que você mantém na conta deles. O SquadOS só usa as credenciais e o webhook. Veja Z-API.
• WhatsApp via Uazapi — conecta a uma instância Uazapi (gerenciada ou self-host). Veja Uazapi.
• WhatsApp via Evolution API — gateway open-source que você roda no seu próprio servidor. Use quando precisa de controle total sobre a infra. Veja Evolution API.
• API (Webhook) — endpoint REST para sistemas externos (n8n, CRM, site próprio) enviarem mensagens ao agente. Veja API (Webhook).
• Agendamentos — dispara o agente em horários definidos (diário, semanal, mensal), com opção de entregar a resposta em outro canal conectado. Veja Agendamento.
• Instagram Direto (DM) — responde DMs de uma conta Instagram Business automaticamente. Feature em beta, disponível só para superadmin. Veja Instagram Direto.
• Instagram Comentários — responde comentários em posts selecionados, com filtros por palavra-chave. Feature em beta, disponível só para superadmin. Veja Instagram Comentários.

O Hub (rota /hub) é o painel onde colaboradores autenticados conversam com os agentes da própria organização. Ele não é um gatilho separado — é o ambiente interno padrão e não precisa de configuração no card de Gatilhos.

Como escolher

• Quer testar um agente novo rápido? Abra o Hub ou conecte ao Telegram.
• Vai atender clientes em escala no WhatsApp? WhatsApp Oficial.
• Quer expor o agente para o público em geral? URL Pública (link direto) ou Widget de Site (embed em página própria).
• Precisa que o agente rode sozinho em um horário? Agendamentos.
• Tem um sistema externo (n8n, CRM, backend próprio) que vai chamar o agente? API (Webhook).

Múltiplos gatilhos no mesmo agente

É comum usar mais de um gatilho ao mesmo tempo. Por exemplo, o mesmo agente pode atender no WhatsApp Oficial para clientes, rodar todo dia às 8h via Agendamento para gerar um relatório interno, e ser chamado por API a partir do seu CRM. Cada canal preserva seu próprio histórico de conversa por contato.