Custom Channel

You can integrate your own messaging channels into Connexease.

Forwarding messages to Connexease

POST /webhook/custom/

Example request:

POST /custom/ HTTP/1.1
Host: webhook.connexease.com
Accept: application/json
X-Connexease-Webhook-Sign: ZG9udHRyeW1lIQ==

{
    "channel": {
        "uuid": "my-custom-channel-uuid"
    },
    "events": [
        {
            "hook": "message.create",
            "user": {
                "id": "user-unique-id",
                "name": "John Doe",
                "email": "[email protected]",
                "phone_number": "+905000000000",
                "picture": "https://loremflickr.com/320/240"
            },
            "messages": [
                {
                    "id": "message-unique-id",
                    "type": "text",
                    "content": "Lorem ipsum dolor site amet...",
                    "timestamp": "2018-05-23 08:14:55.300273+00:00"
                },
                {
                    "id": "message-unique-id2",
                    "type": "image",
                    "content": "Lorem ipsum dolor site amet...",
                    "timestamp": "2018-05-23 08:14:55.300273+00:00",
                    "url": "https://loremflickr.com/320/240"
                }
            ]
        }
    ]
}

Request Headers:

• X-Connexease-Webhook-Sign – HMAC-SHA256 token to authenticate. See Verifying webhook requests.

Status Codes:

• 200 OK – no error, JWT created
• 400 Bad Request – there’s no user

Example successful response:

HTTP/1.1 200 OK
Content-Type: application/json

Example failed response:

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
    "detail": "Something is wrong with your request."
}

Receiving messages from Connexease

We will send you a webhook request when one of your agents replies to a conversation. Read more about webhooks on Webhooks, and Message create.