Trigger: Canal Omni

Quando usar

Use este gatilho quando quiser que o workflow reaja a eventos nos canais de atendimento omnichannel. Exemplos comuns:

• Responder automaticamente com uma saudacao quando um novo chat e criado no WhatsApp


• Acionar um chatbot quando uma mensagem de texto e recebida


• Notificar um supervisor quando um chat e atribuido a um agente


• Registrar um log quando uma conversa e finalizada


• Processar apenas mensagens de audio para transcricao automatica

---

Como funciona

Ao adicionar este gatilho, voce escolhe o evento* que deve disparar o workflow e pode filtrar por **tipo de canal**, **canal especifico** e *tipos de mensagem. O Brife monitora todos os canais omnichannel conectados (WhatsApp, Telegram, Instagram) e inicia o fluxo automaticamente quando o evento configurado acontece.

Os dados de saida variam conforme o tipo de evento: eventos de mensagem trazem dados da mensagem e do chat, enquanto eventos de chat trazem dados do chat e do contato.

---

Configuracoes

Evento

Selecione o evento que ira disparar o workflow:

| Evento | Descricao |
|--------|-----------|
| Mensagem Recebida | Dispara quando uma nova mensagem e recebida em um canal. |
| Conversa Criada | Dispara quando um novo chat e iniciado (primeiro contato do cliente). |
| Conversa Finalizada | Dispara quando um chat e encerrado/fechado por um agente ou automaticamente. |
| Conversa Atribuida | Dispara quando um chat e atribuido a um agente de atendimento. |

---

Tipo de Canal

Permite filtrar por plataforma de comunicacao:

| Opcao | Descricao |
|-------|-----------|
| Todos os tipos | O workflow dispara para qualquer canal, independente da plataforma. |
| WhatsApp | Dispara apenas para canais do WhatsApp. |
| Telegram | Dispara apenas para canais do Telegram. |
| Instagram | Dispara apenas para canais do Instagram. |

Ao selecionar um tipo de canal, o filtro de canal especifico e limpo automaticamente.

---

Canal Especifico (opcional)

Permite filtrar por um canal individual. Util quando voce tem varios canais da mesma plataforma e quer que o workflow dispare apenas para um deles.

| Opcao | Descricao |
|-------|-----------|
| Qualquer canal | O workflow dispara para qualquer canal conectado (respeitando o filtro de tipo, se definido). |
| (Canal especifico) | O workflow dispara apenas para o canal selecionado. O tipo de canal e preenchido automaticamente. |

---

Tipos de Mensagem (filtro de tipo de conteudo)

Aparece apenas quando o evento e Mensagem Recebida. Permite filtrar quais tipos de mensagem devem disparar o workflow.

Se nenhum tipo for selecionado, todos os tipos de mensagem disparam o workflow.

| Tipo | Descricao |
|------|-----------|
| Texto | Mensagens de texto simples. |
| Imagem | Fotos e imagens enviadas. |
| Audio | Mensagens de voz e arquivos de audio. |
| Video | Videos enviados pelo contato. |
| Documento | Arquivos (PDF, planilhas, etc.). |
| Sticker | Figurinhas/adesivos. |
| Localizacao | Compartilhamento de localizacao. |
| Contato | Cartao de contato compartilhado. |

Voce pode selecionar multiplos tipos simultaneamente. Os tipos selecionados aparecem como chips abaixo do campo, e podem ser removidos clicando no "X".

---

Dados de saida

Os dados de saida variam conforme o evento selecionado.

Para evento "Mensagem Recebida"

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | Identificador unico da mensagem |
| `chatId` | Texto | Identificador do chat ao qual a mensagem pertence |
| `channelId` | Texto | Identificador do canal onde a mensagem foi recebida |
| `channelType` | Texto | Tipo do canal (whatsapp, telegram, instagram) |
| `direction` | Texto | Direcao da mensagem (inbound/outbound) |
| `type` | Texto | Tipo da mensagem (text, image, audio, video, document, sticker, location, contact) |
| `content` | Texto | Conteudo textual da mensagem |
| `externalId` | Texto | Identificador da mensagem na plataforma de origem |
| `status` | Texto | Status da mensagem |
| `attachment` | Objeto | Dados do anexo (se houver) |
| `attachment.type` | Texto | Tipo do anexo |
| `attachment.url` | Texto | URL do arquivo anexado |
| `attachment.mimeType` | Texto | Tipo MIME do arquivo |
| `attachment.fileName` | Texto | Nome do arquivo |
| `chat` | Objeto | Dados do chat |
| `chat.id` | Texto | ID do chat |
| `chat.status` | Texto | Status do chat |
| `chat.assignedUserId` | Texto | ID do agente atribuido ao chat |
| `chat.unreadCount` | Numero | Quantidade de mensagens nao lidas |
| `chat.contact` | Objeto | Dados do contato |
| `chat.contact.identifier` | Texto | Identificador do contato na plataforma (numero de telefone, username, etc.) |
| `chat.contact.name` | Texto | Nome do contato |
| `chat.contact.picture` | Texto | URL da foto do contato |
| `chat.contact.contactId` | Texto | ID do contato no Brife |
| `createdAt` | Texto | Data e hora de criacao da mensagem |

Para eventos de Chat (Criada, Finalizada, Atribuida)

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | Identificador unico do chat |
| `workspaceId` | Texto | Identificador do workspace |
| `channelId` | Texto | Identificador do canal |
| `channelType` | Texto | Tipo do canal (whatsapp, telegram, instagram) |
| `status` | Texto | Status atual do chat |
| `assignedUserId` | Texto | ID do agente atribuido ao chat |
| `contact` | Objeto | Dados do contato |
| `contact.identifier` | Texto | Identificador do contato na plataforma |
| `contact.name` | Texto | Nome do contato |
| `contact.picture` | Texto | URL da foto do contato |
| `contact.contactId` | Texto | ID do contato no Brife |
| `lastMessageAt` | Texto | Data e hora da ultima mensagem |
| `lastMessagePreview` | Texto | Preview do conteudo da ultima mensagem |
| `unreadCount` | Numero | Quantidade de mensagens nao lidas |
| `createdAt` | Texto | Data de criacao do chat |
| `updatedAt` | Texto | Data da ultima atualizacao do chat |

---

Dicas

• Para chatbots, use o evento Mensagem Recebida* filtrado por tipo *Texto. Isso evita que o bot tente processar imagens, audios ou outros tipos de midia que ele nao consegue interpretar.


• Use o filtro de canal especifico quando tiver fluxos diferentes para cada canal. Exemplo: um workflow para o WhatsApp comercial e outro para o WhatsApp de suporte.


• O evento Conversa Criada e ideal para mensagens de saudacao automatica, pois dispara apenas no primeiro contato, evitando mensagens repetidas.


• Combine o evento Conversa Atribuida com um node de e-mail ou notificacao para alertar o agente que uma nova conversa foi atribuida a ele.


• Para transcricao de audio, filtre o tipo de mensagem por Audio e use os dados de `attachment.url` para enviar o arquivo a um servico de transcricao via webhook.


• O campo `chat.contact.contactId` permite vincular a conversa a um contato ja existente no Brife, facilitando a integracao com outros modulos (projetos, tabelas, etc.).