Pular para o conteúdo principal

Descrição do esquema JSON

Este documento descreve a estrutura do esquema JSON do módulo Integrations.

Estrutura geral​

O esquema JSON é um array de objetos. Cada objeto é um nó (node) ou uma aba (tab):

[
  {
    "label": "Hello World!",
    "id": "1f24387b252057fe",
    "type": "tab",
    "disabled": false
  },
  {
    "name": "run",
    "id": "b51ab819b83e1915",
    "type": "inject",
    "x": 46.96875,
    "y": 99.51171875,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "bd07e1ff0aedba0b"
      ]
    ]
  },
  {
    "id": "2b524ca59e4ed633",
    "type": "debug",
    "name": "debug",
    "x": 610.05078125,
    "y": 98.59765625,
    "z": "1f24387b252057fe",
    "wires": []
  },
  {
    "name": "function",
    "func": "msg.payload = 'World'\n\nreturn msg;",
    "id": "bd07e1ff0aedba0b",
    "type": "function",
    "x": 229.62890625,
    "y": 98.8515625,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "2e1172b330c69aeb"
      ]
    ]
  },
  {
    "id": "2e1172b330c69aeb",
    "type": "template",
    "name": "template",
    "x": 418.66796875,
    "y": 98.19140625,
    "z": "1f24387b252057fe",
    "syntax": "mustache",
    "template": "Hello {{payload}} !",
    "output": "str",
    "wires": [
      [
        "2b524ca59e4ed633"
      ]
    ]
  }
]

Parâmetros principais dos nós​

A maioria dos nós tem os seguintes parâmetros em comum:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (por exemplo, "inject", "function", "template")
  • name (string) - nome de exibição do nó
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de arrays com os identificadores dos nós aos quais a saída está conectada

Nós do sistema​

Nó "tab" (aba)​

O nó tab é um contêiner para um grupo de nós e aparece na interface como uma aba.

Parâmetros:

  • label (string) - nome de exibição da aba
  • id (string) - identificador único da aba
  • type (string) - tipo do nó (tab)
  • disabled (boolean) - indica se a aba está desativada

Nó "debug" (depuração)​

O nó debug exibe mensagens no painel de depuração.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (debug)
  • name (string) - nome de exibição do nó
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Conexões entre nós​

O parâmetro wires define as conexões entre os nós. Cada elemento do array corresponde a uma saída do nó e contém um array com os identificadores dos nós conectados a essa saída.

Exemplo:

"wires": [
  [
    "bd07e1ff0aedba0b"
  ]
]

Descrição dos parâmetros dos nós​

Nó "inject" (injetor)​

O nó inject cria mensagens e as envia manualmente para o fluxo.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (inject)
  • name (string) - nome de exibição do nó
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "function" (função)​

O nó function permite executar código JavaScript arbitrário.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (function)
  • name (string) - nome do nó
  • func (string) - código a ser executado
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "template" (modelo)​

O nó template transforma mensagens com base em modelos.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (template)
  • name (string) - nome do nó
  • syntax (string) - sintaxe do modelo (mustache ou plain)
  • template (string) - modelo da mensagem
  • output (string) - tipo de saída (str para texto simples, json ou yaml)
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "interval-node" (intervalo)​

O nó interval-node gera mensagens em intervalos de tempo definidos.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (interval-node)
  • name (string) - nome do nó
  • interval (number) - intervalo entre mensagens, em minutos
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "switch" (interruptor)​

O nó switch direciona mensagens por caminhos diferentes de acordo com condições.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (switch)
  • name (string) - nome do nó
  • property (string) - propriedade da mensagem a ser verificada
  • rules (array) - array de regras de roteamento
  • outputs (number) - número de portas de saída
  • checkall (string) - verificar todas as regras (true ou false)
  • repair (boolean) - corrigir mensagens inválidas
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "split" (divisor)​

O nó split divide mensagens em várias partes.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (split)
  • name (string) - nome do nó
  • property (string) - propriedade da mensagem a ser dividida
  • propertyType (string) - tipo da propriedade (msg, flow, global)
  • splt (string) - delimitador para strings
  • spltType (string) - tipo de delimitador (str, bin)
  • arraySplt (number) - tamanho das partes para arrays
  • arraySpltType (string) - tipo de divisão de arrays (len, index)
  • stream (boolean) - processamento em modo streaming
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "http in" (entrada HTTP)​

O nó http in cria endpoints HTTP e recebe requisições HTTP de entrada.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (http in)
  • name (string) - nome do nó (opcional)
  • url (string) - caminho da URL do endpoint
  • method (string) - método HTTP (get, post, put, delete, patch)
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões para processar as requisições

Nó "http request" (requisição HTTP)​

O nó http request faz requisições HTTP de saída.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (http request)
  • name (string) - nome do nó
  • url (string) - URL da requisição
  • method (string) - método HTTP (GET, POST, PUT, DELETE, etc.)
  • ret (string) - formato da resposta (obj, txt, bin)
  • headers (array) - array de cabeçalhos da requisição
  • paytoqs (string) - onde colocar o payload (body, query)
  • useAuth (boolean) - usar autenticação
  • authType (string) - tipo de autenticação (basic, bearer)
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões para processar a resposta

Nó "http response" (resposta HTTP)​

O nó http response envia respostas HTTP ao cliente.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (http response)
  • name (string) - nome do nó
  • statusCode (number) - código de status HTTP da resposta
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões (geralmente vazio)

Nó "cms-events"​

Este nó permite acompanhar eventos do módulo Events e injetá-los no fluxo.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (cms-events)
  • name (string) - nome do nó
  • eventMarker (string) - identificador do evento
  • property (string) - propriedade da mensagem a ser processada
  • targetType (string) - tipo de destino do processamento (msg, flow, global)
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões para o processamento posterior

Nó "admin-api" (Admin API)​

Este nó permite interagir com várias APIs.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (admin-api)
  • name (string) - nome do nó
  • path (string) - caminho do endpoint da API
  • method (string) - método HTTP (post, get, put, delete)
  • operation (string) - identificador da operação
  • data (string) - dados da requisição em formato JSON
  • wires (array) - array de conexões para processar a resposta

Nó "telegram"​

O nó telegram envia mensagens pela Telegram Bot API. Os campos estão descritos em detalhes na página do nó telegram.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (telegram)
  • name (string) - nome do nó
  • botToken (string) - token do bot
  • chatId (string) - identificador do chat
  • text (string) - texto da mensagem
  • parseMode (string) - formato do texto (none, Markdown, MarkdownV2 ou HTML)
  • replyMarkup (array) - linhas de botões Inline; cada botão tem text e callbackData
  • callbackQueryId (string) - identificador da consulta de callback
  • showAlert (boolean) - exibir a notificação em uma janela modal
  • notificationText (string) - texto da notificação (quando showAlert: true)
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "whatsapp"​

O nó whatsapp envia mensagens pela WhatsApp Business Cloud API. Os campos estão descritos em detalhes na página do nó whatsapp.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (whatsapp)
  • name (string) - nome do nó
  • phoneNumberId (string) - identificador do número remetente
  • accessToken (string) - token de acesso
  • apiVersion (string) - versão da Graph API (padrão: v20.0)
  • action (string) - tipo de mensagem (message ou template)
  • to (string) - número do destinatário
  • text (string) - texto da mensagem (quando action: message)
  • templateName (string) - nome do modelo (quando action: template)
  • locale (string) - idioma do modelo (quando action: template)
  • components (array) - parâmetros do modelo; cada um tem type (header ou body), parameter_name e text
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas

Nó "notification"​

O nó notification envia uma notificação com base em um modelo de evento do módulo Events. Os campos estão descritos em detalhes na página do nó notification.

Parâmetros principais:

  • id (string) - identificador único do nó
  • type (string) - tipo do nó (notification)
  • name (string) - nome do nó
  • eventId (number | null) - identificador do modelo de evento
  • variables (object) - valores das variáveis do modelo, indexados pelos seus marcadores
  • recipientsPath (string) - caminho para o array de destinatários na mensagem
  • x, y (number) - coordenadas do nó na área de trabalho
  • z (string) - identificador da aba à qual o nó pertence
  • wires (array) - array de conexões das saídas
Última atualização a