Visão Geral dos Gatilhos
Um agente do SquadOS só trabalha quando alguém fala com ele. Este guia responde de onde vem essa conversa — e a resposta, hoje, é quase sempre a mesma: de uma caixa de entrada.
Caixa de entrada é o canal conectado
Section titled “Caixa de entrada é o canal conectado”Cada canal que você conecta vira uma caixa de entrada: um número de WhatsApp, um bot do Telegram, uma página pública, um widget instalado no seu site, um endpoint da API. A caixa guarda a credencial daquele canal e aponta para quem atende.
Tudo isso mora em Caixas de Entrada, no menu lateral do painel.
Duas coisas importantes decorrem desse modelo:
- Um agente pode ter várias caixas. O mesmo agente atende no WhatsApp Oficial, no Telegram e numa página pública ao mesmo tempo, com o mesmo prompt e as mesmas ferramentas. Cada canal preserva o próprio histórico por contato.
- Uma caixa não precisa de agente. O destino pode ser atendimento humano: a mensagem entra normalmente e um operador responde pela tela de Conversas, sem IA no meio.
Para conectar, editar, pausar e excluir caixas, veja Caixas de entrada.
Canais disponíveis
Section titled “Canais disponíveis”| Canal | Para que serve |
|---|---|
| WhatsApp Oficial | Cloud API da Meta, com número verificado. Recomendado para produção. Veja WhatsApp Oficial. |
| WhatsApp (QR Code) | Conexão por leitura de QR Code, gerenciada pelo próprio SquadOS. Use para testes — pode desconectar a qualquer momento. Veja WhatsApp. |
| WhatsApp (Z-API) | Usa a sua conta na Z-API. Veja Z-API. |
| WhatsApp (UAZAPI) | Usa a sua conta na Uazapi, gerenciada ou self-host. Veja Uazapi. |
| WhatsApp (Evolution) | Usa a sua instância da Evolution API, no seu próprio servidor. Veja Evolution API. |
| Instagram Direct | Responde mensagens diretas de uma conta Business. Veja Instagram Direct. |
| Instagram Comentários | Responde comentários em posts, com filtro por palavra-chave. Ainda em análise pela Meta. Veja Instagram Comentários. |
| Telegram | Bot criado no @BotFather. Ótimo para testar um agente novo rápido. Veja Telegram. |
| Página pública | Uma página de chat com endereço próprio (app.squados.io/a/<endereço>), para compartilhar onde você quiser. Veja Página pública e Widget. |
| Widget | Uma bolha de chat instalada no seu site, com um trecho de código. Veja Página pública e Widget. |
| API | Endpoint REST para integrar qualquer sistema — n8n, Make, CRM, backend próprio. Veja API (Webhook). |
O que o editor do agente mostra
Section titled “O que o editor do agente mostra”Nenhum canal é configurado dentro do agente. A seção Caixas de Entrada do editor é uma vista de leitura: ela responde “por onde as conversas chegam neste agente?” e leva você até a tela de Caixas de entrada para mudar qualquer coisa.
Logo abaixo, a mesma seção mostra os outros dois caminhos de entrada:
- Agentes que transferem — outros agentes da organização com a ferramenta Transferir Conversa apontada para este. A conversa chega vinda deles, sem passar por caixa nenhuma.
- Execução autônoma — o agente agindo sozinho (retomar quem parou de responder, enviar na hora marcada, disparar sequências). Isso não se configura no agente: monta-se em Automações, escolhendo gatilho, condições e quem recebe.
Como escolher
Section titled “Como escolher”- Testar um agente novo rápido? Conecte um Telegram, ou use o Hub — os agentes ativos já aparecem lá para os membros da organização, sem configurar nada.
- Atender clientes em escala no WhatsApp? WhatsApp Oficial.
- Expor o agente para o público? Página pública (link direto) ou Widget (embed no seu site).
- Chamar o agente a partir de um sistema seu? API.
- Quer uma fila só de gente, sem IA? Conecte o canal e escolha atendimento humano como destino.