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 paraA equipe recebeEspaço de destino
SM: PublicaçãoTem job pronto pra agendamento!Equipe de social media
ATEN: Aprovação ClienteTem 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
  1. Webhook recebe o POST do Operand sempre que um job é atualizado.
  2. 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.
  3. 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.
  4. Ler Configurações lê a data table uma vez. O nó Config reúne os parâmetros do fluxo.
  5. Status notificável? deixa passar só os status cadastrados em destinos. Os demais param aqui, sem chamar a API.
  6. Ler Token Cache e Buscar Job na API Operand buscam os dados completos do job com o token salvo.
  7. 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çãoEndpoint
Abrir uma sessãoGET /v1/login
Consultar um jobGET /v1/jobs/{jobId}

Antes de começar

Tenha estes itens em mãos antes de importar o fluxo:

ItemPara que serveOnde conseguir
Instância do n8n publicadaReceber o webhook por uma URL públican8n Cloud ou servidor próprio
Arquivo .json do fluxoImportar o fluxo prontoLink no início deste guia
Token de acesso da API do OperandBuscar os dados do jobPessoa administradora da conta Operand
Permissão para criar webhooks no OperandCadastrar a URL do n8nConfigurações de integrações do Operand
Webhook de entrada da ferramenta de chatReceber as mensagens no espaço certoGoogle Chat, Slack, Discord etc.
IDs dos status que vão notificarDefinir quando a mensagem é enviadaConfiguraçã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 .json do fluxo
  • Criar as credentials [OPERAND] API token e [OPERAND] Webhook hash
  • Criar a data table OPERAND API com 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

CredentialTipoUsada no nóPreenchimento
[OPERAND] API tokenQuery AuthLogin OperandName: tokenAccess · Value: token de acesso da API do Operand
[OPERAND] Webhook hashCryptoCalcular HMACSegredo 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).

keyvalueQuem preenche
operand_api_tokenToken de sessão da APIO próprio fluxo, na primeira execução
google_chat_agendamentoURL do webhook do espaço de agendamentoVocê
google_chat_aprovacaoURL do webhook do espaço de aprovaçãoVocê

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.

CampoO que defineValor padrão
apiUrlEndereço da API do Operandhttps://api.operand.app/v1
appUrlBase do link do job na mensagem (/jobs/)https://app4.operand.com.br
destinosStatus notificados, título da mensagem e linha da data table com a URLVer 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 coluna key na data table onde está a URL do espaço.

Notificar um novo status

  1. Descubra o ID do status no Operand.
  2. Crie o webhook de entrada no espaço de chat que vai receber as mensagens.
  3. Adicione uma linha na data table, por exemplo google_chat_finalizado, com a URL.
  4. 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çãoOnde fica
Segredos (token, hash)Credentials do n8n
URLs e token em cacheData table OPERAND API
Regras do fluxoNó 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

  1. 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 campo chave em destinos.
  2. 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.
  3. Formatação: adapte negrito e links à sintaxe de cada ferramenta.

Formato da mensagem por ferramenta

FerramentaOnde criar o webhookCampo do textoNegritoLink
Google ChatEspaço > Apps e integrações > Webhookstext*texto*<url|texto>
SlackApp do Slack com Incoming Webhooks ativadotext*texto*<url|texto>
DiscordCanal > Editar canal > Integrações > Webhookscontent**texto**URL direta ou [texto](url)
Microsoft TeamsWorkflows do Teams (fluxo de recebimento por webhook)Depende do fluxo criadoMarkdown[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

  1. Com o fluxo ativo, mude um job no Operand para cada status configurado.
  2. Confira se a mensagem chegou no espaço certo, com o título e o link corretos.
  3. Mude o mesmo job para um status fora de destinos. Nenhuma mensagem deve chegar.
  4. 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

ChamadaSucessoOnde o fluxo lê o resultado
LoginHTTP 200Token no campo Op-Auth-Token
Consultar jobHTTP 200, meta.status = SUCCESSJob em records (objeto, com id, title e statusId)

Token ausente, inválido ou expirado responde HTTP 401. Job inexistente responde HTTP 404.

Erros comuns

SintomaCausa provávelComo resolver
Fluxo para em Assinatura válida?Segredo HMAC diferente do configurado no OperandCopie de novo o hash do webhook do Operand para a credential
Nenhuma execução aparece no n8nWebhook cadastrado com a URL de teste ou fluxo inativoAtive o fluxo e use a URL de produção /webhook/...
Fluxo para em Status notificável?ID do status não está em destinosConfira o ID no Operand e adicione a entrada
Erro em Enviar para Google ChatLinha indicada em chave não existe na data tableCrie a linha com a key exata e a URL no value
Erro nos nós da data tableTabela não selecionada após importarSelecione OPERAND API nos 3 nós
Login falhaToken de acesso inválido ou campo erradoRevise 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.


Did this page help you?