Mensageria (chat, SMS e e-mail)

Quando o fluxo precisa falar com uma pessoa, use um destes nós. Todos ficam no grupo Comunicação da paleta do editor, ao lado do Enviar e-mail por SMTP.

Cada nó envia uma mensagem por item: se a etapa anterior trouxe trinta linhas, saem trinta mensagens, uma para cada destinatário.

O que vale para todos

• Escolha a credencial no topo do nó. Cada serviço tem a sua — o que você precisa obter em cada um está descrito na seção do nó.
• Todo campo de texto aceita {{ … }} com dados do item, então o mesmo nó atende um lote inteiro (um telefone por item, por exemplo).
• Todos têm uma saída (main) e acrescentam ao item um campo com a resposta do serviço — indicado em cada seção abaixo.
• Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item, o padrão, ou Substituir item). WhatsApp, Slack, Telegram, Mailgun e Postmark têm também Processamento paralelo, que dispara vários itens ao mesmo tempo mantendo a ordem da saída — veja Ajustes do nó.
• Com o Processamento paralelo ligado, uma recusa do serviço vira _erro no item e o lote segue — dá para tratar o caso com um IF. Com ele desligado, vale o Em caso de erro da aba Config.

Anexos: aqui o arquivo vai por link

Os nós de e-mail do NEXUS Flow (Enviar e-mail) anexam o arquivo que viaja junto do item, sob o nome da propriedade binária. Os nós desta página não fazem isso: quando aceitam arquivo — mídia do WhatsApp, foto e documento do Telegram, imagem do Discord, mídia da Twilio —, o campo pede uma URL pública, e é o próprio serviço que baixa o arquivo desse endereço.

Ou seja: para mandar por WhatsApp o PDF que o RM — Gerar Relatório produziu, publique-o antes num endereço que o serviço alcance (o Google Drive — Compartilhamento resolve isso) e informe esse link aqui. Um arquivo que só existe dentro do item não chega ao destinatário por estes nós.

WhatsApp — Enviar mensagem

Envia pela Cloud API do WhatsApp Business. Em O que enviar:

Número do destinatário é obrigatório e vai com o código do país; pontuação e o sinal de mais são removidos automaticamente.

No texto livre você escreve a Mensagem e decide se quer Mostrar prévia do link.

No template, informe o Nome do template exatamente como aprovado no Gerenciador de Negócios da Meta, o Idioma do template (padrão pt_BR) e os Valores do corpo (um por linha) — a ordem importa: a primeira linha substitui o primeiro espaço do texto, a segunda o segundo, e assim por diante. Para templates com cabeçalho ou botões há Componentes completos (JSON), que, preenchido, substitui os valores do corpo.

Na mídia, escolha o Tipo de mídia (Imagem, Documento, Vídeo ou Áudio), informe a URL do arquivo e, se quiser, a Legenda — aceita em imagem, vídeo e documento, não em áudio — e o Nome do arquivo mostrado ao destinatário, que vale só para documento.

Fora da janela de 24 horas desde a última resposta do contato, a Meta entrega apenas template aprovado e recusa o resto. A recusa chega inteira no _erro do item, para o fluxo poder decidir — por exemplo, cair num IF e reenviar como template.

Sai o item com _whatsapp, incluindo o identificador da mensagem criada.

Para cadastrar a credencial você precisa, no Gerenciador de Negócios da Meta, do ID do número de telefone e de um token de acesso do aplicativo do WhatsApp Business. A versão da API tem um padrão e raramente precisa mudar.

Slack — Enviar mensagem

Três operações:

O Canal aceita o identificador (C01ABCDEF) ou o nome com cerquilha (#avisos). Em Blocos (JSON) você pode montar o layout do Block Kit; com blocos, a mensagem escrita acima vira o texto que aparece na notificação.

Responder é o mesmo envio, com o Carimbo da mensagem original — que sai em _slack.ts do envio anterior, pronto para encadear. Marque Mostrar a resposta também no canal quando a resposta precisar aparecer fora da conversa.

Em Listar canais, o Trazer escolhe entre Canais públicos, Canais privados ou Públicos e privados; o Máximo de canais tem padrão 200. A listagem emite um item por canal.

Sai, nos envios, o item com _slack — o carimbo (ts), o canal e a mensagem criada.

O bot precisa estar no canal para escrever nele; num canal privado ele só enxerga o que foi convidado a ver. Quando faltar isso, a recusa do Slack vem explicada no _erro do item.

Para cadastrar a credencial você precisa do token do bot (começa com xoxb-), gerado ao instalar um aplicativo do Slack no seu espaço de trabalho.

Telegram — Enviar mensagem

Envia por um bot. Em O que enviar: Mensagem de texto, Responder a uma mensagem, Foto por URL ou Documento por URL.

Conversa é obrigatório e aceita o identificador numérico da conversa ou o nome do canal com arroba (@avisos).

Nas opções de texto, escreva a Mensagem; para responder, informe também a Mensagem a responder (o identificador da mensagem original, que sai em _telegram.message_id). Em foto e documento, informe a URL do arquivo e, se quiser, a Legenda.

Valem para todas as operações:

Sai o item com _telegram, com a mensagem criada.

O bot só escreve para quem já falou com ele, ou para o grupo/canal em que foi adicionado como administrador — não há como iniciar conversa com um número.

Para cadastrar a credencial você precisa do token do bot, fornecido pelo BotFather do Telegram ao criar o bot.

Discord — Enviar

Publica num canal. Em O que enviar: Mensagem de texto ou Cartão (embed).

O ID do canal é necessário quando a credencial usa token de bot; no modo webhook o canal já vem do próprio endereço cadastrado e o campo é ignorado.

A Mensagem vale nas duas operações — no cartão, é o texto que aparece acima dele. O cartão tem ainda Título do cartão, Descrição do cartão, Link do título, Cor da faixa lateral, Imagem do cartão e Campos adicionais do cartão (JSON), que é mesclado ao cartão e vence os campos preenchidos acima.

O nó confere os limites de tamanho do Discord antes de gastar a chamada e avisa, com o número de caracteres, quando o texto ou a descrição do cartão passam do permitido. Encurte o texto ou divida em mais de uma mensagem.

Sai o item com _discord, com a resposta do Discord — inclusive o identificador da mensagem criada.

Para cadastrar a credencial escolha a forma de envio: Webhook, e aí basta o endereço de webhook criado nas configurações do canal — serve só para enviar mensagem —, ou Bot, com o token do aplicativo, que permite mais operações.

Twilio — Enviar

Envia SMS ou WhatsApp pela Twilio. O Canal escolhe entre SMS e WhatsApp; os campos são os mesmos nos dois.

Escreva os telefones no formato internacional (+5551999999999), sem prefixo de canal: o nó acrescenta o que o WhatsApp exige.

Sai o item com _twilio, com o registro criado — inclusive a situação do envio.

Para cadastrar a credencial você precisa do Account SID e do Auth Token do painel da Twilio, e pode guardar ali o número remetente padrão.

Rocket.Chat — Enviar

Envia para o seu servidor Rocket.Chat. O Destino é obrigatório e endereça os dois casos, como no próprio Rocket.Chat: #canal para um canal e @usuario para uma conversa direta.

Uma mensagem pode ter só anexos, sem texto — mas não pode ficar sem os dois.

Sai o item com _rocketchat, com a mensagem criada.

Para cadastrar a credencial você precisa da URL do seu servidor e de um User ID com Auth Token, gerados no perfil da conta de integração dentro do Rocket.Chat.

Mailgun — Enviar e-mail

Envia um e-mail por item, em texto, HTML ou nos dois.

Escreva ao menos um dos dois corpos — texto ou HTML.

Sai o item com _email, trazendo o identificador que o Mailgun devolveu, útil para casar depois com os relatórios de entrega.

Para cadastrar a credencial você precisa da chave de API e do domínio verificado no Mailgun, e escolhe a região da conta (Estados Unidos ou Europa). O remetente padrão é opcional.

Postmark — Enviar e-mail

Envia um e-mail por item, com a mensagem escrita aqui ou a partir de um modelo cadastrado no Postmark.

Destinatários valem nas duas operações: Remetente (em branco usa o padrão da credencial, e precisa ser um endereço verificado no Postmark), Para (obrigatório, vários separados por vírgula), Com cópia, Com cópia oculta e Responder para.

Escrevendo aqui, preencha Assunto, Mensagem em texto e Mensagem em HTML — ao menos um dos dois corpos.

Usando modelo, informe o Modelo (o número ou o apelido cadastrado no Postmark) e os Valores do modelo (JSON), que preenchem as variáveis do modelo e aceitam {{ … }} com dados do item.

Dois campos valem sempre: Etiqueta, que agrupa os envios nos relatórios do Postmark, e Fluxo de mensagens, o nome do stream — deixe outbound para e-mails transacionais.

Sai o item com _email, com o identificador da mensagem, a data de envio e o destinatário.

O Postmark às vezes recusa uma mensagem respondendo como se tivesse aceitado. O nó reconhece esse caso e marca _erro no item, em vez de dá-lo por enviado.

Para cadastrar a credencial você precisa do Server Token do servidor correspondente no painel do Postmark, e pode guardar ali o remetente padrão.

Veja também: Credenciais, Ações e Ajustes do nó.