API documentation

The API key will be automatically saved in localStorage.

Base-URL


            https://rest.messengerpeople.com/api/v15/<endpoint>

Download Postman Collection

login

POST Login `/login`

https://rest.messengerpeople.com/api/v15/login

Create an API token for this user, that can be used instead of the API key to identify the users actions.

Parameter	Type	Description
`username`	string	Login username (email address)
`password`	password	Login password
`code`	string	Optional V2 A code generated for new agents or when restoring a forgotten password. If the code matches, the specified password is used from now on for the agent. Or a code sent for 2-factor authentication.
`token`	string	Optional V2 Token with login data
`channel_id`	string	Optional V12 Channel ID for activating this channel
`two_factor_userid`	string	Optional V13 The whatsapp number or email address to which the 2fa code will be sent, cannot be overwritten

Request

Response

POST Password Code `/login/code`

https://rest.messengerpeople.com/api/v15/login/code

Generate a code that is sent to the email address of the agent for restoring a forgotten password.

Parameter	Value	Type	Description
`username`		string	Login username (email address)

Request

Response

DELETE Login /login
https://rest.messengerpeople.com/api/v15/login
Logout a user who previously logged in
This method has no parameters.
Request
Response

user

GET Profile `/user/{id}`

https://rest.messengerpeople.com/api/v15/user/{id}

Get profile information about one or multiple users. If the id is omitted users can be listed using various filters.

Parameter	Type	Description
`id`	mixed	Optional The user ID, number or secret hash code. Multiple ids can be separated by comma.
`limit`	integer	Optional Default: `500` The maximum number of results.
`status`	boolean(0/1)	Optional V2 Active and inactive users are listed per default. Use `1` for listing only active users and `0` for listing only inactive users.
`offset`	integer	Optional Default: `0` The number of skipped results.
`blocked`	boolean(0/1)	Optional V2 Set to `1` for listing only blocked users
`targeting_id`	integer	Optional Default: `0` V2 List only active users of this targeting group.
`search`	string	Optional V2 Users can be searched by id/phone number (if the search attribute is numeric) or by parts of their name or referral info.
`order`	string	Optional V15 User lists are ordered by creation date per default. `stopped`, `id`, `name`, `messenger`, `blocked`, `last_chat`, `last_in` or `last_out` can be specified to order by those attributes.
`asc`	boolean(0/1)	Optional Default: `0` V2 Normally user lists are sorted descending which means latest first.
`last_chat`	boolean(0/1)	Optional Default: `0` V15 Set if the time of the last user chat (incoming or outgoing) should be included. Retrieving the information costs more time.
`last_in`	boolean(0/1)	Optional Default: `0` V15 Set if the time of the last user chat (incoming) should be included. Retrieving the information costs more time.
`last_out`	boolean(0/1)	Optional Default: `0` V15 Set if the time of the last user chat (outgoing) should be included. Retrieving the information costs more time.
`last_message`	boolean(0/1)	Optional Default: `0` V15 Set if the last message (incoming or outgoing) should be included. Not available when using tickets.
`unread`	boolean(0/1)	Optional Default: `0` V15 Set if the number of unread incoming chat messages should be included. Not available when using tickets.
`customfields`	boolean(0/1)	Optional Default: `0` V6 Set if custom fields should be included.
`filter`	json	Optional V13 A JSON array of user filter. If multiple filters are specified, all are applied. Each filter element can have the following elements: `type`: mandatory type of the filter. Possible value is `created` or `customfield` `after`: UNIX timestamp of created or last update of a customfield `before`: UNIX timestamp of created or last update of a customfield `name`: name of a custom field (default all) `value`: Value of a custom field
`inbotchat`	boolean(0/1)	Optional List only users whose latest chats have been with the chatbot without a ticket
`output_format`	string	Optional Default: `json` V14 Possible values json or csv. Only applies for listing users.

Request

Response

PUT Update `/user/{id}`

https://rest.messengerpeople.com/api/v15/user/{id}

Update properties of a user

Parameter Value Type Description

id

mixed

The user ID, number or secret hash code. Multiple ids can be separated by comma.

fields

json

V15

Requires JSON with field name => field value.
Possible field names:

name: name of the user

customfields: Please see possible user properties by using the GET USER PROPERTIES call.
Example:

{  
"name": "John Doe",  
"customfields": {  
"haircolor": "brown",  
"123": "premium"  
},  
}

unread

integer

Optional V15

Number of unread incoming chat messages. Not available when using tickets. Set 0 or the number of unread chat messages.
If unread is set for multiple users, the fields parameter is ignored. Also only the last message per user is marked as unread if unread is greater 1.

Request

Response

POST Upload CSV `/user/csv`

https://rest.messengerpeople.com/api/v15/user/csv

Bulk update users by uploading a csv file.

WhatsApp, Facebook and Telegram user can be created with the upload as well.

This is not a JSON Request, please use the default HTTP Multi Part Request

Parameter Type Description

Parameter	Type	Description
`file`	file	The CSV file containing the user list. Only fields provided within the file will be handled The following fields are possible: Regular fields: id mandatory Id of the user, differs by messenger, for WhatsApp this would be the phone number messenger mandatory Identifier for the used messenger of the user. Possible values: CC for Custom Messenger, FB for Facebook, IM for IMessage, IG for Instagram, RC for RCS, TG for Telegram, VI for Viber, WB for WhatsApp, IN for Notify name Username Control fields: activated 1: user should be activated for MIA, 0: user should be deactivated for MIA blocked 1: user should be blocked, 0: user should be unblocked deactivated 1: user should be deactivated for MIA, 0: user should be activated for MIA deleted: 1: user should be deleted, 0: user should not be deleted Every user property of the channel listed by name

file

file

The CSV file containing the user list.
Only fields provided within the file will be handled
The following fields are possible:

Regular fields:
- id
  mandatory
  Id of the user, differs by messenger, for WhatsApp this would be the phone number
- messenger
  mandatory
  Identifier for the used messenger of the user. Possible values: CC for Custom Messenger, FB for Facebook, IM for IMessage, IG for Instagram, RC for RCS, TG for Telegram, VI for Viber, WB for WhatsApp, IN for Notify
- name
  Username
Control fields:
- activated
  1: user should be activated for MIA, 0: user should be deactivated for MIA
- blocked
  1: user should be blocked, 0: user should be unblocked
- deactivated
  1: user should be deactivated for MIA, 0: user should be activated for MIA
- deleted:
  1: user should be deleted, 0: user should not be deleted
Every user property of the channel listed by name

DELETE Delete `/user/{id}`

https://rest.messengerpeople.com/api/v15/user/{id}

Delete the user and his chats. Chats and information about the user are deleted immediately after this call.

Parameter	Value	Type	Description
`id`		mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.

Request

Response

PUT Start `/user/{id}/start`

https://rest.messengerpeople.com/api/v15/user/{id}/start

Activate a user for MIA.

Parameter	Value	Type	Description
`id`		mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.

Request

Response

PUT Stop `/user/{id}/stop`

https://rest.messengerpeople.com/api/v15/user/{id}/stop

Deactivate a user for MIA.

Parameter	Value	Type	Description
`id`		mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.

Request

Response

PUT Block `/user/{id}/block`

https://rest.messengerpeople.com/api/v15/user/{id}/block

Block a user.

Parameter	Value	Type	Description
`id`		mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.

Request

Response

PUT Unblock `/user/{id}/unblock`

https://rest.messengerpeople.com/api/v15/user/{id}/unblock

Unblock a user that was previously blocked.

Parameter	Value	Type	Description
`id`		mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.

Request

Response

GET Categories `/user/{id}/categories`

warning

warning This method has been deprecated and will be removed in future versions. You should avoid using it. https://rest.messengerpeople.com/api/v15/user/{id}/categories

Get subscribed categories (MIA topics) of a user

Parameter	Value	Type	Description
`id`		mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.

Request

Response

PUT Categories `/user/{id}/categories`

warning

warning This method has been deprecated and will be removed in future versions. You should avoid using it. https://rest.messengerpeople.com/api/v15/user/{id}/categories

Set categories (MIA topics) of a user

Parameter	Type	Description
`id`	mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.
`category_id`	integer	The category ID.
`status`	boolean(0/1)	Set active (`1`) or inactive (`0`).

Request

Response

POST Create `/user`

V14

https://rest.messengerpeople.com/api/v15/user

Create a new user for the specified messenger

Parameter	Value	Type	Description
`id`		string	The phone number of the user without blanks or leading + or 0, e.g 491771234567
`messenger`		string	Must be set to WB for creating a WhatsApp Business user

Request

Response

GET Property `/user/property`

https://rest.messengerpeople.com/api/v15/user/property

Get a user property for a list of users

Parameter	Value	Type	Description
`id`		string	Optional A comma-separated list of user numbers. Leave empty to list all users with the property.
`name`		string	The name of the user property

Request

Response

PUT Property `/user/property`

https://rest.messengerpeople.com/api/v15/user/property

Update a user property of a list of users

Parameter	Type	Description
`id`	string	The user number. Multiple numbers can be separated by comma.
`name`	string	The name of the user property
`value`	string	The value of the user property. Must be compliant with the possible field values.

Request

Response

User properties

GET Properties `/custom/{id}`

https://rest.messengerpeople.com/api/v15/custom/{id}

Get all user properties

Parameter	Value	Type	Description
`id`		mixed	Optional The field ID or name
`hidden`		boolean(0/1)	V8 Set to 1 if hidden fields should be included.

Request

Response

POST Create `/custom`

https://rest.messengerpeople.com/api/v15/custom

Create a new user property

Parameter	Type	Description
`name`	string	The name of the user property, no spaces. `"fieldname"` will result in a bot variable $fieldname$ .
`type`	string	Possible types: `number` `text` `word` `enum` `collection` `location` `date` `time`
`values`	string	Optional Possible values or conditions for this proeprty. e.g. `>=2 <=9` for type `number`. `a,b,c,d` for type `enumeration` or `collection`
`expiration`	integer	Expiration in seconds `0`: won't be saved and can only be used in the answer associated with the input `>0`: Seconds before information will be purged `-1`: permanent
`user_visible`	boolean(0/1)	Property can be edited on the "profile page" by the user.
`label`	string	Display name of the property (also shown on users profile page)
`position`	integer	Optional V8 The position of the property. Per default it is added at the end.
`agent_visible`	boolean(0/1)	Optional Default: `1` V15 Property is only visible with appropriate rights (not for normal agents).
`hidden`	boolean(0/1)	Optional Default: `0` V8 Property is only visible with appropriate rights (not for normal agents).
`default_value`	string	Optional V12 Default value that is replaced if no value is stored in the user profile.

Request

Response

PUT Update `/custom`

https://rest.messengerpeople.com/api/v15/custom

Update a user property

Parameter	Type	Description
`id`	mixed	The field ID or name
`name`	string	The name of the user property, no spaces. `"fieldname"` will result in a bot variable $fieldname$ .
`type`	string	Possible types: `number` `text` `word` `enum` `collection` `location` `date` `time`
`values`	string	Optional Possible values or conditions for this property. e.g. `>=2 <=9` for type `number`. `a,b,c,d` for type `enumeration` or `collection`
`expiration`	integer	Expiration in seconds `0`: won't be saved and can only be used in the answer associated with the input `>0`: Seconds before information will be purged `-1`: permanent
`user_visible`	boolean(0/1)	Property can be edited on the "profile page" by the user.
`label`	string	Display name of the property (also shown on users profile page)
`position`	integer	Optional V8 The position of the property.
`agent_visible`	boolean(0/1)	Optional Default: `1` V15 Property is only visible with appropriate rights (not for normal agents).
`hidden`	boolean(0/1)	Optional Default: `0` V8 Property is only visible with appropriate rights (not for normal agents).
`default_value`	string	Optional V12 Default value that is replaced if no value is stored in the user profile.

Request

Response

DELETE Delete `/custom`

https://rest.messengerpeople.com/api/v15/custom

Delete a user property

Parameter	Value	Type	Description
`id`		mixed	The property ID or name

Request

Response

User-Chat

GET Chat Messages `/chat`

https://rest.messengerpeople.com/api/v15/chat

Get the chat messages of a user ordered by chat time latest first. The result includes the send_status with the following possible values (availability depending on the messenger):
0 = sending in progress
1 = sent (in WhatsApp and Viber
2 = delivered)
3 = read
-1 = failed
-2 = user rejected, left the channel or 24 hour window is exceeded
4 = Notification sent
5 = Notification delivered
6 = Notification read
-5 Notification failed
-6 Notification user does not exist

Parameter	Type	Description
`id`	mixed	The user ID, number or secret hash code. Multiple ids can be separated by comma.
`limit`	integer	Optional Default: `50` This maximum number of results.
`showstartstop`	boolean(0/1)	Optional Default: `0` Show MIA start and stop messages of users.

Request

Response

POST Send Message `/chat`

https://rest.messengerpeople.com/api/v15/chat

Send a message to a user or to multiple users

Parameter	Type	Description
`id`	mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma. The user number / id must be numeric only. Do not add a "+" to the user number (WhatsApp)
`message`	string	Optional The text message to be sent.
`attachment`	url	Optional The url of the attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx, etc). If the attachment is valid, a field called `reusable_attachment` is in the result, containing a cached URL for the sent file. Use this URL the next time for sending the same file to other users to improve the performance.
`filename`	string	Optional V7 The filename of the attachment. It can be displayed in messengers that don't support inline view of the attachment.
`buttons`	json	Optional A JSON encoded array of buttons can be passed. Each button must define a `caption` (displayed text), a `type` (link or postback) and an `info` field Link must contain a URL. Postback a text send back to the server when the user clicks on it Example: `[ {"type":"link", "caption":"MessengerPeople", "info":"https:\/\/www.messengerpeople.com"}, {"type":"postback", "caption":"Hello","info":"Hello"} ]` Note: Buttons are sent differently to the various messengers.
`meta`	array	Optional V12 The parameter "meta" can contain any key => value pairs, that do not use reserved names. Mainly used for internal purposes
`batch_ids`	mixed	Optional V12 Array or comma-separated list of user numbers for sending to a larger number of users. Use instead of the id parameter. Performance-optimized so it does not update tickets of individual users. Just a list of success and failure numbers is returned.
`user_filter`	json	Optional V13 Optional filter to use for sending in batch mode. Valid filters are all parameters given in endpoint USER GET.

Request

Response

POST Send Notification `/chat/notification`

https://rest.messengerpeople.com/api/v15/chat/notification

Send a notification to a user or to multiple users in WhatsApp Business

Parameter	Type	Description
`id`	mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.
`batch_ids`	mixed	Optional V12 Array or comma-separated list of user numbers for sending to a larger number of users. Use instead of the id parameter. Performance-optimized so it does not update tickets of individual users. Just a list of success and failure numbers is returned.
`user_filter`	json	Optional V13 Optional filter to use for sending in batch mode. Valid filters are all parameters given in endpoint USER GET.
`notification_template`	string	V12 The name of the notification template
`notification_body_variables`	json	Optional V12 A JSON array of parameters that are replaced in the notification. For example: ["$profile_name$", "Value 2"]
`notification_header_media`	string	Optional V12 The url of the header attachment. The following types/extensions are supported: image (jpg, png), video (mp4) or document (pdf). If the attachment is valid, a field called `reusable_attachment` is in the result, containing a cached URL for the sent file. Use this URL the next time for sending the same file to other users to improve the performance.
`notification_header_variable`	string	Optional V12 The text to be placed into the header variable
`notification_button_variable`	string	Optional V13 The suffix added to a dynamic link button
`notification_language`	string	V15 Language code of the notification, that should be send. All available language codes can be found on the page https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates.

Request

Response

POST Bot Chat `/chat/bot`

https://rest.messengerpeople.com/api/v15/chat/bot

Start a bot conversation with a user by sending a botchat. The bot_active flag of an associated ticket will be set and the bot topic will be activated for the user.

Parameter	Type	Description
`id`	mixed	The user ID, number or secret hash code. Multiple IDs can be separated by comma.
`topic_id`	integer	Optional The ID of the topic
`chat_id`	integer	Optional The ID of the chat
`customfields`	json	Optional V7 JSON with `field name` => `field value`pairs which will be set as user properties before sending. see possible user properties by using the GET USER PROPERTIES call. Example: `{ "color": "red" }`
`user_filter`	json	Optional V14 Optional filter to use for sending in batch mode. Valid filters are all parameters given in endpoint USER GET.

Request

Response

DELETE Delete `/chat`

https://rest.messengerpeople.com/api/v15/chat

Delete a single incoming chat by overwriting its text with "_chat_deleted" and removing all attachments

Parameter	Value	Type	Description
`id`		integer	The id of the chat that should be deleted

Request

Response

channel

GET Properties /channel
https://rest.messengerpeople.com/api/v15/channel
Get properties of the channel
This method has no parameters.
Request
Response

PUT Update `/channel`

https://rest.messengerpeople.com/api/v15/channel

Update properties of the channel

Parameter	Type	Description
`name`	string	Optional Name of the channel
`statusmessage`	string	Optional Status message of the channel
`welcomemessage`	string	Optional Welcome message for new users
`new_ticket_message`	string	Optional V11 Ticket message for existing users
`read_confirmation`	boolean(0/1)	Optional Set if a read confirmation should be sent in WhatsApp when receving chat messages
`linkpreview`	boolean(0/1)	Optional Set to enable the linkpreview-feature in the messengers supporting link previews
`every_word_starts`	boolean(0/1)	Optional Set to interpret every word as "Start" message. When disabled, only the default start word in the channels language or the specific start word is active.
`startword`	string	Optional When `startword` is set and `every_word_starts` is set to `0`, users are only activated if they send this specific word
`timezone`	string	Optional The timezone, e.g. "Europe/Berlin" or "America/Los_Angeles"
`inactive_delete_timeout`	integer	Optional The amount of days after which inactive users are deleted automatically
`language`	string	Optional Default language for this channel. Possible languages: `de`, `en`, `d1` (formal German), `es`, `fr`, `it`, `nl`, `pl`, `pt`, `ru`, `r1`, `ar`, `tr`, `hr` and `jp`
`image`	url	Optional URL of the profile image of the channel
`ticket_overdue_time`	integer	Optional Time in minutes after which a ticket is marked as "overdue"
`ticket_critical_time`	integer	Optional Time in minutes after which a ticket is marked as "critical"
`ticket_open_if_bot`	boolean(0/1)	Optional V5 Set if you want to open a ticket even if the chatbot answered already.
`ticket_reopen_period`	integer	Optional V5 Time in minutes after which a ticket is reopened after it has been closed. Default 60
`ticket_auto_close_time`	integer	Optional V13 Time in minutes after which a ticket is closed automatically. Default 0
`ticket_use_autoroutes`	boolean(0/1)	Optional V6 Set if you want to use autorouting of tickets.
`ticket_auto_assign`	boolean(0/1)	Optional V6 Set if you want to assign tickets to agents automatically.
`ticket_assign_last_agent`	boolean(0/1)	Optional V6 Set if you want to assign a ticket automatically to a previously assigned agent.
`ticket_deactivate_bot`	integer	Optional V6 Set to 2 for automatically deactivating a bot when the agent sends a chat response or to 1 when a ticket is opened.
`ui_settings`	string	Optional V7 Any information in json format used by a frontend to store channel specific settings
`ticket_max_per_agent`	integer	Optional V8 The maximum number of tickets that are assigned to an agent by auto routing.
`ticket_assign_online_agent`	boolean(0/1)	Optional V8 Set if you want to assign a ticket automatically only to online agents.
`ticket_assign_by_keywords`	boolean(0/1)	Optional V14 Set if you want to activate auto routing by keywords
`ticket_for_instagram_story`	boolean(0/1)	Optional Default: `1` V14 Set if you want to open a ticket whenever the channel is mentioned in an Instagram story
`applepay_settings`	string	Optional V8 Configuration for apple payment in json format (unused)
`enable_urltracking`	boolean(0/1)	Optional V10 Set if you want to enable urltracking with shortened URLs. Contact MessengerPeople if you want to use your own domain instead of www.msgp.pl.
`urltracking_parameters`	string	Optional V10 Parameters that are added to linked URLs if a user clicks on the link. %SOURCE% will be replaced by the used messenger
`content_pull_num`	integer	Optional Default: `1` V10 The number of unread MIA content messages a user gets when requesting MIA content.
`content_pull_time`	integer	Optional V10 The maximum age in seconds of unread MIA content messages a user gets when requesting content.
`content_notifications`	string	Optional V10 An array of default texts that can be used when sending MIA content
`content_pulled_all`	string	Optional V10 The message that a user gets when he tries to pull content but got already all content.
`notify_image`	string	Optional V10 The channel image displayed in the Notify app.
`notify_description`	string	Optional V10 A short text describing the channel in the Notify app.
`notify_chat`	boolean(0/1)	Optional V11 Specifies whether channel content can be displayed in the chat of Notify.
`notify_status`	string	Optional V10 The status of the channel in the Notify app affecting the visibility in the categories list. Possible values are public, private or hidden.
`welcomemessage_mia`	string	Optional V12 Welcome message for users subscribing for MIA content
`welcomemessage_mia_notify`	string	Optional V12 Notify promotion text added for WhatsApp users subscribing for MIA content
`goodbye_message`	string	Optional V12 Goodbye message for users who are unsubscribing
`privacy_link`	string	Optional V12 Link to the privacy policy
`mia_push`	boolean(0/1)	Optional V12 Specifies whether MIA content is pushed to messengers.
`deallocate_on_reopen`	boolean(0/1)	Optional V12 Specifies whether a reopened ticket should be de-assigned from an agent. Default 0
`facebook_stop_timeout`	integer	Optional V12 The number of days after which inactive Facebook users are stopped automatically
`notify_stop_timeout`	integer	Optional V12 The number of days after which inactive Notify users are stopped automatically
`delete_chat`	boolean(0/1)	Optional V13 Specifies whether agents can delete single chat messages.
`mandatory_note_on_ticket_close`	boolean(0/1)	Optional Default: `0` V13 Specifies whether a note is mandatory when closing a ticket.
`webchat_availability`	string	Optional V14 The days and hours when the webchat is available. Provide data in JSON format with a comma-separated list of weekdays as the key and a nested object with time-strings for from and to. Default value is: {"mon,tue,wed,thu,fri": {"from": "09:00", "to": "17:00"}}
`multi_channel_events`	boolean(0/1)	Optional Default: `0` V15 Specifies whether ticket and chat events in other channels of the account are distributed to the agents.

Request

Response

GET Chats `/channel/chats`

https://rest.messengerpeople.com/api/v15/channel/chats

Get all chat messages of the channel ordered by chat time latest first.
The result includes the send_status with the following possible values (availability depending on the messenger):
0 = sending in progress, 1 = sent (in WhatsApp and Viber 2 = delivered), 3 = read, -1 = failed, -2 = user rejected, left the channel or 24 hour window is exceeded,
Sent notifications are marked with notification: true

Parameter	Type	Description
`limit`	integer	Optional Default: `50` The maximum number of results.
`start`	integer	Optional V15 List only chat messages with a smaller ID.
`chattime`	integer	Optional V15 List only chat messages with a chattime that is later.
`incoming`	boolean(0/1)	Optional Default: `1` Show incoming messages.
`outgoing`	boolean(0/1)	Optional Default: `1` Show outgoing messages.
`chatmeta`	boolean(0/1)	Optional Default: `0` V15 Include chat meta information
`bot`	integer	Optional Default: `0` Show automated / bot messages if bot = 1. If bot = 2 include also welcome and stop messages.

Request

Response

GET Teams /channel/teams
https://rest.messengerpeople.com/api/v15/channel/teams
Get the teams of the channel
This method has no parameters.
Request
Response

POST Teams `/channel/teams`

https://rest.messengerpeople.com/api/v15/channel/teams

Create a new team for a channel

Parameter	Value	Type	Description
`name`		string	The name of the team
`add_agent`		mixed	Optional The ID of an agent that should be added to the team. Multiple IDs can be separated by comma.

Request

Response

PUT Teams `/channel/teams`

https://rest.messengerpeople.com/api/v15/channel/teams

Update teams of a channel

Parameter	Type	Description
`id`	mixed	The team ID. Multiple ids can be separated by comma.
`name`	string	Optional The name of the team
`add_agent`	mixed	Optional The ID of an agent that should be added to the team. Multiple IDs can be separated by comma.
`remove_agent`	mixed	Optional The ID of an agent that should be removed from the team. Multiple IDs can be separated by comma.

Request

Response

DELETE Teams `/channel/teams`

https://rest.messengerpeople.com/api/v15/channel/teams

Delete teams of a channel

Parameter	Value	Type	Description
`id`		mixed	The team ID. Multiple IDs can be separated by comma.

Request

Response

GET Agents /channel/agents
https://rest.messengerpeople.com/api/v15/channel/agents
Get the agents of the channel
This method has no parameters.
Request
Response

GET Online agent IDs `/channel/online_agents`

https://rest.messengerpeople.com/api/v15/channel/online_agents

Get a list of ids of online agents of the channel

Parameter	Value	Type	Description
`other_channels`		boolean(0/1)	Optional Default: `0` V15 Get online agents from other channels of this account

Request

Response

GET Labels /channel/labels
https://rest.messengerpeople.com/api/v15/channel/labels
Get the labels (tags) of the channel
This method has no parameters.
Request
Response

POST Labels `/channel/labels`

https://rest.messengerpeople.com/api/v15/channel/labels

Create a label (tag) for a channel

Parameter	Type	Description
`name`	string	The name of the label
`color_bg`	string	Optional The background color of the label in hex format, eg. `BADA55`
`color_tx`	string	Optional The text color of the label in hex format, eg. `C0FFEE`

Request

Response

PUT Labels `/channel/labels`

https://rest.messengerpeople.com/api/v15/channel/labels

Update a label (tag) of a channel

Parameter	Type	Description
`id`	mixed	The label ID. Multiple IDs can be separated by comma.
`name`	string	Optional The name of the label
`color_bg`	string	Optional The background color of the label in hex format, eg. `FACADE`
`color_tx`	string	Optional The text color of the label in hex format, eg. `BE1337`

Request

Response

DELETE Labels `/channel/labels`

https://rest.messengerpeople.com/api/v15/channel/labels

Delete labels (tags) of a channel

Parameter	Value	Type	Description
`id`		mixed	The label ID. Multiple IDs can be separated by comma.

Request

Response

GET Facebook /channel/facebook
https://rest.messengerpeople.com/api/v15/channel/facebook
Get Facebook connection info of the channel
This method has no parameters.
Request
Response

PUT Facebook `/channel/facebook`

https://rest.messengerpeople.com/api/v15/channel/facebook

Update Facebook confirmation and get-started information or (dis)connect to the Facebook page

Parameter	Type	Description
`confirm`	boolean(0/1)	Optional Default: `0` Set if a confirm dialog should be displayed to new Facebook users
`confirm_text`	string	Optional The text in the confirm dialog that new Facebook users are receiving.
`get_started`	boolean(0/1)	Optional Default: `0` Set if the Facebook "get started" button should be displayed to new users
`get_started_text`	string	Optional The greeting message that Facebook users are receiving when sending the first message to the page.
`access_token`	string	Optional The Facebook access token from an administrator connecting to a Facebook page. For connecting the page the `access_token`, `page_id` and `page_name` must be set. For disconnecting the page the `access_token` must be empty and `page_id` and `page_name` must be set.
`page_id`	integer	Optional The Facebook page ID
`page_name`	string	Optional The Facebook page name

Request

Response

DELETE Facebook /channel/facebook
https://rest.messengerpeople.com/api/v15/channel/facebook
Delete Facebook connection of a channel
This method has no parameters.
Request
Response
GET Webhook /channel/webhook
https://rest.messengerpeople.com/api/v15/channel/webhook
Get current webhook settings
This method has no parameters.
Request
Response

PUT Webhook `/channel/webhook`

https://rest.messengerpeople.com/api/v15/channel/webhook

Activate / Deactivate / Test Webhook An active WebHook will be used to inform an external system whenever a new chat message is sent from a user to a channel.

Parameter	Type	Description
`webhook_url`	url	The URL of a webhook. All incoming messages will be pushed to this URL. It MUST return a JSON `{ "success": "true" }` Otherwise the webhook will be deactivated after some failed attempts.
`status`	boolean(0/1)	Optional Set active (`1`) or inactive (`0`).
`webhook_email`	email	In case anything goes wrong, a notification will be sent to this email address.
`webhook_fields`	string	Optional V13 Comma separated list of fields to be included in the webhook call. Possible fields: id messenger usernumber date attachment attachment_type text welcome channelnumber userstatus chat_id bot_chatid is_retry ticket_id ticket_status agent_id Default: "id,messenger,usernumber,date,attachment,attachment_type,text,welcome,channelnumber,userstatus,chat_id"
`send_test`	boolean(0/1)	Optional A test message is sent to the webhook to check whether everything works correctly. If the parameter webhook_fields is set, the test data will be adjusted according to the field list The push contains three messages (2 x WhatsApp, 1 x Facebook) in one call: { "messages":[ { "id":"62103206", "messenger":"WB", "usernumber":"4917212345678", "date":"1522938174", "attachment":"", "attachment_type":"", "text":"Usermessage 1", "welcome":"0", "channelnumber":"4915792312345", "userstatus":"1", "chat_id":"1234567", "bot_chatid":"12345", "is_retry":"1" }, { "id":"62103207", "messenger":"WB", "usernumber":"4917212345678", "date":"1522938174", "attachment":"", "attachment_type":"", "text":"Usermessage 2", "welcome":"0", "channelnumber":"4915792312345", "userstatus":"1", "chat_id":"1234568", "bot_chatid":"12345", "is_retry":"0" }, { "id":"62103295", "messenger":"FB", "usernumber":"998694828505", "date":"1522938208", "attachment":"", "attachment_type":"", "text":"message via facebook", "welcome":"0", "userstatus":"1", "chat_id":"1234569", "bot_chatid":"12345", "is_retry":"0" } ] } If the user is activated successfully by sending the chat, the field `welcome` has the value `1`. The field userstatus has the value `-1`, `0` or `1`. `-1`: The user sending the chat was delete `0`: The user sending the chat is inactive `1`: The user sending the chat is active

Request

Response

GET APIkey /channel/apikey
https://rest.messengerpeople.com/api/v15/channel/apikey
Get the channel specific API key. This API key is valid until a new one is generated.
This method has no parameters.
Request
Response
PUT APIkey /channel/apikey
https://rest.messengerpeople.com/api/v15/channel/apikey
Generate a new API key. The previous API key is automatically invalidated.
This method has no parameters.
Request
Response
GET Invoices /channel/invoices
https://rest.messengerpeople.com/api/v15/channel/invoices
Get all invoices and payment URLs of the customer the channel belongs to.
This method has no parameters.
Request
Response
GET Features /channel/features
https://rest.messengerpeople.com/api/v15/channel/features
Get the info whether the channel uses MIA and the ticket system for customer support.
This method has no parameters.
Request
Response

MIA Content

GET List `/content`

https://rest.messengerpeople.com/api/v15/content

List MIA content

Parameter	Type	Description
`id`	integer	Optional The ID of a single content.
`filter`	string	Optional List only drafts if filter = "draft", scheduled if filter = "scheduled", content that is already published if filter = "published", or published and scheduled content of today (timezone Europe/Berlin) if filter = "today".
`limit`	integer	Optional Default: `50` The maximum number of results.
`offset`	integer	Optional Default: `0` The number of results skipped in the result set.
`order`	string	Optional Content lists are ordered by published date per default (creation date for drafts). `created` can be specified to order by this attribute.
`asc`	boolean(0/1)	Optional Default: `0` Normally content lists are sorted descending which means latest first.
`clicks`	boolean(0/1)	Optional Default: `0` V10 Specifies whether click statistics should be returned for URLs in contents. Requires enabled click tracking in the channel. The result shows the total number of clicks and the number of clicks for each messenger.
`detailed_reach_stats`	boolean(0/1)	Optional Default: `0` V10 Specifies whether reach statistics should be additionally split up in 'pulled from' and 'pushed to' for each messenger separately.

Request

Response

GET Targeting Groups /content/targeting
V14
https://rest.messengerpeople.com/api/v15/content/targeting
Get all targeting groups that can be used for sending MIA content. This includes all users, MIA topics and targeting groups with active users.
This method has no parameters.
Request
Response

POST Create `/content`

https://rest.messengerpeople.com/api/v15/content

Create a new MIA content

Parameter	Type	Description
`text`	string	Optional The text of the content.
`media`	url	Optional The url of a media attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx etc).
`media_filename`	string	Optional V11 The original filename of the attachment.
`draft`	boolean(0/1)	Optional If set, store the content as draft, otherwise it will be published.
`published`	integer	Optional The UNIX timestamp of the publication date in seconds (if not a draft). The current date is used per default.
`notification`	string	Optional V9 A short text that is sent to inform the users about new content. This text is sent to the Notify app or to WhatsApp, if the user has no Notify app.
`weblink`	string	Optional V9 If specified this link is opened directly from notifications in the Notify app. Other messengers will get the text + this weblink.
`buttons`	json	Optional V14 A JSON encoded array of buttons can be passed. Each button must define a `caption` (displayed text), a `type` (link or postback) and an `info` field Link must contain a URL. Postback a text send back to the server when the user clicks on it Example: `[ {"type":"link", "caption":"MessengerPeople", "info":"https:\/\/www.messengerpeople.com"}, {"type":"postback", "caption":"Hello","info":"Hello"} ]` Note: Buttons are sent differently to the various messengers.
`targeting`	integer	Optional V9 MIA topic ID 1-10 or ID of a targeting list.
`lifetime`	integer	Optional V11 The lifetime of the content after publishing in seconds.
`pull_keyword`	integer	Optional V12 The pull keyword used for pulling the content in WhatsApp.
`notification_template`	string	Optional V12 The name of the notification template
`notification_body_variables`	json	Optional V12 A JSON array of parameters that are replaced in the notification
`notification_header_media`	string	Optional V12 The url of the header attachment. The following types/extensions are supported: image (jpg, png), video (mp4) or document (pdf). If the attachment is valid, a field called `reusable_attachment` is in the result, containing a cached URL for the sent file. Use this URL the next time for sending the same file to other users to improve the performance.
`notification_header_variable`	string	Optional V12 The text to be placed into the header variable
`notification_button_variable`	string	Optional V13 The suffix added to a dynamic link button
`notification_language`	string	V15 Language code of the notification, that should be send. All available language codes can be found on the page https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates.
`targeting_query`	json	Optional V15 A targeting query to be used instead of a targeting_id.

Request

Response

PUT Update `/content`

https://rest.messengerpeople.com/api/v15/content

Update an existing MIA content. For published content only the lifetime can be changed.

Parameter	Type	Description
`id`	integer	The content ID
`text`	string	Optional The text of the content.
`media`	url	Optional The url of a media attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx etc).
`media_filename`	string	Optional V11 The original filename of the attachment.
`draft`	boolean(0/1)	Optional If set, store the content as draft, otherwise it will be published.
`published`	integer	Optional The UNIX timestamp of the publication date in seconds (if not a draft). The current date is used per default.
`notification`	string	Optional V9 A special notification text sent to the Notify app.
`weblink`	string	Optional V9 If specified this link is opened directly from notifications in the Notify app. Other messengers will get the text + this weblink.
`buttons`	json	Optional V14 A JSON encoded array of buttons can be passed. Each button must define a `caption` (displayed text), a `type` (link or postback) and an `info` field Link must contain a URL. Postback a text send back to the server when the user clicks on it Example: `[ {"type":"link", "caption":"MessengerPeople", "info":"https:\/\/www.messengerpeople.com"}, {"type":"postback", "caption":"Hello","info":"Hello"} ]` Note: Buttons are sent differently to the various messengers.
`targeting`	integer	Optional V9 Category ID 1-10 or ID of a targeting list.
`lifetime`	integer	Optional V11 The lifetime of the content after publishing in seconds.
`pull_keyword`	integer	Optional V12 The pull keyword used for pulling the content in WhatsApp.
`notification_template`	string	Optional V12 The name of the notification template
`notification_body_variables`	json	Optional V12 A JSON array of parameters that are replaced in the notification
`notification_header_media`	string	Optional V12 The url of the header attachment. The following types/extensions are supported: image (jpg, png), video (mp4) or document (pdf). If the attachment is valid, a field called `reusable_attachment` is in the result, containing a cached URL for the sent file. Use this URL the next time for sending the same file to other users to improve the performance.
`notification_header_variable`	string	Optional V12 The text to be placed into the header variable
`notification_button_variable`	string	Optional V13 The suffix added to a dynamic link button
`notification_language`	string	Optional V15 Language code of the notification, that should be send. All available language codes can be found on the page https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates.
`targeting_query`	json	Optional V15 A targeting query to be used instead of a targeting_id.

Request

Response

DELETE Delete `/content`

https://rest.messengerpeople.com/api/v15/content

Delete an existing MIA content that is not yet published

Parameter	Value	Type	Description
`id`		integer	The ID of the content.

Request

Response

Targeting Groups

GET List `/targeting`

https://rest.messengerpeople.com/api/v15/targeting

Get information about the available targeting groups

Parameter	Value	Type	Description
`id`		integer	Optional The ID of a single targeting group
`status`		boolean(0/1)	Optional V12 Status Filter. Use `1` for listing only targeting groups that dont use a status filter and `0` for listing targeting groups that filter inactive users.

Request

Response

PUT Update `/targeting`

https://rest.messengerpeople.com/api/v15/targeting

Update an existing targeting group

Parameter	Type	Description
`id`	integer	The targeting id
`name`	string	Optional The name of the targeting group
`query`	json	Optional A JSON array of the targeting group configuration

Request

Response

POST Create `/targeting`

https://rest.messengerpeople.com/api/v15/targeting

Create a new targeting group

Parameter	Value	Type	Description
`name`		string	The name of the targeting group
`query`		json	A JSON array of the targeting group configuration

Request

Response

DELETE Delete `/targeting`

https://rest.messengerpeople.com/api/v15/targeting

Delete an existing targeting group

Parameter	Value	Type	Description
`id`		integer	The ID of the targeting group

Request

Response

GET Configuration /targeting/config
https://rest.messengerpeople.com/api/v15/targeting/config
Get the targeting configuration values
This method has no parameters.
Request
Response

GET Count `/targeting/count`

https://rest.messengerpeople.com/api/v15/targeting/count

Get number of users for a targeting group. To be used with one of the two parameters.

Parameter	Value	Type	Description
`id`		integer	Optional The targeting id
`query`		json	Optional The targeting query. Schema: {"query": { "condition": "OR", "rules": [{ "id": "messenger", "field": "messenger", "type": "string", "input": "select", "operator": "equal", "value": "FB" }]}}

Request

Response

GET User `/targeting/user`

V14

https://rest.messengerpeople.com/api/v15/targeting/user

Get user IDs of a targeting group by id or by query optionally grouped by messenger.

Parameter	Type	Description
`id`	integer	Optional The targeting id
`by_messenger`	bool(0/1)	Optional Default: `0` Group the result by messenger
`query`	json	Optional V15 The targeting query. Schema: {"query": { "condition": "OR", "rules": [{ "id": "messenger", "field": "messenger", "type": "string", "input": "select", "operator": "equal", "value": "FB" }]}}

Request

Response

Notification Templates

GET Details `/templates/{name}`

https://rest.messengerpeople.com/api/v15/templates/{name}

Get a single template. If the name is omitted all templates are listed.

Parameter	Value	Type	Description
`name`		string	Optional The name of the template
`synchronize`		bool	Optional Default: `false` Synchronize templates with WhatsApp before listing

Request

Response

POST Post `/templates`

https://rest.messengerpeople.com/api/v15/templates

Create a new template

Parameter	Type	Description
`name`	string	The name of the template
`category`	string	The category of the template Valid values: 'ACCOUNT_UPDATE', 'PAYMENT_UPDATE', 'PERSONAL_FINANCE_UPDATE', 'SHIPPING_UPDATE', 'RESERVATION_UPDATE', 'ISSUE_RESOLUTION', 'APPOINTMENT_UPDATE', 'TRANSPORTATION_UPDATE', 'TICKET_UPDATE', 'ALERT_UPDATE', 'AUTO_REPLY'
`translations`	array	An array of translations with the following JSON structure. Language and body_text are mandatory. Header parameter depend on the header type: [ "en_US": { "language": "en_US", "body_text": "Text of the notification with parameter {{1}}", "header_type": "TEXT", <- one of TEXT, MEDIA "header_text": "Header text with parameter {{1}}", "header_media_type": "IMAGE", <- one of IMAGE, DOCUMENT, VIDEO, LOCATION "footer_text": "Footer text", "buttons": [ { <- up to 3 QUICK_REPLY buttons OR a URL and/or PHONE_NUMBER button "type": "QUICK_REPLY", <- one of QUICK_REPLY, URL, PHONE_NUMBER "text": "Button caption", <- "url": "https://foo.com/{{1}}", <- only for type URL. Parameter is optional. "phone_number": "0123456789", <- only for type PHONE_NUMBER } ], "sample": { <- sample data that helps WhatsApp in reviewing the template "body_variables": [ <- one for each used body variable "My variable 1", ], "header_media": "URL of media file", "header_variable": "My header variable", "button_variable": "Variable for dynamic URL button", }, }
`visible_for_agents`	bool	In-App visibility of the template

Request

Response

PUT Update `/templates/{name}`

https://rest.messengerpeople.com/api/v15/templates/{name}

Update a template

Parameter	Type	Description
`id`	integer	The id of the template
`name`	string	The name of the template. Can only be changed if all translations are still in status DRAFT.
`category`	string	The category of the template Valid values: 'ACCOUNT_UPDATE', 'PAYMENT_UPDATE', 'PERSONAL_FINANCE_UPDATE', 'SHIPPING_UPDATE', 'RESERVATION_UPDATE', 'ISSUE_RESOLUTION', 'APPOINTMENT_UPDATE', 'TRANSPORTATION_UPDATE', 'TICKET_UPDATE', 'ALERT_UPDATE', 'AUTO_REPLY' Can only be changed if all translations are still in status DRAFT.
`translations`	array	An array of translations with the following JSON structure. language and body_text are mandatory. Header parameter depend on the header type: [ "en_US": { "id": 12345, <- ID of existing translation "language": "en_US", "body_text": "Text of the notification with parameter {{1}}", "header_type": "TEXT", <- one of TEXT, MEDIA "header_text": "Header text with parameter {{1}}", "header_media_type": "IMAGE", <- one of IMAGE, DOCUMENT, VIDEO, LOCATION "footer_text": "Footer text", "buttons": [ { <- up to 3 QUICK_REPLY buttons OR a URL and/or PHONE_NUMBER button "id": 12345, <- ID of existing button "type": "QUICK_REPLY", <- one of QUICK_REPLY, URL, PHONE_NUMBER "text": "Button caption", <- "url": "https://foo.com/{{1}}", <- only for type URL. Parameter is optional. "phone_number": "0123456789", <- only for type PHONE_NUMBER } ], "sample": { <- sample data that helps WhatsApp in reviewing the template "body_variables": [ <- one for each used body variable "My variable 1", ], "header_media": "URL of media file", "header_variable": "My header variable", "button_variable": "Variable for dynamic URL button", }, }]
`visible_for_agents`	bool	In-App visibility of the template

Request

Response

GET Validate template name `/templates/{name}/validate-name`

https://rest.messengerpeople.com/api/v15/templates/{name}/validate-name

Check if a template name is not in use

Parameter	Value	Type	Description
`name`		string	The name of the template

Request

Response

GET Get template status `/templates/{name}/review`

https://rest.messengerpeople.com/api/v15/templates/{name}/review

Get the review status for each language of the template

Parameter	Value	Type	Description
`name`		string	The name of the template

Request

Response

PUT Submit for Review `/templates/{name}/review`

https://rest.messengerpeople.com/api/v15/templates/{name}/review

Submit all translations in status DRAFT to WhatsApp for review. Except those which are marked as skipped

Parameter	Type	Description
`id`	integer	The id of the template
`name`	string	The name of the template. Can only be changed if all translations are still in status DRAFT.
`category`	string	The category of the template Valid values: 'ACCOUNT_UPDATE', 'PAYMENT_UPDATE', 'PERSONAL_FINANCE_UPDATE', 'SHIPPING_UPDATE', 'RESERVATION_UPDATE', 'ISSUE_RESOLUTION', 'APPOINTMENT_UPDATE', 'TRANSPORTATION_UPDATE', 'TICKET_UPDATE', 'ALERT_UPDATE', 'AUTO_REPLY' Can only be changed if all translations are still in status DRAFT.
`translations`	array	An array of translations with the following JSON structure. language and body_text are mandatory. Header parameter depend on the header type: [ "en_US": { "id": 12345, <- ID of existing translation "skip": true, <- skip this translation from review "language": "en_US", "body_text": "Text of the notification with parameter {{1}}", "header_type": "TEXT", <- one of TEXT, MEDIA "header_text": "Header text with parameter {{1}}", "header_media_type": "IMAGE", <- one of IMAGE, DOCUMENT, VIDEO, LOCATION "footer_text": "Footer text", "buttons": [ { <- up to 3 QUICK_REPLY buttons OR a URL and/or PHONE_NUMBER button "id": 12345, <- ID of existing button "type": "QUICK_REPLY", <- one of QUICK_REPLY, URL, PHONE_NUMBER "text": "Button caption", <- "url": "https://foo.com/{{1}}", <- only for type URL. Parameter is optional. "phone_number": "0123456789", <- only for type PHONE_NUMBER } ], "sample": { <- sample data that helps WhatsApp in reviewing the template "body_variables": [ <- one for each used body variable "My variable 1", ], "header_media": "URL of media file", "header_variable": "My header variable", "button_variable": "Variable for dynamic URL button", }, }]
`visible_for_agents`	bool	In-App visibility of the template

Request

Response

GET Get translation `/templates/{name}/translations/{lang}`

https://rest.messengerpeople.com/api/v15/templates/{name}/translations/{lang}

Get the definition of a template translation

Parameter	Value	Type	Description
`name`		string	The name of the template
`lang`		string	The language of the translation

Request

Response

GET Get translation status `/templates/{name}/translations/{lang}/review`

https://rest.messengerpeople.com/api/v15/templates/{name}/translations/{lang}/review

Get the review status for a single translation of a template

Parameter	Value	Type	Description
`name`		string	The name of the template
`lang`		string	The language of the translation

Request

Response

DELETE Delete `/templates/{name}`

https://rest.messengerpeople.com/api/v15/templates/{name}

Delete a template with all its translations. Note: You can not use the name of the deleted template to create a new one until the deletion is processed by WhatsApp.

Parameter	Value	Type	Description
`name`		string	The name of the template
`lang`		string	The language of the translation

Request

Response

Statistics

GET Agents `/statistics/agents`

https://rest.messengerpeople.com/api/v15/statistics/agents

Get statistics about all agents starting January 1st 2020.
This feature must be activated by MessengerPeople.
The output contains for each agent:

"Agent Id"
- "absolute_tickets_closed"
  Number of closed tickets
- "absolute_tickets_involved"
  Number of tickets where the agent was involved
- "outgoing_chats_in_ticket"
  Number of sent chat messages in the tickets
- "average_time_active_in_ticket"
  Average time spent for answering the tickets

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET WhatsApp Conversations `/statistics/whatsapp_conversations`

V15

https://rest.messengerpeople.com/api/v15/statistics/whatsapp_conversations

Get information about monthly WhatsApp conversations and costs since February 2022. Costs of the current month are updated every night

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the beginning of the current month
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` Possible values json or csv.

Request

Response

GET KPI Translations /statistics/kpi_translations
https://rest.messengerpeople.com/api/v15/statistics/kpi_translations
Get mapping of KPI names to understandable names in the language of the channel (or English if translation not available)
This method has no parameters.
Request
Response

GET Clicks `/statistics/clicks`

https://rest.messengerpeople.com/api/v15/statistics/clicks

Get statistics about clicks on URLs. Click tracking must be activated

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`source`	string	Optional Filter the source of the URLS used for the clicks. Possible values: chats, content
`order`	string	Optional Default: `time` Output order of the click information in descending order. Possible values: time, clicks
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Automation `/statistics/automation`

https://rest.messengerpeople.com/api/v15/statistics/automation

Get statistics about automation effects like chatbot usage and the amount of time saved by those

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Labels `/statistics/labels`

V14

https://rest.messengerpeople.com/api/v15/statistics/labels

Get statistics about labels (tags) assigned to tickets.
Output example (note that an entry can have an empty body if no labels where used in this period):

{  
  "1606076985": { <- timestamp  
    "9482": { <- label id  
      "id": 9482, <- label id  
      "label": "example_label", <- label name  
      "color": "FF9300", <- label color HEX value  
      "count": 42 <- usage count for this period  
    }, ...  
  }  
}

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`interval`	string	Optional Default: `days` V14 Unit of period interval, expected values: days, weeks
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Notifications `/statistics/notifications`

https://rest.messengerpeople.com/api/v15/statistics/notifications

Get statistics of all sent notifications. The output contains:

template
Name of the notification template
total
Number of notification sent (regardless of the status)
total_sent
Number of notifications sent (without failures)
total_failed
Number of notifications failed sending
total_undelivered
Number of notifications sent, but not jet received by the recipient
total_delivered
Number of notifications sent and received by the recipient
total_read
Number of notifications sent and read by the recipient

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Content `/statistics/content`

https://rest.messengerpeople.com/api/v15/statistics/content

Get statistics about the number of reached users starting December 7th 2019. The numbers are unique users per interval.

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`interval`	string	Unit of period interval, expected values: days, weeks, months
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Chat `/statistics/chats`

https://rest.messengerpeople.com/api/v15/statistics/chats

Get overall statistics of chat messages

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET MAU Details `/statistics/mau_details`

https://rest.messengerpeople.com/api/v15/statistics/mau_details

Get detailed statistics of monthly active users including time of first and last chat of each user in the period.

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`period`	string	Optional Default: `invoicing_period` Period of invoice, expected values: invoicing_period, last_invoicing_period If set, this will overrule the parameters 'from' and 'to'
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET MAU `/statistics/mau`

https://rest.messengerpeople.com/api/v15/statistics/mau

Get statistics of monthly active users optionally grouped by messenger.

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`period`	string	Optional Default: `invoicing_period` Period of invoice, expected values: invoicing_period, last_invoicing_period If set, this will overrule the parameters 'from' and 'to'
`by_messenger`	bool	Optional Default: `false` Group monthly active users by messenger
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Bot `/statistics/bot`

https://rest.messengerpeople.com/api/v15/statistics/bot

Get statistics on incoming messages that are answered by the bot.

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Custom `/statistics/custom`

https://rest.messengerpeople.com/api/v15/statistics/custom

Get detailed statistics of different KPIs for tickets and chats

Parameter	Type	Description
`from`	int	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	int	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`kpi`	string	Optional Return only the given KPI, run without to see all KPIs
`source`	string	Specify the source of the statistics, expected values: chats, tickets
`interval`	string	Unit of period interval, expected values: hours, days, weeks
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Tickets `/statistics/tickets`

https://rest.messengerpeople.com/api/v15/statistics/tickets

Get statistics of ticket usage

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET Chatblocks `/statistics/chat_blocks`

V14

https://rest.messengerpeople.com/api/v15/statistics/chat_blocks

Get usage statistics of chatblocks including number of user answers

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the last 30 days
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET RCS provider `/statistics/rcs_provider`

https://rest.messengerpeople.com/api/v15/statistics/rcs_provider

Get statistics about the number of RCS user grouped by provider

Parameter	Type	Description
`from`	integer	Optional Default: `0` UNIX timestamp of the start of the period, defaults to the timestamp of 2021-09-01
`to`	integer	Optional Default: `0` UNIX timestamp of the end of the period, defaults to now
`output_format`	string	Optional Default: `json` Possible values json or csv.

Request

Response

Statistics (old)

GET Number of Users /stats
https://rest.messengerpeople.com/api/v15/stats
Get current number of users with MIA activation info and number of new users today
This method has no parameters.
Request
Response

GET Ticket `/stats/ticket`

https://rest.messengerpeople.com/api/v15/stats/ticket

Get overall statistics about tickets

Parameter	Value	Type	Description
`current`		boolean(0/1)	Optional Default: `0` Specifies whether only current values tickets_unassigned_total, tickets_open_total, tickets_open_answered and tickets_open_unanswered are listed which makes the call much faster.

Request

Response

GET Ticket Details `/stats/ticketdetails`

https://rest.messengerpeople.com/api/v15/stats/ticketdetails

Get detailed statistics about tickets.
The following statistics data is provided for each time period:

opened: the number of opened tickets
closed: the number of closed tickets
average_opened: the average number of open tickets during the whole period
average_answer_time: the average response time for answers sent
average_close_time: the average time until a ticket is closed
average_answers: the average number of answers in closed tickets

The maximum number of listed tickets is 10000

Parameter	Type	Description
`unit`	string	Optional Default: `days` Specifies the unit of the result. Possible values are hours, days, weeks.
`start`	integer	Optional UNIX timestamp of the day/hour at which to start the statistics. Default: Current day for hour statistics, 30 days ago for days or weeks
`end`	integer	Optional UNIX timestamp at which to end the statistics. Default: current time
`output_format`	string	Optional Default: `json` V14 Possible values json or csv.

Request

Response

GET User `/stats/user`

https://rest.messengerpeople.com/api/v15/stats/user

Get user statistics with MIA activation information for each period. Also for all used messenger.

Parameter	Type	Description
`days`	boolean(0/1)	Optional Default: `1` Specifies whether day statistics should be returned. Default: 1 unless hour is set.
`hours`	boolean(0/1)	Optional Default: `0` Specifies whether hour statistics should be returned.
`start`	integer	Optional UNIX timestamp of the day/hour at which to start the statistics. Default: Current day for hour statistics, 30 days ago for days
`end`	integer	Optional UNIX timestamp at which to end the statistics. Default: current time
`output_format`	string	Optional Default: `json` Possible values json or csv.

Request

Response

GET Chat `/stats/chat`

https://rest.messengerpeople.com/api/v15/stats/chat

Get chat statistics with number of incoming and outgoing messages and number of chatting users for each period

Parameter	Type	Description
`days`	boolean(0/1)	Optional Default: `1` Specifies whether day statistics should be returned. Default: 1 unless hour is set.
`hours`	boolean(0/1)	Optional Default: `0` Specifies whether hour statistics should be returned.
`start`	integer	Optional UNIX timestamp of the day/hour at which to start the statistics. Default: Current day for hour statistics, 30 days ago for days
`end`	integer	Optional UNIX timestamp at which to end the statistics. Default: current time
`bot`	boolean(0/1)	Optional Default: `0` V5 Include bot statistics.
`weeks`	boolean(0/1)	Optional Default: `0` V5 Include additional week statistics.

Request

Response

Entities

GET Entity `/entity/{id}`

https://rest.messengerpeople.com/api/v15/entity/{id}

Get ID, name and attributes of entities.

Parameter	Value	Type	Description
`id`		integer	Optional The entity ID.

Request

Response

GET Data `/entity/{id}/data/{data_id}`

https://rest.messengerpeople.com/api/v15/entity/{id}/data/{data_id}

Get entity data instances

Parameter	Value	Type	Description
`id`		integer	The entity ID
`data_id`		integer	Optional The entity data instance ID

Request

Response

POST Data `/entity/{id}/data/{data_id}`

https://rest.messengerpeople.com/api/v15/entity/{id}/data/{data_id}

Update or create an entity data instance

Parameter Value Type Description

id

integer

The entity ID

data_id

integer

Optional

The entity data instance ID, if the id is missing a new instance is created.

data

json

JSON with identifiers and attribute/value pairs for the object. Attributes which are not defined for the entity are ignored.
The keywords which identify the entitiy (in a message) are collected in the identifiers array. A keyword must not contain a ",".
Example:

{  
"identifiers": [  "john", "doe" ],  
"name": "John Doe",  
"mail": "[email protected]"  
}

Request

Response

DELETE Data `/entity/{id}/data/{data_id}`

https://rest.messengerpeople.com/api/v15/entity/{id}/data/{data_id}

Delete an entity data instance

Parameter	Value	Type	Description
`id`		integer	The entity ID
`data_id`		integer	Optional The entity data instance ID

Request

Response

Widget Info

GET Widget `/widget_info`

https://rest.messengerpeople.com/api/v15/widget_info

Widget definition including all information for displaying the widget

Parameter	Value	Type	Description
`id`		integer	Optional V3 The widget ID. If omitted list all widgets.

Request

Response

POST Widget `/widget_info`

https://rest.messengerpeople.com/api/v15/widget_info

Create a new widget

Parameter	Type	Description
`name`	string	The widget name.
`widget_type_id`	integer	Optional The type ID of the widget
`title`	string	Optional The widget title
`body`	string	Optional The widget body text
`privacy_check`	boolean(0/1)	Optional Specifies whether a privacy check is displayed.
`privacy_text`	string	Optional The widget privacy text.
`privacy_link`	string	Optional The widget privacy link.
`messengers`	json	Optional Requires JSON with a list of messengers used in the widget. info and link_text are optional Example: `[ { "id": "WA", "link_text": "Please save the number", "info": "Please add the number to your contacts" } ]`
`settings`	json	Optional Requires JSON with a list of settings used in the widget. requires id and value Example: `[ { "id": 1, "value": "FFFFAA" }, { "id": 5, "value": 14 } ]`
`language`	string	Optional V7 Wdiget language. Per default the channel language is used. `de`, `en`, `es`, `fr`, `it`, `nl`, `pl`, `pt`, `ru`, `ar`, `tr`, `hr` and `jp`

Request

Response

PUT Widget `/widget_info/{id}`

https://rest.messengerpeople.com/api/v15/widget_info/{id}

Update a widget

Parameter	Type	Description
`id`	integer	The widget ID
`name`	string	Optional The widget name
`widget_type_id`	integer	Optional The type ID of the widget
`title`	string	Optional The widget title
`body`	string	Optional The widget body text
`privacy_check`	boolean(0/1)	Optional Specifies whether a privacy check is displayed.
`privacy_text`	string	Optional The widget privacy text
`privacy_link`	string	Optional The widget privacy link
`messengers`	json	Optional Requires JSON with a list of messengers used in the widget. info, link_text and sequence are optional Example: `[ { "id": "WA", "link_text": "Please save the number", "info": "Please add the number to your contacts", "sequence": 1, } ]`
`settings`	json	Optional Requires JSON with a list of settings used in the widget. requires id and value Example: `[ { "id": 1, "value": "FFFFAA" }, { "id": 5, "value": 14 } ]`
`language`	string	Optional V7 Wdiget language. Per default the channel language is used. `de`, `en`, `es`, `fr`, `it`, `nl`, `pl`, `pt`, `ru`, `ar`, `tr`, `hr` and `jp`

Request

Response

DELETE Widget `/widget_info`

https://rest.messengerpeople.com/api/v15/widget_info

Delete a widget

Parameter	Value	Type	Description
`id`		integer	The widget ID

Request

Response

GET Widget Settings `/widget_info/settings`

https://rest.messengerpeople.com/api/v15/widget_info/settings

The available widget configuration with all settings for the messengers used in the channel.

Parameter	Value	Type	Description
`language`		string	Optional V7 Wdiget language. Per default the channel language is used. `de`, `en`, `es`, `fr`, `it`, `nl`, `pl`, `pt`, `ru`, `ar`, `tr`, `hr` and `jp`

Request

Response

POST Widget Setting `/widget_info/settings`

https://rest.messengerpeople.com/api/v15/widget_info/settings

Create a new widget setting

Parameter	Value	Type	Description
`name`		string	The widget setting name
`type`		string	Optional Default: `string` The data type of the setting. Possible values are `int`, `boolean`, `float`, `string`, `color`.

Request

Response

PUT Widget Setting `/widget_info/settings/{id}`

https://rest.messengerpeople.com/api/v15/widget_info/settings/{id}

Update a widget setting

Parameter	Type	Description
`id`	integer	The setting ID
`name`	string	Optional The setting name
`type`	string	Optional Default: `string` The data type of the setting. Possible values are `int`, `boolean`, `float`, `string`, `color`.

Request

Response

DELETE Widget Setting `/widget_info/settings/{id}`

https://rest.messengerpeople.com/api/v15/widget_info/settings/{id}

Delete widget setting

Parameter	Value	Type	Description
`id`		integer	The setting ID

Request

Response

ticket

GET Details `/ticket/{id}`

https://rest.messengerpeople.com/api/v15/ticket/{id}

Get information about a ticket or list all tickets

Parameter	Type	Description
`id`	mixed	Optional The ticket ID or user_id. Multiple ids can be separated by comma. If a user_id is specified the last ticket of that user is returned.
`limit`	integer	Optional Default: `500` The number of results. The maximum is 500 if chats of the tickets are listed or 5000 if no chats are listed.
`offset`	integer	Optional The number of tickets skipped in the result set.
`order`	string	Optional Default: `id` Order the results by that field. Valid fields are 'id', 'closed', 'created', 'status', 'messenger', 'waiting_since', 'label_names', 'agent', 'last_chat', 'last_in', 'last_out'.
`asc`	boolean(0/1)	Optional Default: `1` Define whether to order the resulting tickets descending or ascending.
`status`	integer	Optional The status of the tickets. 0 for closed tickets, 1 for opened tickets
`my`	boolean(0/1)	Optional Default: `0` List only tickets assigned to the calling agent or her team.
`user_id`	mixed	Optional The ID of a user or comma-separated list of IDs.
`agent_id`	mixed	Optional The ID of an agent or comma-separated list of IDs.
`label`	mixed	Optional The ID of a label or comma-separated list of IDs.
`bot`	boolean(0/1)	Optional Default: `1` List bot chat messages of the ticket.
`search`	string	Optional V6 A filter for searching tickets. Searches can be performed for ticket numbers, user ids, text in chat and notes. Only tickets of users are listed that match the search filter.
`messenger`	string	Optional V8 A filter for listing only tickets of users with this messenger. Valid values are 'WA', 'WB', 'FB', 'TG', 'IN', 'IM', 'VI', 'IG', 'RC. (WA and WB are synonyms)
`num_chats`	integer	Optional Default: `100000` V6 The maximum number of chats that are listed for each ticket .
`waiting_since`	string	Optional V7 A filter for listing only open tickets that are waiting since the specified time. Format: 0 for getting all answered, 1 for getting all unanswered tickets or from-to, e.g. 0-1552389233 or 1552389233-0 .
`notes`	boolean(0/1)	Optional Default: `1` V7 Set to 0 to avoid listing notes of the ticket(s) when ID is not specified.
`new`	boolean(0/1)	Optional Default: `0` V7 List only new open tickets that have not been answered yet.
`newsletter`	boolean(0/1)	Optional Default: `0` V12 Include MIA content to the chat list of the tickets.
`customfields`	boolean(0/1)	Optional Default: `0` V13 Include custom fields of the user to tickets.
`closed_in`	string	Optional V13 A filter for listing only closed tickets that are closed within the specified time. Format: from-to, e.g. 0-1552389233 or 1552389233-0 .
`last_chat`	boolean(0/1)	Optional Default: `0` V13 Include timestamps (last_in/last_out) for last inbound and outbound chat
`postponed_only`	boolean(0/1)	Optional Default: `0` V14 Only show postponed tickets
`hide_postponed`	boolean(0/1)	Optional Default: `0` V14 Hide tickets that are postponed to the future

Request

Response

GET Get ticket history `/ticket/{user_id}/ticket_history`

https://rest.messengerpeople.com/api/v15/ticket/{user_id}/ticket_history

Get all closed tickets of a given user

Parameter	Value	Type	Description
`user_id`		mixed	The ID of the user

Request

Response

GET Channel Events /ticket/channel_events
V15
https://rest.messengerpeople.com/api/v15/ticket/channel_events
Get information about events in other channels that happened after logging into those channels. Events are information about new chat messages or ticket assignments. A dispatcher gets additional events about new un-assigned tickets. The call is only available for logged-in agents or dispatchers.
This method has no parameters.
Request
Response

PUT Open `/ticket/{id}/open`

https://rest.messengerpeople.com/api/v15/ticket/{id}/open

Get the open ticket for a user or create and open a ticket for the user

Parameter	Value	Type	Description
`id`		integer	The ID of a user.

Request

Response

PUT Close `/ticket/{id}/close`

https://rest.messengerpeople.com/api/v15/ticket/{id}/close

Close a ticket

Parameter	Type	Description
`id`	integer	The ID of a ticket or a user.
`note`	string	Optional Add a note. Only possible if called by an agent.
`batch_ids`	mixed	Optional V13 Array or comma-separated list of ticket ids. Use instead of the id parameter.
`label_ids`	mixed	Optional V14 Array or comma-separated list of labels.

Request

Response

PUT Update `/ticket/{id}`

https://rest.messengerpeople.com/api/v15/ticket/{id}

Assign an agent or team to a ticket or remove the assignment. Or postpone a ticket or mark as answered.

Parameter	Type	Description
`id`	integer	The ID of a ticket or a user.
`agent_id`	integer	Optional The ID of an agent, to sign this ticket to.
`team_id`	integer	Optional The ID of a team, to assign this ticket to.
`agent_email`	string	Optional V12 The email address of an agent, to assign this ticket to. Only works if agent id and team id are not set.
`bot_active`	boolean(0/1)	Optional V6 Set if you want to activate or deactivate the chatbot for a ticket. Only relevant if the chat for the ticket is locked.
`waiting_since`	int(1)	Optional V7 Mark a ticket as answered even if the user send the last chat by setting waiting_since to 0.
`batch_ids`	mixed	Optional V13 Array or comma-separated list of ticket ids. Use instead of the id parameter.
`postponed`	int	Optional V14 Timestamp to postpone the ticket(s) to.

Request

Response

PUT Label `/ticket/{id}/label/{label_id}`

https://rest.messengerpeople.com/api/v15/ticket/{id}/label/{label_id}

Assign a label to a ticket.
Since Version 13 you can update the label settings of multiple tickets by using batch_ids and label_ids instead of id and label_id.

Parameter	Type	Description
`id`	integer	Optional The ID of a ticket or a user
`label_id`	integer	Optional The ID of a label
`batch_ids`	mixed	Optional V13 Array or comma-separated list of ticket ids. Use instead of the id parameter.
`label_ids`	mixed	Optional V13 Array or comma-separated list of label ids. Use instead of the label_id parameter.

Request

Response

DELETE Label `/ticket/{id}/label/{label_id}`

https://rest.messengerpeople.com/api/v15/ticket/{id}/label/{label_id}

Delete assignment of a label to a ticket

Parameter	Value	Type	Description
`id`		integer	The ID of a ticket or a user
`label_id`		integer	Optional The ID of a label

Request

Response

POST Note `/ticket/{id}/note`

https://rest.messengerpeople.com/api/v15/ticket/{id}/note

Add a note to a ticket

Parameter	Type	Description
`id`	integer	The ID of a ticket
`note`	string	The note text
`agent_id`	integer	Optional Agent ID to use instead of the currently logged-in agent's ID

Request

Response

PUT Note `/ticket/{id}/note/{note_id}`

https://rest.messengerpeople.com/api/v15/ticket/{id}/note/{note_id}

Update a note of a ticket

Parameter	Type	Description
`id`	integer	The ID of a ticket
`note_id`	integer	The ID of a note to update
`note`	string	The updated note text

Request

Response

DELETE Note `/ticket/{id}/note/{note_id}`

https://rest.messengerpeople.com/api/v15/ticket/{id}/note/{note_id}

Deletes a note of a ticket

Parameter	Value	Type	Description
`id`		integer	The ID of a ticket
`note_id`		integer	The ID of a note to update

Request

Response

GET Statistics `/ticket/statistics`

https://rest.messengerpeople.com/api/v15/ticket/statistics

Get detailed statistical information on the specified ticket or all tickets created in the specified range and return them in csv format

TicketID: the ticket number
Username: the name of the user
Agent: the name of the current assigned agent
Created: the creation time of the ticket
Assigned: the time when the ticket has been assigned to the current agent
Closed: the time when the ticket has been closed
Forwarded: the time after which the ticket has been forwarded to a different agent
Botmessages: the number of bot messages sent while the ticket was opened or before the ticket was opened
Agentmessages: the number of agent messages sent while the ticket was opened
DurationChatWithBot: the total number of seconds the user had to wait until he got a response from a bot
DurationChatWithAgent: the total number of seconds the user had to wait until he got a response from an agent
TotalAnswerTime: the sum of the answer times both by agent and bot
FirstAgentResponseAfter: the number of seconds until the agents first responded to the user
AverageAgentResponse: the average number of seconds until the agent sent a response to the user considering every answer within the current assigment period.
FirstAnswerAfter: the number of seconds until the very first response to the user

Parameter	Type	Description
`id`	integer	Optional ID of a ticket to get statistics from
`start`	string	Optional UNIX timestamp of the day/hour after which tickets have been created. Default last 24 hours
`end`	string	Optional UNIX timestamp of the day/hour before tickets have been created
`limit`	integer	Optional Default: `500` This is the amount of results that is returned.
`offset`	integer	Optional Default: `0` This is the amount of results skipped in the result set.
`short_stats`	boolean[0\|1]	Optional If specified return only one line for each ticket with information about the last assigned agent even if multiple agents had been assigned.

Request

Response

Tickets

GET Export Ticket PDF `/tickets/{id}/pdf`

https://rest.messengerpeople.com/api/v15/tickets/{id}/pdf

Export PDF file with all ticket relevant data

Parameter	Type	Description
`id`	number	Optional The id of the ticket
`language`	string	Optional Default: `en` The output language. Possible values: 'en', 'de'
`as_link`	boolean(0/1)	Optional Default: `0` Result as JSON with the field pdf linking to a url.
`hidden`	boolean(0/1)	Optional Default: `0` Include internal hidden user properties

Request

Response

agent

GET Profile `/agent/{id}`

https://rest.messengerpeople.com/api/v15/agent/{id}

Get profile information of an agent

Parameter	Value	Type	Description
`id`		integer	Optional The ID of an agent. If omitted list all agents.

Request

Response

POST Create `/agent`

https://rest.messengerpeople.com/api/v15/agent

Create a new agent

Parameter	Type	Description
`email`	string	The email address of the new agent.
`roles`	string	The role(s) of the agent. All agents must have a role. Multiple roles can be separated by `,`
`firstname`	string	Optional The first name of the agent. First name and/or last name must be set.
`lastname`	string	Optional The last name of the agent. First name and/or last name must be set.
`chatname`	string	Optional V15 An alias name of the agent used in the webchat.
`profile_image`	url	Optional URL of the profile image of the agent.
`notification`	boolean(1/0)	Set if the agent should receive email notifications when a ticket is assigned or for new chat messages in assigned tickets.
`all_channels`	boolean(1/0)	Optional Set if the agent has access to all channels.
`channels`	string	Optional One or more channel IDs the agent is assigned to. Will be ignored if all_channels is set.
`active`	boolean(1/0)	V2 Set if the agent is active and is able to work on tickets.
`cc_mail`	string	Optional A second email address that should receive the email with the login information.
`two_factor_userid`	string	Optional V13 A user ID registered in one of the account channels that is used for sending the code during 2-factor authentication

Request

Response

PUT Update `/agent/{id}`

https://rest.messengerpeople.com/api/v15/agent/{id}

Update profile information of an agent

Parameter	Type	Description
`id`	integer	The ID of an agent.
`roles`	string	Optional The role(s) of the agent. All agents must have a role. Multiple roles can be separated by `,`
`firstname`	string	Optional The first name of the agent. First name and/or last name must be set.
`lastname`	string	Optional The last name of the agent. First name and/or last name must be set.
`chatname`	string	Optional V14 An alias name of the agent used in the webchat.
`profile_image`	url	Optional URL of the profile image of the agent.
`notification`	boolean(1/0)	Set if the agent should receive email notifications when a ticket is assigned, for new chat messages in assigned tickets or unassigned tickets for dispatcher.
`notification_delay`	integer	Optional Default: `10` V12 Delay between email notifications in minutes
`active`	boolean(1/0)	V2 Set if the agent is active and is able to work on tickets.
`all_channels`	boolean(1/0)	Optional Set if the agent has access to all channels.
`channels`	string	Optional One or more channel IDs the agent is assigned to. Will be ignored if all_channels is set.
`language`	string	Optional Agent frontend language. Possible values: `en`, `de`, `es`, `fr`, `ar`, `it`
`settings`	json	Optional V3 Requires JSON with any name => value pairs. Example: `{ "setting": "value" }` Delete a setting by setting the value as empty string.
`skills`	json	Optional V5 A JSON array of skill IDs to assign to this agent
`two_factor_userid`	string	Optional V13 A user ID registered in one of the account channels that is used for sending the code during 2-factor authentication

Request

Response

PUT Status `/agent/status`

https://rest.messengerpeople.com/api/v15/agent/status

Set the status of the logged in agent

Parameter Value Type Description

status

integer

Set the current online status for this agent.

0 = offline
1 = online (green)
2 = away / inactive (yellow)
3 = busy (red)

Request

Response

GET Temporary Token /agent/temporary/token
https://rest.messengerpeople.com/api/v15/agent/temporary/token
Get a temporary token for logging in with a second device. The token is valid for 10 minutes. The method is only usable by logged in agents.
This method has no parameters.
Request
Response

PUT Password `/agent/password`

https://rest.messengerpeople.com/api/v15/agent/password

Change the password of the logged in agent

Parameter	Value	Type	Description
`old_password`		password	The old password of the agent
`new_password`		password	The new password of the agent

Request

Response

DELETE Delete `/agent/{id}`

https://rest.messengerpeople.com/api/v15/agent/{id}

Delete an agent. The owner of a customer account cannot be deleted.

Parameter	Value	Type	Description
`id`		integer	The ID of an agent

Request

Response

bot

GET Chat `/bot/chat`

https://rest.messengerpeople.com/api/v15/bot/chat

Get all or a specific bot chat.

Parameter	Value	Type	Description
`id`		integer	Optional The ID of a chat.

Request

Response

GET Bot Topics `/bot/topics`

V15

https://rest.messengerpeople.com/api/v15/bot/topics

Get all bot topics

Parameter	Value	Type	Description
`with_fields`		boolean(0/1)	Optional V7 Check user properties used in api call, condition or chat and list them.
`agent_can_activate`		boolean(0/1)	Optional V15 Filter topics that an agent can or cannot activate.

Request

Response

GET Chatblock `/bot/chatblock`

V15

https://rest.messengerpeople.com/api/v15/bot/chatblock

Get bot answer to be sent as chatblock

Parameter	Value	Type	Description
`id`		integer	Optional The ID of a chatblock. If omitted list all.
`status`		string	Optional Default: `RELEASED` V13 List only bot chats with a specific release status The following values are available: DRAFT, RELEASED, PERSONAL, REJECTED

Request

Response

POST Create Chatblock `/bot/chatblock`

V15

https://rest.messengerpeople.com/api/v15/bot/chatblock

Create a new bot answer to be used as chatblock

Parameter	Type	Description
`name`	string	The name of the bot message that can be sent as chatblock
`message`	string	Optional The text message to be send to the user.
`attachment`	url	Optional The url of the attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx, etc).
`status`	string	Optional The status of the bot message. This parameter is only available to users with appropriate rights. Currently only the values DRAFT and RELEASED are allowed.

Request

Response

PUT Update Chatblock `/bot/chatblock`

V15

https://rest.messengerpeople.com/api/v15/bot/chatblock

Update a bot answer to be used as chatblock.

Parameter	Type	Description
`id`	integer	The ID of the chatblock.
`name`	string	Optional The name of the chatblock.
`message`	string	Optional The text message to be send to the user.
`attachment`	url	Optional The url of the attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx, etc).
`status`	string	Optional The status of the bot message. This parameter is only available to users with appropriate rights. The following values are available: DRAFT, RELEASED and REJECTED

Request

Response

DELETE Delete Chatblock `/bot/chatblock`

V15

https://rest.messengerpeople.com/api/v15/bot/chatblock

Delete a bot answer used as chatblock

Parameter	Value	Type	Description
`id`		integer	The ID of the chatblock.

Request

Response

GET Absence Message `/bot/absence`

https://rest.messengerpeople.com/api/v15/bot/absence

Get bot answer to be sent as absence message

Parameter	Value	Type	Description
`id`		integer	Optional The ID of an absence message. If omitted list all.

Request

Response

POST Create Absence Message `/bot/absence`

https://rest.messengerpeople.com/api/v15/bot/absence

Create a new bot absence message

Parameter	Type	Description
`days`	string	Comma separated list of week days at which the absence message is active. Possible values: `sun`, `mon`, `tue`, `wed`, `thu`, `fri` or `sat`. Alternatively the numbers 0&endash;6.
`start`	string	The start time of the absence period in the format `hh:mm`
`end`	string	The end time of the absence period in the format `hh:mm`
`message`	string	Optional The text message to be send to the user.
`attachment`	url	Optional The url of the attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx, etc).
`status`	boolean(0/1)	Optional Default: `1` Set active (`1`) or inactive (`0`).

Request

Response

PUT Update Absence Message `/bot/absence`

https://rest.messengerpeople.com/api/v15/bot/absence

Update a bot absence message

Parameter	Type	Description
`id`	integer	The ID of an absence message.
`days`	string	Comma separated list of week days at which the absence message is active. Possible values: `sun`, `mon`, `tue`, `wed`, `thu`, `fri` or `sat`. Alternatively the numbers 0&endash;6.
`start`	string	The start time of the absence period in the format `hh:mm`
`end`	string	The end time of the absence period in the format `hh:mm`
`message`	string	Optional The text message to be send to the user.
`attachment`	url	Optional The url of the attachment. The following types/extensions are supported: image (jpg, jpeg, png, gif), video (mp4, m4v, mpg, mpeg, mov, avi), audio (mp3, wav, ogg, opus) or document (pdf, docx, etc).
`status`	boolean(0/1)	Optional Default: `1` Set active (`1`) or inactive (`0`).

Request

Response

DELETE Delete Absence Message `/bot/absence`

https://rest.messengerpeople.com/api/v15/bot/absence

Delete a bot absence message

Parameter	Value	Type	Description
`id`		integer	The ID of an absence message.

Request

Response

Conversational Commerce new in version 15

GET Product `/shop/product/{id}`

V15

https://rest.messengerpeople.com/api/v15/shop/product/{id}

Get a single product of an associated shop. If the id is omitted list products that can be filter by search conditions.

Parameter	Type	Description
`id`	string	Optional The id of a product
`query`	string	Optional A query for searching for products. Mandatory if no id is specified.
`user_id`	string	Optional The user for whom the request is performed. If multiple shops are connected to the channel, the user property __shop can be used to determine the shop.
`only_available`	bool	Optional Default: `false` List only products that are currently available in the shop
`limit`	int	Optional Default: `30` The maximum number of results listed.
`variant_limit`	int	Optional Default: `0` The maximum number of variants listed for each product. The maximum number of results (sum of all product variants) is limited by shopping systems like Shopify so the limits must be kept low.
`offset`	string	Optional Each product list request returns an offset if there more products to list. This offset can be passed to list the next products.

Request

Response

GET Product Variant `/shop/productvariant/{id}`

V15

https://rest.messengerpeople.com/api/v15/shop/productvariant/{id}

Get a single product variant of an associated shop

Parameter	Value	Type	Description
`id`		string	The id of a product variant
`user_id`		string	Optional The user for whom the request is performed. If multiple shops are connected to the channel, the user property __shop can be used to determine the shop.

Request

Response

GET Shopping Cart `/shop/cart`

V15

https://rest.messengerpeople.com/api/v15/shop/cart

Get the shopping cart maintained in MCP.

Parameter	Value	Type	Description
`user_id`		string	The user for whom the request is performed.

Request

Response

POST Add to Shopping Cart `/shop/cart`

V15

https://rest.messengerpeople.com/api/v15/shop/cart

Add a product variant to the shopping cart of a user.

Parameter	Type	Description
`user_id`	string	The user for whom the request is performed.
`variant_id`	string	The id of a product variant that should be added to the cart
`quantity`	int	Optional Default: `1` The number of items to be added

Request

Response

PUT Update Shopping Cart `/shop/cart`

V15

https://rest.messengerpeople.com/api/v15/shop/cart

Uopdate the number of items of a product variant in the shopping cart or add or remove a discount code or a gift card

Parameter	Type	Description
`user_id`	string	The user for whom the request is performed.
`variant_id`	string	Optional The id of a product variant that should be updated in the cart
`quantity`	int	Optional The number of items of the product variant in the cart
`discount_code`	string	Optional A discount code to be applied during checkout. An empty string will remove a stored code.
`gift_card`	string	Optional A gift card to be applied during checkout. An empty string will removed the stored gift cards. Multiple gift cards can be separated by ,

Request

Response

DELETE Delete Shopping Cart `/shop/cart`

V15

https://rest.messengerpeople.com/api/v15/shop/cart

Delete a product variant from the shopping cart maintained in MCP. Or the whole cart if no variant_id is specified.

Parameter	Value	Type	Description
`user_id`		string	The user for whom the request is performed.
`variant_id`		string	Optional The id of a product variant that should be removed from the cart

Request

Response

POST Checkout Shopping Cart `/shop/checkout`

V15

https://rest.messengerpeople.com/api/v15/shop/checkout

Checkout the shopping cart of a user. This will create a cart in the shopping system and the cart in MCP cannot be modified anymore.

Parameter	Value	Type	Description
`user_id`		string	The user for whom the request is performed.

Request

Response

GET Order `/shop/order`

V15

https://rest.messengerpeople.com/api/v15/shop/order

Get an order.

Parameter	Type	Description
`id`	string	The order id or number.
`user_id`	string	Optional The user for whom the request is performed. If multiple shops are connected to the channel, the user property __shop can be used to determine the shop.
`filter`	string	Optional The email or zip code. An order is only listed if email or zip code matches
`language`	string	Optional The language used for the translated status of the order and fullfillments. Default is the channel language.

Request

Response

GET Orders `/shop/orders`

V15

https://rest.messengerpeople.com/api/v15/shop/orders

Get all orders of a user that are known in MCP.

Parameter	Value	Type	Description
`user_id`		string	Optional The user for whom the request is performed.
`language`		string	Optional The language used for the translated status of the order and fullfillments. Default is the channel language.

Request

Response

GET Configuration /shop/config
V15
https://rest.messengerpeople.com/api/v15/shop/config
Get the shop configuration and connection parameters for the supported shop types.
This method has no parameters.
Request
Response

POST Create Configuration `/shop/config`

V15

https://rest.messengerpeople.com/api/v15/shop/config

Create the shop configuration or add a shop.

Parameter	Type	Description
`shop_type`	string	Optional The type of shop, possible values are Shopify, Shopware and Shopware5. The type cannot be changed if shops are existing
`shop`	string	Optional The name of a shop.
`token`	string	Optional The access token to the admin API of a Shopify shop
`storefront_token`	string	Optional The access token to the storefront API of a Shopify shop
`shop_url`	string	Optional The URL accessing a Shopware/Shopware5 shop
`sw_access_token`	string	Optional The access token for accessing a Shopware shop
`client_id`	string	Optional The client ID for accessing a Shopware/Shopware5 shop
`client_secret`	string	Optional The client secret for accessing a Shopware/Shopware5 shop

Request

Response

DELETE Delete Configuration `/shop/config`

V15

https://rest.messengerpeople.com/api/v15/shop/config

Delete a shop or the whole shop configuration if no shop is specified.

Parameter	Value	Type	Description
`shop`		string	Optional The name of the shop.

Request

Response

accounting

GET Account Profile /accounting
https://rest.messengerpeople.com/api/v15/accounting
Get account profile like address and payment of the customer account
This method has no parameters.
Request
Response

PUT Update Account Profile `/accounting`

https://rest.messengerpeople.com/api/v15/accounting

Update address and payment information of the customer account

Parameter	Type	Description
`company`	string	Name of the company
`firstname`	string	The first name of the account holder
`lastname`	string	The last name of the account holder
`addressline1`	string	The street address of the company
`addressline2`	string	Optional The second line for the street address of the company
`zip`	string	The ZIP/postal code of the company1
`city`	string	The city of the company
`vertical`	string	The vertical of the company
`employees`	string	The number of employees
`country`	string	Optional The ISO-3166-1 country code for the company
`invoice_email`	string	The main email address to receive invoices
`invoice_email2`	string	Optional The first backup email address to receive invoices
`invoice_email3`	string	Optional The second backup email address to receive invoices
`vat`	string	Optional The VAT ID of the company
`payment_method`	string	Optional The name of the payment method used
`iban`	string	Optional Your IBAN, no whitespaces
`bic`	string	Optional Your BIC/SWIFT-Code
`account_holder`	string	Optional The owner of the bank account, e.g. your company-name. Alphanumeric characters only, max. 27 characters

Request

Response

GET Pricing /accounting/pricing
https://rest.messengerpeople.com/api/v15/accounting/pricing
Get package pricing
This method has no parameters.
Request
Response

PUT Book Package `/accounting/pricing`

https://rest.messengerpeople.com/api/v15/accounting/pricing

Book a package

Parameter	Value	Type	Description
`package_id`		integer	The ID of the package to book.

Request

Response

GET Costs /accounting/costs
https://rest.messengerpeople.com/api/v15/accounting/costs
Get current costs
This method has no parameters.
Request
Response
GET Bot Module /accounting/botmodule
https://rest.messengerpeople.com/api/v15/accounting/botmodule
Get available bot modules
This method has no parameters.
Request
Response

PUT Update Bot Module `/accounting/botmodule`

https://rest.messengerpeople.com/api/v15/accounting/botmodule

Activate or deactivate bot modules.

Parameter	Value	Type	Description
`modules`		json	Optional A JSON array with modules, their activation status and roles that see the module e.g. {"mood":{"active": true, "roles": ["admin"]}, "translation": {"active": false}}

Request

Response

GET Additional Info /accounting/info
https://rest.messengerpeople.com/api/v15/accounting/info
Get additional account info like acception of WhatsApp policies or 2-factor authentication
This method has no parameters.
Request
Response

PUT Update Additional Info `/accounting/info`

https://rest.messengerpeople.com/api/v15/accounting/info

Update additional account info like accepting WhatsApp policies or setting up 2-factor authentication

Parameter	Type	Description
`wa_policies_accepted`	boolean(0/1)	Optional Set to 1 if the WhatsApp policies have been accepted.
`two_factor_authentication`	boolean(0/1)	Optional V13 Set to 1 if the 2-factor authentication is required.
`two_factor_template`	string	Optional V13 The name of a WhatsApp notification template used for sending a verification code.
`two_factor_channel`	int	Optional V13 The ID of the channel used for sending a verification code. Per default the first channel of the account is used.
`two_factor_email`	boolean(0/1)	Optional V13 Set to 1 if the authentication email should be sent to all agents after activating it.

Request

Response

Data Protection Agreement (DPA)

GET Information /dpa
https://rest.messengerpeople.com/api/v15/dpa
Get information about the current data protection contract
This method has no parameters.
Request
Response

GET Download `/dpa/contract`

https://rest.messengerpeople.com/api/v15/dpa/contract

Download your DPA contract as PDF

Parameter	Type	Description
`latestDraft`	bool	Get latest version of the contract as unsigned PDF
`type`	string	The product type to get the contract, expected values: map, mcp
`language`	string	The language of the contract, expected values: en, de

Request

Response

PUT Update `/dpa`

https://rest.messengerpeople.com/api/v15/dpa

Update contract information like company address and language

Parameter	Type	Description
`company`	string	The name of the company
`addressLine1`	string	The address of the company
`addressLine2`	string	Optional second address line
`city`	string	The city of the company
`zip`	string	The zip code of the company
`language`	string	The language of the contract, expected values: en, de

Request

Response

PUT Sign `/dpa/sign`

https://rest.messengerpeople.com/api/v15/dpa/sign

Sign the latest version of the contract

Parameter	Type	Description
`name`	string	The name of the signatory
`email`	string	The email address of the signatory
`authorization`	bool	Confirm to be authorized to sign the contract for your company
`confirmation`	bool	Confirm that you have read and understood the contract

Request

Response

Release Notes

Version 16

USER/PROPERTY GET output field limited_access changed to agent_visible, hidden and default_value field added
USER/CATEGORIES GET/PUT removed. Use GET/PUT /user/PROPERTY instead
USER GET when reading single user: placeholder output removed, customfields only with id and value. last_update instead of time. profile substructure removed
USER GET when listing multiple user: last_update added to customfields
USER GET csv export: The name and properties are no longer ISO-8856-1 encoded (leading to ? instead of other characters but left as they are)
LOGIN POST The channel list does not include channel details of the active channel any more
AGENT/ME GET Gets current logged in agent information, like the response of Login Post
AGENT/TWOFACTOR GET/POST/PUT/DELETE Two-factor status, activating, reactivating and deactivating
CHANNEL/CHATS, CHAT, TICKET GET author information added to chat
TICKET/OPEN PUT new parameter reopen

Version 15

USER POST when creating a user (also by sending a notification) the user is now deactivated for MIA
STATISTICS/WHATSAPP_CONVERSATIONS GET added
CHANNEL/INVOICES GET added invoice_type field (credit_note / invoice).
BOT GET/PUT removed
STATS/TICKET GET Added new parameter current.
CUSTOM GET Added new output values. agent_visible replacing limited_access and hidden for values that should not be displayed in user interfaces.
CUSTOM POST/PUT agent_visible replacing limited_access and new parameter hidden for values that should not be displayed in user interfaces.
TARGETING/USER GET added parameter query
TICKETS/PDF GET added parameter as_link and hidden, hidden user properties are only included if hidden is set
USER GET Change last_chat to both incoming and outgoing messages. Add last_in and last_out for specific output and sorting. Unread for getting additional information in channels without tickets.
USER PUT New parameter for setting whether messages are read. agent and add/removelabel fields are deprecated.
NEWSLETTER all endpoints removed
CHAT/NOTIFICATION POST Removed deprecated parameters notification, parameters and language
LOGIN POST removed parameter channel_type, permit email adress in parameter two_factor_userid
USER/NOTE POST removed
CHAT GET added chat meta information like send_error for failed sending
CONTENT GET if clicks are returned only messengers are listed that have clicks
CONTENT GET added filter "today" to get published and scheduled content of today
CHANNEL GET/PUT removed parameter/output katnachricht, katnachricht_link, promo, notify_installed, notify_installed_answer, use_content_notifications, use_menu
CHANNEL GET/PUT added parameter ticket_for_instagram_story and multi_channel_events
CHANNEL/CHATS GET keep sorting by chattime descending if the start parameter is used. New parameter chattime to filter chats after that time. Chat output list as array
CHANNEL/ONLINE_AGENTS GET added parameter other_channels to list online agents from other channels.
CONTENT POST/PUT removed parameter promo and deprecated parameters wb_notification, wb_notification_parameters and wb_notification_language
CONTENT POST/PUT added parameter targeting_query
CONTENT/STOPINTERACTION PUT removed
TEMPLATES/VALIDATE-NAME GET return json if the name is valid
STATS/NEWSLETTER GET removed
STATS/CONTENT GET removed
STATS/BOT GET removed
STATISTICS/KPI_RULES GET removed
STATISTICS/RCS_PROVIDER GET added
BOT/MENU removed
BOT/MENUITEM removed
BOT/MANUALANSWER renamed to chatblock
BOT/TOPICS GET added
AGENT POST chatname added
GDPR removed

Version 14

LOGIN POST Some response data has been removed that can be fetched with single requests. Here is a list of the removed properties and their corresponding endpoints:
- agents: /agent?open_tickets=1
- available_languages: /internal/translation
- customer_info: /accounting/info
- news: /internal/news
- stats: /stats/ticket
MESSENGER WhatsApp Setup POST/GET New parameter "setup_contact_type" and "setup_contact" to get informed about the setup process
ACCOUNTING Info GET Added all the info you previouslygot in the "customer_info" property from the login request
TRANSLATION GET Added a list of our available languages to the response of the translations request
TICKET Removed ticket stats property from all responses
USER Removed ticket stats property from all responses
CHANNEL Removed categories_auto_subscribe. Category subscription can be set as default value of the custom variable
CONTENT POST/PUT Added Buttons to Content
STATISTICS/LABELS GET Added label (tag) statistics
STATISTICS GET Added new parameter output_format csv
STATISTICS Tickets GET Removed KPIs average_chats_when_ticket_closed and average_duration_until_followup_agent_reactions
CHANNEL new property mandatory_label_on_ticket_close
STATISTICS KPI_Translations GET added
USER GET Added new parameter output_format csv
CONTENT/TARGETING GET new endpoint replacing NEWSLETTER/TARGETING
TARGETING/COUNT GET new endpoint replacing NEWSLETTER/TARGETING with count
MESSENGER GET New standard attribute caption for all messengers with a caption
AGENT New attribute and parameter chatname
USER POST for creating a WhatsApp Business user
CUSTOM GET new property hidden_in_ui for internally used properties
CHAT/BOT POST new parameter user_filter

Version 13

TICKET PUT Details/Close: New parameter "batch_ids" perform action on multiple tickets in one call
Agent PUT/GET Data: Removed field settings allows to store any agent specific settings. notification_endpoints
TICKET GET: Corrected full text search for tickets including now ticket notes
USER GET: New filter parameter to filter users by custom fields or change date of custoenm fields
BOT Manual Answers GET Substituted parameter "filter" with "status" and "personal"
BOT Manual Answers PUT/POST New parameter "status"
BOT Manual Answers PUT All parameters except "id" are optional now
CHAT POST New parameter "user_filter" to perform sending a chat to multiple users by filter instead of user ids
CHAT (NOTIFICATION) POST New parameter "user_filter" to perform sending a notification to multiple users by filter instead of user ids
CHANNEL GET/PUT: New channel setting ticket_auto_close_time
TICKET GET: New parameter customfields for adding the users customfields to tickets
ACCOUNTING Info PUT/GET: Configuration of two factor authentication
ACCOUNTING Two_Factor_Email PUT: Send email to agents for registering messenger for two factor authentication
AGENT PUT/GET: Configuration of two factor authentication
LOGIN POST: New error code if two factor authentication is active
CONTENT POST: New parameter notification_button_variable
CHAT NOTIFICATION POST: New parameter notification_button_variable
CHANNEL Webhook GET: Added info on last failure and pausing
CHANNEL Webhook GET/PUT: Added webhook fields settings
CHANNEL GET/PUT: New field delete_chat specifying whether agents can delete single chats
CHANNEL GET: New field use_dynamic_chatblocks specifying whether dynamic chat blocks are shown in the user interface
TEMPLATES New endpoints for managing WhatsApp Business message templates

Version 12

TARGETING GET: List settings for a specific targeting list (identified by id) or every targeting list of the current channel
TARGETING PUT: Update a specific targeting list
TARGETING POST: Create a new targeting list
TARGETING DELETE: Remove a targeting list
CHANNEL GET/PUT: New channel settings welcomemessage_mia, welcomemessage_mia_notify, goodbye_message. Removed content_pull_hint, facebook_stop_timeout, notify_stop_timeout, mia_wb_notification, use_menu
USER GET: New field for customfields "time" providing the timestamp of the last value change for the custom field
TICKET GET: New sorting parameter "agents"
TICKET PUT Details: New parameter "agent_email" to assign ticket to an agent by its email address
CONTENT POST/PUT: Parameter "published" now accepts UNIX timestamp format and date strings in the format "YYYY-mm-dd HH:ii"
CONTENT POST/PUT: New parameter "pull_keyword" to set the command that is prefilled in WhatsApp after redirection from Notify
CONTENT POST/PUT: New parameter "wb_notification", "wb_notification_parameters" and "wb_notification_language" for sending a WhatsApp notification as content
CONTENT GET: New field "pull_keyword" providing the ID of the pull command from the command menu
LOGIN POST: New field "next_invoice" under "customer_info", List available roles under "customer_info", removed Whatsapp migration info, data of non-active channel reduced
ACCOUNTING GET: New field "contract_start" giving the unix timestamp of the contract beginning
CHANNEL AGENT GET: List available roles
CHANNEL GET: Removed parameter wa_numbers
CHAT (NOTIFICATION) POST: New parameter batch_ids for sending too many users with improved performance, shorten links if configured for the channel
CHAT (NOTIFICATION) POST: New parameter language. The language is not taken from the users device anymore. If not provided, it defaults to the template's default language. If no default language set, it defaults to the channel language.
CHAT POST: Removed obsolete parameters push and linkpreview. Placeholder syntax like in the bot builer, e.g. $profile_name$
USER GET: The placeholder syntax is adapted to the syntax used in the bot builder
CUSTOM GET/POST/PUT: The default_value ist displayed and can be set

Version 11

CHANNEL GET/PUT: New channel settings. New ticket message for sending an alternative message to a returning customer after he opend a new ticket.
CHANNEL GET/PUT: New channel setting notify_chat. Replaces notify_whatsapp_only.
CHANNEL CONTENT GET New attribute "teaser_to" and "teaser_to_by_messenger" (if detailedReachStats = 1) that tells how many users have received the notification message.
CHANNEL CONTENT POST/PUT/GET New parameter "media_filename" for the original filename of the media file.
CHANNEL GET/PUT: New channel settings. Promo - will save a default promo message
CHANNEL GET: New channel setting: hidden_phone
CONTENT GET/PUT: New content field. Promo - will save a promo message to content and override the promo message in channel
TICKET HISTORY GET New endpoint "get_ticket_history" to get all closed tickets for a given user ID.
TICKET STATISTICS GET New endpoint "get_ticket_statistics" to get detailed statistical information on one or more tickets

Version 10

NOTIFICATIONS: New format for notifications (GET/PUT/POST), due to changes and implementation of Facebook API. Always returns full set of notifications.
BOT Manual Answers: Add ability to store original filename as attachment_filename.
CHANNEL GET/PUT: New channel settings. Channelname is replaced by name. The welcome message for newsletetr channels is stored as bot chat.
NEWSLETTER TARGETING GET: New option for listing ids cor content sending.
NEWSLETTER CATEGORY GET/POST/PUT/DELETE: New endpoint for managing categories.
CHANNEL CONTENT GET: New option for detailed reach stats for each messenger separately.

Version 9

LOGIN POST: Output ticket_reopen_period in minutes instead of seconds.
USER POST csv: Bulk update users via CSV file upload.

Version 8

STATS GET Ticket: The current hour/day/week is included.
BOT MENU/MENUITEM: New endpoints for managing bot messenger menus.
LOGIN POST/CHANNEL GET: Information on booked bot modules is included based on associate role.
LOGIN GET: Information for administrators on wa_policies_accepted.
CONTENT INTERACTION GET: New endpoint for getting interaction information.
CUSTOM: The position of custom fields can be modified.
CUSTOM GET: Filter for showing hidden fields.
CHANNEL GET/PUT : New channel configuration ticket_max_per_agent, applepay_settings.
ACCOUNTING INFO: New endpoints for getting and updating additional account info.
USER GET: Provide type of custom fields.
CUSTOM: New attribute "limited_access" to show custom field only to dispatchers and admins.

Version 7

LOGIN POST: The agent ticket IDs and statistics is included.
AGENT GET: A new parameter open_tickets permits listing the IDs of the open tickets and ticket statistics for an agent. The name is set as well.
TICKET GET: A new parameter for avoiding listing ticket notes. And waiting_since allows filtering open tickets.
TICKET PUT: A new parameter waiting_since for marking an open ticket as answered.
BOT TOPICS GET: A new parameter with_fields allows to check user properties used in api call, condition or chat and list them.
CHANNEL GET: The channel id is listed.
CHAT BOT POST : Customfields can be passed as parameters and will be stored as user properties. Additionally the bot interprets the chat so all conditions, multiple answers etc are evaluated
CHAT POST : A filename can be passed as parameter. It can be displayed in messengers that don't support inline view of the attachment.
CHAT GET/CHANNEL CHAT GET/TICKET GET: Outgoing chats have additional/changed format: email_created is changed to agent_id and agent_email for customer service channels and send_status is added. notification is set for sent WhatsApp notifications. unread is only set for incoming chats for the newsletter platform.
WIDGETINFO GET: The channel id is listed.
STATS GET Ticketdetails: New ticket statistics
CHANNEL GET/PUT : New channel configuration ui_settings, bot_parser_modules.

Version 6

SKILLS: A new endpoint for managing agent skills used for auto-routing of tickets
USER GET Details: When listing a single user: Insta users get the correct messenger IN (instead of WN) and the output field profile_image is renamed to image consistent to the lists of multiple users.
USER GET Details: When listing a single user: Insta users get the correct messenger IN (instead of WN) and the output field profile_image is renamed to image consistent to the lists of multiple users.
STATS GET User/Current: Insta users get the correct messenger IN (instead of WN).
TICKET GET : Insta users get the correct messenger IN (instead of WN).
CHANNEL GET/PUT : New channel configuration ticket_use_autoroutes, ticket_auto_assign, ticket_assign_last_agent.
TICKET PUT/GET : the bot_active status is displayed and can be changed.
CUSTOM PUT/POST/DELETE : correct types for returned values
CHAT BOT POST : a new endpoint for starting a bot conversation by sending bot chat
TICKET POST : new parameter search for searching tickets by ticket id, user id or chat
TICKET GET : new parameters for searching tickets and limiting the number chats.

Version 5

CONTENT: A new endpoint for managing information content (for future usage)
MESSENGER: A new endpoint for managing the messengers connected to the channel
CHANNEL GET: New output fields ticket_reopen_period, ticket_open_if_bot, use_content
CHANNEL GET facebook: New output field non_promotional_content (if content is used and Facebook approved the content)
STATS GET user: Information for each hour is returned even if there was no actvitiy during that hour
STATS GET chat: Information for each hour is returned even if there was no actvitiy during that hour
STATS GET content: A new endpoint for content statistics (for future usage)

Version 4

USER GET property: A new endpoint for getting a property of all or a list of users
USER PUT property: A new endpoint for setting efficiently a property of a list of users
CHANNEL GET apikey: A new endpoint for getting the current channel apikey
CHANNEL PUT apikey: A new endpoint for generating a new channel apikey

Version 3

Agent PUT/GET Data: A new field settings allows to store any agent specific settings. notification_endpoints show information on the agents browser notification settings
Bot GET chats: Output fields are corrected and with correct types
POST chat: The ticket ID is included in the response it the chat is assigned to a ticket
Newsletter GET Targeting: New optional parameters allow to list the number of users of the lists and to get that for just one targeting list

Version 2

User GET Details: New parameters are added to filter and sort the result. The result is now no longer a list with users but a structure with a "total" field with the total number of users matching the filter and a "user" field with the list of users. Each user entry has now additional fields: messenger, created and stopped (only for inactive users)
User GET Details: The output field name is only returned if the user has a name. The output field last_change is removed. The output field stopped shows the stop time instead if the user is stopped (like in the user list). Custom fields that are empty are no longer listed. Each custom field is now listed as a separate object with id, name and value. An output field external_id is returned for messengers like Facebook. Custom fields of type location contain now a structure with a name and location coordinates.
User PUT Details: The result for is now similar to the information in a GET call. All updates for custom fields are listed in a custom fields array. Custom field values are validated for their types. Custom fields of type location can now be set as well with just their location coordinates returning the name as well.
Widget: A new endpoint for getting widget information like available WhatsApp numbers
Channel-Teams: New functions for creating, updating, deleting and listing teams of a channel
Channel-Agents: A new function for listing the agents who have access to a channel
Channel-Labels: New functions for creating, updating, deleting and listing labels of a channel
Channel-Facebook: New functions for reading, creating, updating and deleting the Facebook connection of a channel
Ticket: New functions for creating, updating, deleting and listing tickets
Output Types: If a field represents an integer like timestamps, ids or numbers, it is returned as an integer and no longer as a string, e.g. "status": 1 instead of "status": "1"
Content-Type header: The encoding is now explicitly mentioned: Content-Type: application/json; charset=utf-8
Channel GET Details: An optional parameter wa_numbers allows to list all WhatsApp channel numbers. channelname is renamed to name.
Channel-Details: New fields can be read or updated like timezone or language
Stats GET Newsletters: The newsletter result field is now directly the array and not a structure newsletter: { "newsletter"
Stats GET Tickets: New statistics on tickets
Ticket: New functions for creating, updating, deleting and reading tickets
Agent: New functions for creating, updating, deleting and reading agent information
Login: New endpoint for logging in as a customer agent, sending a code for a forgotten password and logout an agent.
User Properties: New functions for creating, updating and deleting properties.
User Chat POST: Returns the chat ID now
Bot Status: New functions for reading and updating the bot status
Bot Absence Message: New functions for creating, updating, deleting and reading bot absence messages
Bot Manual Answer: New functions for creating, updating, deleting and reading manual answers available in the customer service product
Bot Chats: Get all defined bot chats