Para Desenvolvedores/Contenido Dinámico/Mensagens - Formatos/Actions - Formatos

Actions - Formatos

La propiedad actions de la respuesta del servidor es opcional.

2026-08-12

Acción agregar etiqueta

Usa esta respuesta para agregar una etiqueta a un suscriptor. Una etiqueta con el mismo nombre debe existir en tu canal:

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": []
  }
}

El nombre de la etiqueta enviado en el parámetro tag_name debe coincidir con una de las etiquetas existentes en el canal de NicoChat

Acción eliminar etiqueta

Usa esta respuesta para eliminar una etiqueta de un suscriptor. Una etiqueta con el mismo nombre debe existir en tu canal:

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": []
  }
}

Acción definir el valor del campo del suscriptor

Usa esta respuesta para definir el valor del campo del suscriptor. Un campo personalizado con el mismo nombre debe existir en tu canal

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": []
  }
}

El nombre del campo enviado en field_name debe coincidir con el nombre de uno de los campos personalizados existentes en el canal de NicoChat. Debes controlar el tipo de dato registrado en los campos personalizados: el tipo del dato debe coincidir con el tipo del campo personalizado.

Usa los siguientes formatos de valor:

Para el tipo de campo Number, el valor debe ser numérico, como 2 o 3.14, sin comillas dobles;
Para el tipo de campo Text, el valor debe enviarse como texto: "some text";
Para el tipo de campo Date, el valor debe enviarse como texto con la fecha en el formato YYYY-MM-DD, es decir, "2018-03-25";
Para el tipo de campo Date Time, el valor debe enviarse como texto con la fecha en formato ISO8601 UTC, es decir, "2018-03-25T13:25:00.000Z"

Acción limpiar el valor del campo del suscriptor

Usa esta respuesta para limpiar (borrar) el valor del campo del suscriptor. Un campo personalizado con el mismo nombre debe existir en tu canal

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": []
  }
}