POST …/inboxes/{inbox}/contacts/{contact}/conversations/{id}/messages
{ "content": "Hi, I need help with my booking" }
message_created → your server
Send customer messages in with the Client API
Create an API inbox and call the Client API from your own app. Create a contact, open a conversation and post each message the customer sends.
Create and identify contacts from your app.
Open conversations and add messages over HTTPS.
Fetch the message history to show it in your own UI.
Client API
Create contactIdentify the person using your appPOST
Create conversationOpen a thread in your API inboxPOST
Create messageSend what the customer typedPOST
List messagesShow the history in your UIGET
JSON over HTTPS
Get every update through webhooks
Set a webhook URL on the inbox and EngageOne posts events to your backend as they happen. Each request carries a signature header, so your server can check it came from EngageOne.
conversation_created, conversation_status_changed and conversation_updated.
message_created and message_updated.
Typing events when an agent starts or stops typing.
Conversations from your API channel sit beside chat, email and social messages. Agents assign, add private notes and reply as usual. Replies go back to your app through the webhook.
Same assignment, labels and automations as other inboxes.
Private notes stay inside your team.
Reports cover API conversations too.
EngageOne · Inbox
RahulAPI channel · Booking appOpen
Hi, I need to move my booking to Saturday.
@Priya can you check Saturday slots?
Done! Your booking is now on Saturday at 11:00.
Reply…Send
Sent back via webhook
Build the channel you need
Use the API channel when a built-in channel does not fit. It works for any surface that can make HTTP requests.
Native support chat inside your mobile app.
A custom chat surface on a kiosk, TV or product screen.
Your own bot that hands over to an agent.
Built on the API channel
In-app support chatNative chat screen in your mobile app
Custom chat surfaceKiosk, smart TV or in-product widget
Your own botAnswers first, then hands over to an agent
Unsupported messengersBridge any platform with an API
Plan your custom channel with us
Talk to our team about connecting your app to Driansh EngageOne through the API.