Enviar notificações do Operand para Google Chat, Slack e Discord
Integração com n8n: quando um job muda para um status escolhido, a equipe recebe uma mensagem no espaço certo do chat.
Com o n8n, você conecta o webhook de atualização de job do Operand a qualquer ferramenta de chat. Quando um job muda para um status escolhido, o fluxo busca os dados do job na API e envia uma mensagem para o espaço certo da equipe.
O exemplo deste guia usa o Google Chat. A mesma lógica funciona com Slack, Discord, Microsoft Teams ou qualquer ferramenta que receba mensagens por webhook.
Baixe aqui o arquivo pronto com o fluxo descrito abaixo
Exemplo prático:
| Quando o job muda para | A equipe recebe | Espaço de destino |
|---|---|---|
| SM: Publicação | Tem job pronto pra agendamento! | Equipe de social media |
| ATEN: Aprovação Cliente | Tem job pronto pra aprovar com cliente! | Equipe de atendimento |
O que você aprenderá
- Como o fluxo funciona, etapa por etapa
- O que preparar antes de instalar
- Como instalar e configurar o fluxo no n8n
- Como escolher quais status geram notificação
- Como adaptar o envio para Slack, Discord e outras ferramentas
- Como testar e resolver erros comuns
Como funciona o fluxo
O fluxo só envia mensagem quando três condições são verdadeiras: a requisição é legítima, o status realmente mudou e o novo status está na lista de notificação.
flowchart TD
A[Webhook de atualização de job do Operand] --> B{Assinatura HMAC válida?}
B -- Não --> Z[Fim]
B -- Sim --> C{Status mudou?}
C -- Não --> Z
C -- Sim --> D{Status notificável?}
D -- Não --> Z
D -- Sim --> E[Buscar job na API]
E -- 401 --> F[Login e salvar token] --> E
E -- 200 --> G[Enviar mensagem ao chat]
E -- Outro erro --> Z
- Webhook recebe o POST do Operand sempre que um job é atualizado.
- Calcular HMAC e Assinatura válida? conferem se a requisição veio mesmo do Operand, comparando a assinatura calculada com o header
x-webhook-signature. Assinatura inválida encerra o fluxo. - Ler status anterior e Foi alterado status? guardam o último status de cada job. O fluxo só segue se o status mudou. Edições de prazo ou descrição, por exemplo, não geram mensagem.
- Ler Configurações lê a data table uma vez. O nó Config reúne os parâmetros do fluxo.
- Status notificável? deixa passar só os status cadastrados em
destinos. Os demais param aqui, sem chamar a API. - Ler Token Cache e Buscar Job na API Operand buscam os dados completos do job com o token salvo.
- Resposta da API decide o próximo passo:
- HTTP 401 (token inválido ou expirado): faz Login Operand, salva o novo token em Salvar Token Cache e busca o job de novo, uma única vez por execução.
- Job encontrado (HTTP 200,
meta.status = SUCCESS): Enviar para Google Chat monta a mensagem com o título e a URL do espaço daquele status. - Outro erro (job inexistente com HTTP 404,
EXCEPTION, falha do servidor): encerra sem enviar mensagem.
Por que o fluxo é montado assim
- Segurança: a assinatura HMAC impede que terceiros disparem mensagens falsas.
- Sem ruído: só mudanças de status relevantes viram notificação.
- Menos chamadas à API: o filtro de status vem antes da busca, e o token fica em cache.
- Manutenção simples: URLs ficam na data table e regras no nó Config. Não é preciso mexer na lógica para trocar destinos.
Endpoints usados
| Operação | Endpoint |
|---|---|
| Abrir uma sessão | GET /v1/login |
| Consultar um job | GET /v1/jobs/{jobId} |
Antes de começar
Tenha estes itens em mãos antes de importar o fluxo:
| Item | Para que serve | Onde conseguir |
|---|---|---|
| Instância do n8n publicada | Receber o webhook por uma URL pública | n8n Cloud ou servidor próprio |
Arquivo .json do fluxo | Importar o fluxo pronto | Link no início deste guia |
| Token de acesso da API do Operand | Buscar os dados do job | Pessoa administradora da conta Operand |
| Permissão para criar webhooks no Operand | Cadastrar a URL do n8n | Configurações de integrações do Operand |
| Webhook de entrada da ferramenta de chat | Receber as mensagens no espaço certo | Google Chat, Slack, Discord etc. |
| IDs dos status que vão notificar | Definir quando a mensagem é enviada | Configuração de status de job no Operand ou Listar status de um tipo de documento |
Antes de instalar, combine com a equipe quais status merecem notificação. Poucos status bem escolhidos evitam que o canal vire ruído.
Passo a passo de instalação
Checklist
- Importar o arquivo
.jsondo fluxo - Criar as credentials
[OPERAND] API tokene[OPERAND] Webhook hash - Criar a data table
OPERAND APIcom as URLs do chat - Selecionar a data table nos 3 nós que a utilizam
- Revisar os valores do nó Config
- Ativar o fluxo
- Cadastrar a URL de produção do webhook no Operand
- Testar um job em cada status
1. Importe o fluxo
No n8n, crie um novo workflow e importe o arquivo .json. O n8n vai sinalizar os nós sem credential configurada. Isso é esperado.
2. Crie as credentials
| Credential | Tipo | Usada no nó | Preenchimento |
|---|---|---|---|
[OPERAND] API token | Query Auth | Login Operand | Name: tokenAccess · Value: token de acesso da API do Operand |
[OPERAND] Webhook hash | Crypto | Calcular HMAC | Segredo HMAC copiado do webhook criado no Operand |
Os nomes são sugestões. O importante é selecionar cada credential no nó certo.
O segredo HMAC precisa ser idêntico ao do webhook no Operand. Se for diferente, todas as requisições serão descartadas como assinatura inválida.
3. Crie a data table OPERAND API
A tabela funciona no formato chave e valor. Ela guarda o cache do token e as URLs dos espaços de chat. Colunas: key (string) e value (string).
| key | value | Quem preenche |
|---|---|---|
operand_api_token | Token de sessão da API | O próprio fluxo, na primeira execução |
google_chat_agendamento | URL do webhook do espaço de agendamento | Você |
google_chat_aprovacao | URL do webhook do espaço de aprovação | Você |
No Google Chat, a URL fica em Apps e integrações > Webhooks > Adicionar webhook e segue o formato:
https://chat.googleapis.com/v1/spaces/:espaço/messages?key=:key&token=:token
4. Selecione a data table nos nós
O ID da data table muda a cada servidor. Abra cada nó abaixo e selecione OPERAND API em Parameters > Data table:
- Ler Configurações
- Ler Token Cache
- Salvar Token Cache
5. Revise o nó Config e ative o fluxo
Confira os campos do nó Config (detalhes na próxima seção) e ative o fluxo.
6. Cadastre o webhook no Operand
Com o fluxo ativo, cadastre no Operand um webhook de atualização de job apontando para a URL de produção:
https://SEU-N8N/webhook/notificar-google-chat-atualizar-status-job
Depois de criar, copie o hash gerado pelo Operand e cole na credential [OPERAND] Webhook hash.
Configurações e personalização
Todos os parâmetros ficam no nó Config. Para mudar o comportamento do fluxo, edite só esse nó e a data table.
| Campo | O que define | Valor padrão |
|---|---|---|
apiUrl | Endereço da API do Operand | https://api.operand.app/v1 |
appUrl | Base do link do job na mensagem (/jobs/) | https://app4.operand.com.br |
destinos | Status notificados, título da mensagem e linha da data table com a URL | Ver abaixo |
Campo destinos
Cada chave é o ID do status do job no Operand:
{
"37": {
"titulo": "Tem job pronto pra agendamento!",
"chave": "google_chat_agendamento"
},
"9": {
"titulo": "Tem job pronto pra aprovar com cliente!",
"chave": "google_chat_aprovacao"
}
}titulo: texto em negrito no início da mensagem.chave: valor da colunakeyna data table onde está a URL do espaço.
Notificar um novo status
- Descubra o ID do status no Operand.
- Crie o webhook de entrada no espaço de chat que vai receber as mensagens.
- Adicione uma linha na data table, por exemplo
google_chat_finalizado, com a URL. - Adicione a entrada em
destinos:
"12": {
"titulo": "Job finalizado!",
"chave": "google_chat_finalizado"
}Nenhum outro nó precisa ser alterado. Para parar de notificar, remova a entrada.
Trocar o espaço de destino
Edite a coluna value da linha correspondente na data table. O fluxo não precisa ser alterado.
Ao importar uma nova versão do fluxo, o nó Config volta aos valores do arquivo. Anote suas alterações antes de atualizar. As URLs não são afetadas, porque ficam na data table.
Onde cada informação fica
| Tipo de informação | Onde fica |
|---|---|
| Segredos (token, hash) | Credentials do n8n |
| URLs e token em cache | Data table OPERAND API |
| Regras do fluxo | Nó Config |
O fluxo não depende de variáveis de ambiente nem do recurso Variables do n8n.
Adaptar para Slack, Discord e outros
Só o último nó muda. Toda a lógica anterior (assinatura, mudança de status, filtro e busca na API) continua igual para qualquer ferramenta.
O que ajustar
- Data table: troque as URLs do Google Chat pelas URLs de webhook da nova ferramenta. Se quiser, renomeie as chaves, por exemplo
slack_agendamento, e atualize o campochaveemdestinos. - Nó de envio: ajuste o corpo (body) JSON do nó Enviar para Google Chat para o formato que a nova ferramenta espera. Renomeie o nó para refletir o destino.
- Formatação: adapte negrito e links à sintaxe de cada ferramenta.
Formato da mensagem por ferramenta
| Ferramenta | Onde criar o webhook | Campo do texto | Negrito | Link |
|---|---|---|---|---|
| Google Chat | Espaço > Apps e integrações > Webhooks | text | *texto* | <url|texto> |
| Slack | App do Slack com Incoming Webhooks ativado | text | *texto* | <url|texto> |
| Discord | Canal > Editar canal > Integrações > Webhooks | content | **texto** | URL direta ou [texto](url) |
| Microsoft Teams | Workflows do Teams (fluxo de recebimento por webhook) | Depende do fluxo criado | Markdown | [texto](url) |
Exemplos de corpo JSON
Nos exemplos, troque {{titulo}}, {{nomeDoJob}} e {{linkDoJob}} pelas expressões que o nó de envio do seu fluxo já usa.
{ "text": "*{{titulo}}*\n<{{linkDoJob}}|{{nomeDoJob}}>" }{ "text": "*{{titulo}}*\n<{{linkDoJob}}|{{nomeDoJob}}>" }{ "content": "**{{titulo}}**\n[{{nomeDoJob}}]({{linkDoJob}})" }Enviar para mais de uma ferramenta
Para avisar o Google Chat e o Slack ao mesmo tempo, duplique o nó de envio e ligue as duas cópias à saída Job encontrado. Use chaves diferentes na data table para cada ferramenta.
O n8n também tem nós nativos de Slack, Discord e Microsoft Teams. Eles funcionam bem, mas exigem credential própria. O webhook de entrada costuma ser o caminho mais simples, porque só precisa da URL.
Testes, erros comuns e perguntas frequentes
Como testar
- Com o fluxo ativo, mude um job no Operand para cada status configurado.
- Confira se a mensagem chegou no espaço certo, com o título e o link corretos.
- Mude o mesmo job para um status fora de
destinos. Nenhuma mensagem deve chegar. - Consulte a aba Executions do n8n para ver onde cada execução parou.
O último status de cada job fica salvo em static data, que só é gravado em execuções de produção (fluxo ativo, chamado pela URL
/webhook/...). Em testes manuais pelo editor, todo disparo é tratado como mudança de status.
Respostas que o fluxo espera da API
| Chamada | Sucesso | Onde o fluxo lê o resultado |
|---|---|---|
| Login | HTTP 200 | Token no campo Op-Auth-Token |
| Consultar job | HTTP 200, meta.status = SUCCESS | Job em records (objeto, com id, title e statusId) |
Token ausente, inválido ou expirado responde HTTP 401. Job inexistente responde HTTP 404.
Erros comuns
| Sintoma | Causa provável | Como resolver |
|---|---|---|
| Fluxo para em Assinatura válida? | Segredo HMAC diferente do configurado no Operand | Copie de novo o hash do webhook do Operand para a credential |
| Nenhuma execução aparece no n8n | Webhook cadastrado com a URL de teste ou fluxo inativo | Ative o fluxo e use a URL de produção /webhook/... |
| Fluxo para em Status notificável? | ID do status não está em destinos | Confira o ID no Operand e adicione a entrada |
| Erro em Enviar para Google Chat | Linha indicada em chave não existe na data table | Crie a linha com a key exata e a URL no value |
| Erro nos nós da data table | Tabela não selecionada após importar | Selecione OPERAND API nos 3 nós |
| Login falha | Token de acesso inválido ou campo errado | Revise a credential: Name tokenAccess e o token correto |
Perguntas frequentes
Preciso criar a linha operand_api_token? Não. O fluxo faz login na primeira execução e cria a linha sozinho.
Mudar o prazo de um job gera notificação? Não. O fluxo só avança quando o status muda.
Posso usar o mesmo espaço para vários status? Sim. Aponte várias entradas de destinos para a mesma chave.
O que acontece se o token expirar? A API responde 401, o fluxo faz login de novo, salva o novo token e repete a busca uma vez.
De onde vem o token no login? O fluxo espera o token no campo Op-Auth-Token da resposta de login.
Updated 25 days ago

