Webhooks

Webhooks are a way to notify you of an event that has occurred on the system using custom callbacks over HTTP.

Configure the webhook in the Settings ➔ Webhooks to receive event notifications to your URL.

You can specify a separate URL for each event or a common one for all events. Before saving, you should test the requests by clicking on the corresponding button. We will send test data to the specified URL, so you can see the structure and we will check the availability of the link. If the testing is successful, the webhook can be saved.

POST requests for events are currently available:

• Email
  • Message sent
  • Delivery bounce
  • Message opened
  • Click in message
  • Complaint
• WhatsApp
  • Template message sent
  • Template message delivered
  • Template message read
  • Incoming message received
  • Template message delivery bounce
• Mailing groups - Email channel only
  • Subscribing to a mailing group
  • Unsubscribe from a mailing group - if necessary, you can specify the unsubscribe methods you are interested in, so that webhooks will only arrive using them (and any other methods will be ignored).
    • All methods
    • Manually - unsubscribe via contact card or segment actions
    • Email - by clicking on any unsubscribe link like:
      • {{link_unsubscribe}}
      • {{link_unsubscribe_unsubscribe_manager}}} - if the unsubscribe was confirmed by the contact
      • {{Unsubscribe('groupname', 'groupname2')}}} - unsubscribed from specific mailing groups
      • {{UnsubscribeRedirect('link', 'groupName', 'groupName2')}} - unsubscribed from specific mailing groups with a redirect to the specified URL
    • Three soft bounces in a row
    • Scenario - if the contact has passed through the block “Scenario completion” with the condition “unsubscribe from the mailing group”
    • API
    • Import - when importing contacts with replacement of existing contacts
    • Local blacklist
    • Global blacklist
    • Deleting a mailing group
    • Deleting a contact - by any available method (API, import, via contact card, segment, script block with contact deletion condition)
• Contacts
  • Contact adding

The body is fixed and looks as follows:

{
  "event": "message sent",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Sending message (test)",
  "from": "user@gmail.com",
  "to": "destination@gmail.com"
}

where:

• event - event (message sent)
• message_id - message identifier
• message_uid - unique uid of the message
• sending_type - message sending condition
  • instant
  • scheduled
  • regular
  • byAPI - by API
  • byEvent - by event
  • DOI - confirmation letter
  • scenario - scenario message
• name - message subject
• from - sender's email
• to - recipient's email

{
  "event": "delivery bounce",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Error while sending message (test)",
  "from": "user@gmail.com",
  "to": "destination@gmail.com",
  "error_message": "Some error message"
}

where:

• event - event (delivery bounce)
• message_id - message identifier
• message_uid - unique uid of the message
• sending_type - message sending condition
  • instant
  • scheduled
  • regular
  • byAPI - by API
  • byEvent - by event
  • DOI - confirmation letter
  • scenario - scenario message
• name - message subject
• from - sender's email
• to - recipient's email
• error_message - bounce text

{
  "event": "message open",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Open message (test)",
  "from": "user@gmail.com",
  "to": "destination@gmail.com"
}

where:

• event - event (message opening)
• message_id - message identifier
• message_uid - unique uid of the message
• sending_type - message sending condition
  • instant
  • scheduled
  • regular
  • byAPI - by API
  • byEvent - by event
  • DOI - confirmation letter
  • scenario - scenario message
• name - message subject
• from - sender's email
• to - recipient's email

{
  "event": "message clicked",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Click in message (test)",
  "from": "user@gmail.com",
  "to": "user2@gmail.com",
  "click_url": "https://clicked.link/"
}

where

• event - event (click in message)
• message_id - message identifier
• message_uid - unique uid of message
• sending_type - message sending condition
  • instant
  • scheduled
  • regular
  • byAPI - by API
  • byEvent - by event
  • DOI - confirmation letter
  • scenario - scenario message
• name - message subject
• from - sender's email
• to - recipient's email
• click_url - click URL

{
  "event": "сomplaint",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Complaint in message (test)",
  "from": "user@gmail.com",
  "to": "destination@gmail.com"
}

where

• event - event (complaint)
• message_id - message identifier
• message_uid - unique uid of message
• sending_type - message sending condition
  • instant
  • scheduled
  • regular
  • byAPI - by API
  • byEvent - by event
  • DOI - confirmation letter
  • scenario - scenario message
• name - message subject
• from - sender's email
• to - recipient's email

{
  "event": "whatsapp template sent",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111"
}

where:

• event - event (template message sent)
• template_name - template name
• message_id - message id
• sending_type - message sending condition
  • scenario - scenario message
• from_number - sender number (in format 7хххххххххх)
• to_number - recipient number (in format 7хххххххххх)

{
  "event": "whatsapp template delivered",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111"
}

where:

• event - event (template message delivered)
• template_name - template name
• message_id - message id
• sending_type - message sending condition
  • scenario - scenario message
• from_number - sender number (in format 7хххххххххх)
• to_number - recipient number (in format 7хххххххххх)

{
  "event": "whatsapp template delivered",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111"
}

where:

• event - event (template message read)
• template_name - template name
• message_id - message id
• sending_type - message sending condition
  • scenario - scenario message
• from_number - sender number (in format 7хххххххххх)
• to_number - recipient number (in format 7хххххххххх)

{
   "event": "whatsapp inbox message received",
   "message": "some text",
   "from_number": "71111111111",
   "to_number": "70000000000"
}

where:

• event - event (incoming message received)
• message - message (text of the incoming message)
• from_number - sender number: contact who sent the incoming message (in format 7хххххххххх)
• to_number - recipient number: WA number set up in your account (in the format 7хххххххххх)

{
   "event": "whatsapp template bounce",
   "template_name": "template_example",
   "message_id": 123,
   "sending_type": "scenario",
   "from_number": "70000000000",
   "to_number": "71111111111",
   "error_message": "Some error message"
}

where:

• event - event (template message delivery bounce)
• template_name - template name
• message_id - message id
• sending_type - message sending condition
  • scenario - scenario message
• from_number - sender number (in format 7хххххххххх)
• to_number - recipient number (in format 7хххххххххх)
• error_message - bounce text

{
  "event": "mailing group subscribe",
  "email": "user@gmail.com",
  "group_id": 4,
  "group_name": "Person subscribe (test)",
  "channel": "email"
}

where:

• event - event (subscription to a mailing group)
• email - contact's email
• group_id - mailing group identifier
• group_name - system name of the mailing group
• channel - channel of the mailing group

{
  "event": "mailing group unsubscribe",
  "email": "user@gmail.com",
  "group_id": 4,
  "group_name": "Person unsubscribe (test)",
  "channel": "email"
}

where:

• event - event (unsubscription from a mailing group)
• email - contact's email
• group_id - mailing group identifier
• group_name - system name of the mailing group
• channel - channel of the mailing group

{
  "event": "contact adding",
  "email": "user@gmail.com",
  "phone": "80123456789",
  "groups_names": [
    "test_group_0",
    "test_group_1"
  ],
  "groups_ids": [
    0,
    1
  ]
}

where:

• event - event (adding a contact)
• email - contact's email
• phone - contact's phone number
• groups_names - system names of mailing groups to which the contact was subscribed when adding the contact
• groups_ids - identifiers of mailing groups to which the contact was subscribed when added