Message Received

This event is fired when a contact sends a message to your channel. Request body contains channel type on which the event was handled as well as id of the contact. Different type of messages can be received based on channel.type.

{
  "event": "message_received",
  "timestamp": "2016-10-06T13:42:48Z",
  "data": {
    "id": "{{MESSAGE_ID}}",
    "channel": {
      "id": "{{CHANNEL_ID}}",
      "type": "{{CHANNEL_TYPE}}",
      "name": "{{CHANNEL_NAME}}"
    },
    "contact": {
      "id": "{{CONTACT_ID}}"
    },
    "content": {
      "payload": "What's the weather today?",
      "type": "text"
    },
    "nlp": {
      "intents": [
        {
          "confidence": 0.99847021852548,
          "id": "weather"
        }
      ],
      "native_data": {...}
    },
  }
}
ParameterTypeDescription
dataobjectObject representing message received. Different type of messages can be received (text, image, etc.). The structure matches Send Message response body except for the nlp key (see below). This key will be present only for received text messages on channels with NLP integration connected.

Natural Language Processing (NLP)

If there's an NLP integration connected to your channel, then your Message Received webhook will contain an nlp key with the result provided by the NLP service. Since different NLP services provide different extra capabilities and parameters beyond simple intent/entity extraction, we also include full JSON response from the service.

ParameterTypeDescription
nlp.intentsarray of objectsList of intents ordered by confidence score.
nlp.intents[].idstringName (or other unique identifier) of the intent.
nlp.intents[].confidencenumberConfidence score of the intent.
nlp.native_dataobjectFull unmodified JSON response as returned by the NLP service. For more information, please refer to the documentation of the service:
Wit.ai
Watson