Visão Geral dos Gatilhos

No SquadOS, gatilho é o caminho que inicia ou encaminha uma conversa. Há três caminhos diferentes:

uma mensagem nova entra por uma caixa de entrada;
outro agente transfere uma conversa existente para este agente;
uma automação inicia ou retoma o contato sem esperar uma mensagem nova.

Entender essa separação evita procurar credenciais de canal, transferências e execuções programadas no mesmo lugar.

Caixa de entrada é o ponto de entrada do canal

Cada conexão ou endereço de atendimento vira uma caixa de entrada: por exemplo, um número de WhatsApp, um bot do Telegram, uma conta do Instagram, uma página pública, um widget ou um endpoint da API.

A caixa tem um destino padrão:

Atendimento humano envia a conversa para a equipe responder em Conversas, sem resposta automática de um agente;
Agente de IA encaminha a mensagem ao agente escolhido, com o prompt, o conhecimento e as ferramentas desse agente.

Um agente pode receber conversas de várias caixas. Cada caixa, por sua vez, tem um único destino padrão. Se você ativar uma agenda de atendimento, faixas de horário e exceções podem alternar o responsável entre a equipe e agentes de IA.

Onde visualizar e gerenciar

Abra Caixas de entrada no grupo Agentes do menu administrativo. A rota exige a permissão inboxes.view.

A lista permite buscar por nome, número ou agente e filtrar pelos tipos de canal e destinos existentes na organização. Cada linha mostra Caixa, Destino, Última mensagem e Estado.

Para conectar ou editar uma caixa, alterar o destino, configurar horários ou reconectar um canal, você precisa de inboxes.write. A exclusão exige inboxes.delete. Quem tem somente leitura não vê as ações de alteração.

Veja o fluxo completo em Caixas de entrada.

Canais disponíveis

O catálogo do produto contém onze tipos de caixa:

Grupo	Canal na interface	Função
WhatsApp	WhatsApp	Conexão por QR Code, indicada na própria interface somente para testes. Veja WhatsApp.
WhatsApp	WhatsApp Oficial	Cloud API da Meta com número verificado. Veja WhatsApp Oficial.
WhatsApp	WhatsApp (Z-API)	Usa uma conta Z-API própria. Veja Z-API.
WhatsApp	WhatsApp (UAZAPI)	Usa uma instância UAZAPI própria. Veja UAZAPI.
WhatsApp	WhatsApp (Evolution)	Usa uma instância Evolution API própria. Veja Evolution API.
Instagram	Instagram Direct	Recebe mensagens diretas de uma conta Business. Veja Instagram Direct.
Instagram	Instagram Comentários	Recebe comentários de posts conforme a configuração de palavras-chave. A opção está restrita à conta de teste enquanto a permissão da Meta permanece em análise. Veja Instagram Comentários.
Outros	Telegram	Recebe mensagens de um bot criado com o BotFather. Veja Telegram.
Outros	Página pública	Cria uma página de chat com endereço próprio. Veja Página pública e Widget.
Outros	Widget	Gera o código de instalação de uma bolha de chat para um site. Veja Página pública e Widget.
Outros	API	Cria um endpoint REST para integração com outro sistema. Veja API (Webhook).

Por causa da análise da Meta, uma organização comum vê dez opções no seletor; Instagram Comentários continua no catálogo, mas não aparece para contas comuns até a aprovação.

Como conectar uma caixa

Com inboxes.write, selecione Conectar caixa de entrada e siga a ordem apresentada:

escolha o canal;
para WhatsApp, Instagram ou Telegram, conclua primeiro a conexão ou credencial do provedor;
escolha Atendimento humano ou um Agente de IA como destino padrão;
confirme ou altere o nome sugerido para a caixa;
para Página pública ou Widget, conclua também a configuração própria do endereço ou domínio;
finalize a criação e, se necessário, abra a configuração separada da agenda de atendimento.

API, Página pública e Widget são canais próprios do SquadOS e não passam por uma etapa de conexão com provedor. A API termina depois do destino e do nome; Página pública e Widget ainda pedem suas configurações específicas.

O mesmo número ou identidade externa não pode permanecer ativo em duas caixas. Se a interface informar que a identidade já está em uso, localize a caixa existente e desconecte-a antes de tentar novamente.

O que aparece no editor do agente

No editor, abra Caixas de Entrada — o nome da seção no menu do agente — para conferir como as conversas chegam àquele agente.

O cartão Caixas de entrada lista as caixas cujo destino padrão é esse agente, com tipo de canal, prazo de encerramento automático, estado da conexão e, quando habilitada, a avaliação de satisfação. O link Gerenciar caixas de entrada abre a lista administrativa.

Se você tiver ao mesmo tempo inboxes.write e agents.write, o cartão também mostra Conectar caixa. Esse atalho abre o fluxo de conexão com o agente atual já selecionado como destino. Sem as duas permissões, o cartão funciona como consulta.

Transferências entre agentes

O cartão Agentes que transferem lista agentes que possuem a ferramenta Transferir Conversa apontada para o agente atual.

Nesse caso, a conversa já existe e chega por transferência, sem criar uma nova entrada de canal. Para mudar esse vínculo, edite a ferramenta no agente de origem.

Execução autônoma

Follow-up de quem parou de responder, envio em horário marcado e sequências de mensagens pertencem a Automações. O cartão de execução autônoma no editor é apenas um atalho para essa área.

Em uma automação, você escolhe o gatilho, as condições e quem recebe a ação. Veja Visão geral de Automações antes de ativar um fluxo.

Mapa rápido de decisão

Quer receber mensagens de WhatsApp, Instagram ou Telegram? Crie uma caixa de entrada e conecte o provedor.
Quer oferecer um chat por link, site ou integração própria? Use Página pública, Widget ou API.
Quer que uma equipe responda sem IA? Escolha Atendimento humano como destino.
Quer reutilizar o mesmo agente em mais de um canal? Aponte várias caixas para esse agente.
Quer passar uma conversa já iniciada de um agente para outro? Configure Transferir Conversa no agente de origem.
Quer iniciar ou retomar mensagens sem uma nova entrada do cliente? Crie uma automação.