Adding notifications

To publish notifications, a public API is implemented, accessed through calling the corresponding methods of the global Kommo object. When you call the method, you need to transfer an object with a description of the notification.

Information Notice

The method is intended for calling a pop-up notification, which will be displayed to the user only in the interface and will not be replicated on other delivery channels.

Method name

show_message()

Parameters

Parameter	Required	Description
header	Yes	Post Title
text	Yes	Notification text
date	No	Date in timestamp format
icon	No	URL to arbitrary icon file. If not passed, then the default icon of robot is used

Example

var message_params = {
  header: "Warning",
  text: "Connection established",
  date: +19534084500,
  icon: "https://www.example.com/images/telephone.png"
};
APP.notifications.show_message(message_params);

Result

foto

Error Notification

The method displays an error notification in the interface of the account, and the message will not be transmitted via other delivery channels.

Method name

show_message_error()

Parameters

Parameter	Required	Description
header	Yes	Post Title
text	Yes	Notification text
date	No	Date in timestamp format
link	No	redirect URL when clicking on a notification

Example

var error_params = {
header: “Warning”,
text: “Connection to the server is lost”
};
APP.notifications.show_message_error(error_params);

Result

foto

Incoming call notification

The method allows you to display a pop-up notification of a call or an error. If you use this message, it will be displayed only in the interface and will not be transmitted through other channels.

Method name

show_notification()

Parameters

Parameter	Required	Description
text	Yes	Array with a description of the message
text/header	Yes	Notification Header
text/text	Yes	Text message
date	No	Date in timestamp format
type	Yes	Type of pop-up notification. Can take values call or type

Example

var notification = {
  text: {
    header: "Outgoing call",
    text: "Dialing the number +19872345678"
  },
  type: "call"
};
APP.notifications.show_notification(notification);

Result

foto

Example

var notification = {
  text: {
    header: "Error",
    text: "Error working with the widget"
  },
  type: "error"
};
APP.notifications.show_notification(notification);

Result

foto

Adding an error notification

The method allows you to add an error notification to the notification center. The message will be sent to all active channels in the user’s account.

Method name

add_error()

Parameters

Parameter	Required	Description
header	No	Post Title
text	Yes	Notification text
date	No	Date in timestamp format
link	No	The link that will trigger the click on the notification

Example

var error_params = {
    header: "Error",
    text: "Failed to set the task! Contact not found!",
    date: +19534085310,
    link: "/contacts/list/?term=4951234567"
};
APP.notifications.add_error(error_params);

Result

foto

An email notification about the error.

foto

Notification that has come to the mobile application.

foto
foto

Incoming call notification

The Notification Center API allows you to display an incoming call message. The notification will be transmitted over all active delivery channels.

Method name

add_call()

Parameters

Parameter	Required	Description
text	Yes	The text message that will be displayed in the notification.
date	No	Date in timestamp format
from	No	The line in which the initiator of the incoming call is specified. Phone number – if the contact is not found in your account. Contact name – if the call came from an existing contact in your account.
to	No	Manager name or extension number of the subscriber who received the incoming call.
element	No	An object describing the entity to which the transition will occur when clicking on the pop-up call notification.
element.id	Yes	Entity ID
element.type	Yes	Entity type: contact, lead or company

Parameter

var call_params = {
  text: "Call from +1 (415) 523-7743",
  date: +19534084500,
  from: "Jeremy Watts",
  to: "Jason Nash",
  element: { id: 18221265, type: "contact" },
  duration: 250,
  link: 'https://example.com/dialog.mp3'
};
APP.notifications.add_call(call_params);

Result

foto

Notification of the call in the notification center and in the mobile application.

foto
foto