Para publicar notificaciones, se implementa una API pública, a la cual se accede a través de la llamada a los métodos correspondientes del objeto global Kommo APP. Al llamar al método, es necesario transferir un objeto con la descripción de la notificación.

Notificación de información

El método está diseñado para disparar una notificación emergente, que solo aparecerá en la interfaz y no se duplicará en otros canales de entrega.

Nombre del método

show_message()

Parámetro	¿Requerido?	Descripción
header	✅	Título de la publicación.
text	✅	Texto de la notificación.
date	❌	Fecha en formato Unix Timestamp.
icon	❌	URL a un archivo de ícono. Si no se proporciona, se utilizará el ícono predeterminado del robot.

Ejemplo:

var message_params = {
  header: "Atención",
  text: "Conexión establecida",
  date: 1714566795,
  icon: "https://www.example.com/images/telephone.png"
};
APP.notifications.show_message(message_params);

Resultado:

Notificación de error

El método mostrará una notificación de error en la interfaz de la cuenta, y el mensaje no se enviará a través de otros canales de entrega.

Nombre del método

show_message_error()

Parámetros

Parámetro	¿Requerido?	Descripción
header	✅	Título de la publicación.
text	✅	Texto de la notificación.
date	❌	Fecha en formato Unix Timestamp.
link	❌	La URL a la que el usuario será redirigido si hace clic en la notificación.

Ejemplo

var error_params = {
header: “Atención”,
text: “Se ha perdido la conexión con el servidor”
};
APP.notifications.show_message_error(error_params);

Resultado

Notificación de llamada entrante

El método te permite mostrar una notificación emergente para una llamada o un error. Si utilizas esta función, solo aparecerá en la interfaz y no se enviará a través de otros canales.

Nombre del método

show_notification()

Parámetros

Parámetro	¿Requerido?	Descripción
text	✅	Arreglo con una descripción del mensaje.
text/header	✅	Encabezado de la notificación.
text/text	✅	Mensaje de texto.
date	❌	Fecha en formato Unix Timestamp.
type	✅	Tipo de notificación emergente (`call` o `error`).

Ejemplo

var notification = {
  text: {
    header: "Llamada saliente",
    text: "Llamada al número +19872345678"
  },
  type: "call"
};
APP.notifications.show_notification(notification);

Resultado

Ejemplo

var notification = {
  text: {
    header: "Error",
    text: "Error de funcionamiento del widget"
  },
  type: "error"
};
APP.notifications.show_notification(notification);

Resultado

Añadir una notificación de error

El método te permite añadir una notificación de error al centro de notificaciones, y el mensaje será enviado a todos los canales activos en la cuenta del usuario.

Nombre del método

add_error()

Parámetros

Parámetro	¿Requerido?	Descripción
header	❌	Título del mensaje.
text	✅	Texto de la notificación.
date	❌	Fecha en formato Unix Timestamp.
link	❌	La URL a la que el usuario será redirigido si hace clic en la notificación.

Ejemplo

var error_params = {
    header: "Error",
    text: "¡Error al crear la tarea! ¡Contacto no encontrado!",
    date: 1714566795,
    link: "/contacts/list/?term=4951234567"
};
APP.notifications.add_error(error_params);

Resultado

Una notificación por correo electrónico sobre el error:

Notificación que ha llegado a la aplicación móvil:

Notificación de llamada entrante

La API del Centro de Notificaciones te permite mostrar un mensaje de llamada entrante. La notificación se transmitirá a través de todos los canales de entrega activos.

Nombre del método

add_call()

Parámetros

Parámetro	¿Requerido?	Descripción
text	✅	El mensaje de texto que se mostrará en la notificación.
date	❌	Fecha en formato Unix Timestamp.
from	❌	Especifica el iniciador de la llamada entrante. Muestra el número de teléfono si no se encuentra en tu lista de contactos, y el nombre del contacto si la llamada proviene de un número registrado en tu lista de contactos.
to	❌	Nombre del gerente o número de extensión del suscriptor que recibió la llamada entrante.
element	❌	Un objeto que describe la entidad de destino para la transición al hacer clic en la notificación emergente de la llamada.
element.id	✅	ID de la entidad.
element.type	✅	Tipo de entidad: contacto, lead or compañía.
link	❌	Un enlace a la grabación de la llamada.

Parámetro

var call_params = {
  text: "Llamada de +1 (415) 523-7743",
  date: 1714566795,
  from: "Jorge Torres",
  to: "Joaquín Castro",
  element: { id: 18221265, type: "contact" },
  duration: 250,
  link: 'https://example.com/dialog.mp3'
};
APP.notifications.add_call(call_params);