Para Desenvolvedores/Conteúdo Dinâmico/Mensagens - Formatos/Actions - Formatos

Actions - Formatos

actionsA propriedade da resposta do servidor é opcional.

2026-08-11

Ação adicionar tag

haUse esta resposta para adicionar uma tag a um assinante. Tag com o mesmo nome deve existir no seu bot:

texto

{
  "version": "v1",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://NicoChat.com.au"
          }
        ]
      }
    ],
    "actions": [
      {
        "action": "add_tag",
        "tag_name": "your tag",
      }
    ],
    "quick_replies": []
  }
}

Nome da tag enviado usandotag_name o parâmetro deve corresponder a uma das tags existentes no bot NicoChat

Ação remover tag

Use esta resposta para remover uma tag de um assinante. Tag com o mesmo nome deve existir no seu bot:

texto

{
  "version": "v1",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://NicoChat.com.au"
          }
        ]
      }
    ],
    "actions": [
      {
        "action": "remove_tag",
        "tag_name": "your tag",
      }
    ],
    "quick_replies": []
  }
}

Valor do campo do assinante definido pela ação

Use esta resposta para definir o valor do campo do assinante. O campo personalizado com o mesmo nome deve existir no seu bot

texto

{
  "version": "v1",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://NicoChat.com.au"
          }
        ]
      }
    ],
    "actions": [
      {
        "action": "set_field_value",
        "field_name": "your field name",
        "value": "some value"
      }
    ],
    "quick_replies": []
  }
}

O nome do arquivo enviado usando field_namedeve corresponder ao nome de um dos campos personalizados existentes no bot NicoChat Você precisa controlar o tipo de dados registrado nos campos personalizados, o tipo de dados deve corresponder ao tipo de campo personalizado

Use os seguintes formatos de valor:

Para Numbero tipo de campo, o valor deve ser numérico como 2ou3.14 não delimitado por aspas duplas;
Para Texto tipo de campo, o valor deve ser transferido como texto"some text";
Para Dateo tipo de campo, o valor deve ser transferido como texto com data formatada como YYYY-MM-DD, ou seja"2018-03-25";
Para Date Timeo tipo de campo o valor deve ser transferido como texto com data formatada em ISO8601 UTC, ou seja"2018-03-25T13:25:00.000Z"

Ação cancela o valor do campo do assinante

Use esta resposta para cancelar a definição (limpar) do valor do campo do assinante. O campo personalizado com o mesmo nome deve existir no seu bot

texto

{
  "version": "v1",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text with button",
        "buttons": [
          {
            "type": "url",
            "caption": "External link",
            "url": "https://NicoChat.com.au"
          }
        ]
      }
    ],
    "actions": [
      {
        "action": "unset_field_value",
        "field_name": "your field name"
      }
    ],
    "quick_replies": []
  }
}