Events

Send event

Sends an event object. Use this method to send a message by specifying the message event type in the request. The user must be added to the chat before they can send an event. Events with visibility:agents are sent to agents only, and with visibility:all to all users. Users with visibility:agents cannot send events with visibility:all. The method updates the requester’s events_seen_up_to as if they’ve seen all chat events. Specifics


Action	`send_event`
Required scopes	or
Push message	`incoming_event`

Request

Parameter	Required	Type	Notes
`chat_id`	Yes	`string`	The ID of the chat you want to send the message to.
`event`	Yes	`object`	An event object. Does not support the `form` type event in Text.

Response

Field	Type	Notes
`event_id`	`string`

Request

{
  "action": "send_event",
  "payload": {
    "chat_id": "PW94SJTGW6",
    "event": {
      "type": "message",
      "text": "hello world",
      "visibility": "all"
    }
  }
}

Response

{
  "request_id": "<request_id>",
  "action": "send_event",
  "type": "response",
  "success": true,
  "payload": {
    "event_id": "K600PKZON8"
  }
}

Send rich message postback

Specifics


Action	`send_rich_message_postback`
Required scopes	or
Push message	`incoming_rich_message_postback`*

* incoming_rich_message_postback is sent only for active threads. Request

Parameter	Required	Type	Notes
`chat_id`	Yes	`string`
`event_id`	Yes	`string`
`postback`	Yes	`object`
`postback.id`	Yes	`string`	The postback name of the button.
`postback.toggled`	Yes	`bool`	Whether the postback is toggled.
`thread_id`	Yes	`string`

No response payload.

Request

{
  "action": "send_rich_message_postback",
  "payload": {
    "chat_id": "PJ0MRSHTDG",
    "thread_id": "K600PKZON8",
    "event_id": "a0c22fdd-fb71-40b5-bfc6-a8a0bc3117f7",
    "postback": {
      "id": "Method URL_yes",
      "toggled": true
    }
  }
}

Response

{
  "request_id": "<request_id>",
  "action": "send_rich_message_postback",
  "type": "response",
  "success": true,
  "payload": {}
}

Overview

Methods

Send event

Send rich message postback

​Send event

​Send rich message postback

Send event

Send rich message postback