API de LINE

Nota

Antes de enviar mensajes de LINE, asegúrese de que la plataforma de Line esté configurada correctamente. Aprenda más

createLineMessage

Se utiliza para enviar mensajes de LINE a los usuarios

POST https://api.pushwoosh.com/json/1.3/createLineMessage

Enviar un mensaje de texto

Mensajes de LINE simples que consisten solo en texto plano, sin imágenes ni botones. Aprenda más

Consejo: Para formato avanzado y rich media, utilice plantillas de mensajes como Flex, imagen, o carrusel.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
application	string	Sí	Código de aplicación de Pushwoosh
auth	string	Sí	Token de acceso a la API para autenticar la solicitud.
notifications	array de objetos	Sí	Lista de objetos de mensaje de LINE a enviar.
content	string	Sí	Texto del mensaje de LINE a enviar. Límite máximo de caracteres: 5000. Nota: Si se incluyen tanto preset como content, el valor de la solicitud anula el preset.
preset	string	No	Código del preset de LINE que creó en el Panel de Control de Pushwoosh. Nota: Si se incluyen tanto preset como content, el valor de la solicitud anula el preset.
send_date	string	Sí	Fecha y hora para enviar el mensaje. Use el formato AAAA-MM-DD HH:mm o now para enviar inmediatamente.
devices	array de strings	Sí	Lista de códigos de dispositivo (ID de usuario) a los que se enviará el mensaje de LINE.

{
    "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
        "notifications": [
            {
                "content": "test",
                "preset": "preset_code",
                "send_date":"now",
                "devices": ["XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"]
            }
        ]
    }
}

Enviar un mensaje de imagen

Puede enviar un mensaje de imagen a los usuarios de LINE especificando un objeto de imagen dentro del campo de la plantilla de su solicitud.

Cada mensaje de imagen requiere dos URL de imagen: una para la imagen a tamaño completo (image_url) y otra para la vista previa (preview_image_url). Cuando los usuarios tocan la vista previa, se abre la imagen a tamaño completo. Asegúrese de que ambas URL usen HTTPS (TLS 1.2 o posterior) y enlacen a archivos de imagen de acceso público.

Para más detalles, consulte la sección Mensaje de imagen en la documentación de la API de mensajería de LINE.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
application	string	Sí	Código de aplicación de Pushwoosh
auth	string	Sí	Token de acceso a la API utilizado para autenticar la solicitud.
notifications	array de objetos	Sí	Lista de mensajes a enviar.
content	string	Sí	Se utiliza como texto alternativo o de vista previa para el mensaje. Código del preset de LINE que creó en el Panel de Control de Pushwoosh. Nota: Si se incluyen tanto preset como template, se utiliza el template de la solicitud. Si se incluyen tanto preset como content, el content de la solicitud anula el preset.
send_date	string	Sí	Fecha y hora para enviar el mensaje. Use el formato AAAA-MM-DD HH:mm o now para enviar inmediatamente.
devices	array de strings	Sí	Lista de códigos de dispositivo (ID de usuario) a los que se enviará el mensaje de LINE.
preset	string	No	Código del preset de LINE que creó en el Panel de Control de Pushwoosh. Nota: Si se incluyen tanto los parámetros preset como template en la solicitud, los valores del template anularán los definidos en el preset. Si se incluyen tanto preset como content en la misma solicitud, el content proporcionado directamente en la solicitud anulará el contenido del preset.
template	object	Sí	Plantilla de diseño del mensaje. Admite múltiples tipos de mensajes. Vea los detalles a continuación.

Parámetros de la plantilla

Tipo: image

Parámetro	Tipo	Requerido	Descripción
image_url	string	Sí	URL de la imagen a tamaño completo (debe usar HTTPS). Longitud máxima: 2000 caracteres. Formato: JPEG, PNG. Tamaño máximo: 10 MB.
preview_image_url	string	Sí	URL de la imagen de vista previa que se muestra en el chat (debe usar HTTPS). Longitud máxima: 2000 caracteres. Formato: JPEG, PNG. Tamaño máximo: 1 MB.

Solicitud de ejemplo

{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": [
          "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        ],
        "preset": "preset_code",
        "template": {
          "en": {
            "image": {
              "alt_text": "some text",
              "image_url": "https://images.com/1.jpg",
              "preview_image_url": "https://images.com/1.png"
            }
          }
        }
      }
    ]
  }
}

Enviar un mensaje de carrusel de imágenes

Los mensajes de carrusel de imágenes le permiten mostrar múltiples imágenes en un formato desplazable horizontalmente. Cada imagen aparece como una columna separada no clicable que los usuarios pueden deslizar en la interfaz de chat de LINE.

Este formato es ideal para mostrar artículos, promociones o selecciones visuales de una manera atractiva.

Para más detalles, consulte la sección Plantilla de carrusel de imágenes en la documentación de la API de mensajería de LINE.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
application	string	Sí	Código de aplicación de Pushwoosh
auth	string	Sí	Token de acceso a la API utilizado para autenticar la solicitud.
notifications	array de objetos	Sí	Lista de mensajes a enviar.
content	string	Sí	Se utiliza como texto alternativo o de vista previa para el mensaje. Nota: Si se establecen tanto content como template, se utiliza el template. Si se incluyen tanto un preset como content en la misma solicitud, el content proporcionado directamente en la solicitud anulará el contenido del preset.
send_date	string	Sí	Fecha y hora para enviar el mensaje. Use el formato AAAA-MM-DD HH:mm o "now".
devices	array de strings	Sí	Lista de códigos de dispositivo (ID de usuario) a los que se enviará el mensaje de LINE.
preset	string	No	Código del preset de LINE que creó en el Panel de Control de Pushwoosh. Nota: Si se incluyen tanto los parámetros preset como template en la solicitud, los valores del template anularán los definidos en el preset. Si se incluyen tanto un preset como content en la misma solicitud, el content proporcionado directamente en la solicitud anulará el contenido del preset.
template	object	Sí	Plantilla de diseño del mensaje. Admite múltiples tipos de mensajes. Vea los detalles a continuación.

Parámetros de la plantilla

Tipo: image_carousel

Parámetro	Tipo	Requerido	Descripción
alt_text	string	Sí	Texto alternativo que se muestra en las vistas previas de las notificaciones push y en dispositivos no compatibles. Máximo 400 caracteres.
columns	array de objetos	Sí	Array de columnas de imágenes (se admiten de 1 a 10). Cada columna incluye una imagen.
image_url	string	Sí	URL de la imagen que se muestra en cada columna del carrusel, que apunta a un archivo JPEG o PNG de acceso público. Debe usar HTTPS.

Solicitud de ejemplo

{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": [
          "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        ],
        "preset": "preset_code",
        "template": {
          "en": {
            "image_carousel": {
              "alt_text": "some text",
              "columns": [
                { "image_url": "https://images.com/1.jpg" },
                { "image_url": "https://images.com/2.jpg" },
                { "image_url": "https://images.com/3.jpg" }
              ]
            }
          }
        }
      }
    ]
  }
}

Enviar un mensaje Flex

Los Mensajes Flex son tipos de mensajes potentes y personalizables que le permiten crear diseños estructurados utilizando texto, imágenes, botones y otros componentes. Son ideales para casos de uso como recibos, tarjetas de productos, menús o cualquier contenido que se beneficie de una estructuración visual.

Para enviar un Mensaje Flex, incluya un objeto template con una carga útil raw dentro de su solicitud. El diseño del mensaje debe seguir la especificación de Mensajes Flex de LINE.

Consejo: Puede diseñar y previsualizar los Mensajes Flex utilizando el Simulador de Mensajes Flex de LINE.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
application	string	Sí	Código de aplicación de Pushwoosh
auth	string	Sí	Token de acceso a la API utilizado para autenticar la solicitud.
notifications	array de objetos	Sí	Lista de mensajes a enviar.
content	string	Sí	Se utiliza como texto alternativo o de vista previa para el mensaje. Nota: Si se establecen tanto content como template, se utiliza la plantilla. Si se incluyen tanto preset como content, el contenido de la solicitud anula el preset.
send_date	string	Sí	Cuándo enviar el mensaje. Use "now" o el formato AAAA-MM-DD HH:mm.
devices	array de strings	Sí	Lista de tokens de dispositivo de LINE (ID de usuario) que recibirán el mensaje.
preset	string	No	Código del preset de LINE que creó en el Panel de Control de Pushwoosh. Nota: Si se incluyen tanto preset como template, la plantilla anula el preset. Si se incluyen tanto preset como content, el contenido de la solicitud anula el preset.
template	object	Sí	Plantilla de diseño del mensaje. Admite múltiples tipos de mensajes. Vea los detalles a continuación.

Parámetros de la plantilla

Para un Mensaje Flex, utilice la estructura raw.
Tipo: raw (Flex)

Parámetro	Tipo	Requerido	Descripción
alt_text	string	Sí	Texto alternativo que se muestra en notificaciones, vistas previas de chat y citas. Máximo 400 caracteres.
content	object	Sí	Diseño del Mensaje Flex, estructurado usando bubble, box, text y otros componentes según la especificación Flex de LINE.

Solicitud de ejemplo

{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": ["XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"],
        "preset": "preset_code",
        "template": {
          "en": {
            "raw": {
              "alt_text": "My raw template",
              "content": {
                "type": "bubble",
                "body": {
                  "type": "box",
                  "layout": "vertical",
                  "contents": [
                    {
                      "type": "text",
                      "text": "RECEIPT",
                      "weight": "bold",
                      "color": "#1DB446",
                      "size": "sm"
                    }
                    // Additional components...
                  ]
                }
              }
            }
          }
        }
      }
    ]
  }
}