MessageHub Integrations: Supported Events by Webhooks

This article will review the Supported Events you can transfer via Webhooks. Webhooks are HTTP callbacks that can be defined for every account. They are triggered by events like message creation in MessageHub. You can connect more than one Webhook to your MessageHub account.

Caution

Please keep in mind that our support for Webhooks is limited. If you need additional assistance, please contact a professional developer.

---

Requirements

• An active ClickFunnels account

• The MessageHub App

---

Objects

An event can contain any of the following objects as a payload. Different types of objects supported in MessageHub are as follows.

account

The following payload will be returned for an account.

{
  "id": "integer",
  "name": "string"
}

inbox

The following payload will be returned for an inbox.

{
  "id": "integer",
  "name": "string"
}

contact

The following payload will be returned for a contact.

{
  "id": "integer",
  "name": "string",
  "avatar": "string",
  "type": "contact",
  "account": {
    // <...account Object Attributes>
  }
}

user

The following payload will be returned for an agent/admin.

{
  "id": "integer",
  "name": "string",
  "email": "string",
  "type": "user"
}

conversation

The following payload will be returned for a conversation.

{
  "additional_attributes": {
    "browser": {
      "device_name": "string",
      "browser_name": "string",
      "platform_name": "string",
      "browser_version": "string",
      "platform_version": "string"
    },
    "referer": "string",
    "initiated_at": {
      "timestamp": "iso-datetime"
    }
  },
  "can_reply": "boolean",
  "channel": "string",
  "id": "integer",
  "inbox_id": "integer",
  "contact_inbox": {
    "id": "integer",
    "contact_id": "integer",
    "inbox_id": "integer",
    "source_id": "string",
    "created_at": "datetime",
    "updated_at": "datetime",
    "hmac_verified": "boolean"
  },
  "messages": [
    // Array Of message Objects
  ],
  "meta": {
    "sender": {
      // contact Object Attributes
    },
    "assignee": {
      // user Object Attributes
    }
  },
  "status": "string",
  "unread_count": "integer",
  "agent_last_seen_at": "unix-timestamp",
  "contact_last_seen_at": "unix-timestamp",
  "timestamp": "unix-timestamp",
  "account_id": "integer"
}

message

The following payload will be returned for a message.

{
  "id": "integer",
  "content": "string",
  "message_type": "integer",
  "created_at": "unix-timestamp",
  "private": "boolean",
  "source_id": "string / null",
  "content_type": "string",
  "content_attributes": "object",
  "sender": {
    "type": "string - contact/user"
    // user Or contact Object Attributes
  },
  "account": {
    // account Object Attributes
  },
  "conversation": {
    // conversation Object Attributes
  },
  "inbox": {
    // inbox Object Attributes
  }
}

Example Webhook Payload

The following is an example of the final webhook payload that will be returned.

{
  "event": "event_name"
  // Attributes related to the event
}

---

Events

MessageHub supports the following webhook events. You can subscribe to them while configuring a webhook in the dashboard or using the API.

Caution

Custom code is case sensitive. It is important to add it exactly as it is shown.

conversation_created

This event will be triggered when a new conversation is created in the account. The payload for the event is as follows.

{
  "event": "conversation_created"
  // <...conversation Object Attributes>
}

conversation_updated

This event will be triggered when there is a change in any of the attributes in the conversation.

{
  "event": "conversation_updated" ,
  "changed_attributes": [
    {
      "<attribute_name>": {
        "current_value": "",
        "previous_value": ""
      }
    }
  ]
  // <...conversation Object Attributes>
}

conversation_status_changed

This event will be triggered when the status of the conversation is changed.

Note

If you are using agent bot APIs instead of webhooks, this event is not supported yet.

{
  "event": "conversation_status_changed"
  // <...conversation Object Attributes>
}

message_created

This event will be triggered when a message is created in a conversation. The payload for the event is as follows.

{
  "event": "message_created"
  // <...message Object Attributes>
}

message_updated

This event will be triggered when a message is updated in a conversation. The payload for the event is as follows.

{
  "event": "message_updated"
  // <...message Object Attributes>
}

webwidget_triggered

This event will be triggered when the end user opens the live chat widget.

{
  "id": "integer",
  "contact": {
    // <...contact Object Attributes>
  },
  "inbox": {
    // <...inbox Object Attributes>
  },
  "account": {
    // <...account Object Attributes>
  },
  "current_conversation": {
    // <...conversation Object Attributes>
  },
  "source_id": "string",
  "event": "webwidget_triggered",
  "event_info": {
    "initiated_at": {
      "timestamp": "date-string"
    },
    "referer": "string",
    "widget_language": "string",
    "browser_language": "string",
    "browser": {
      "browser_name": "string",
      "browser_version": "string",
      "device_name": "string",
      "platform_name": "string",
      "platform_version": "string"
    }
  }
}