Webhooks

Version 1.0

For provision of access to the setting of webhooks, please, contact with our Support Team.

Your server must return HTTP 200 status if the request is received successfully.

Webhooks can trigger the third-party solution on the following events occurred:

Event: Conversation is unassigned

Trigger when a conversation status changed to unassigned

{
    "webhook":"on_conversation_unassigned",
    "conversation":{
        "id":181,
        "application":"telegrambot",
        "status":"unassigned",
        "date_created":1513351579,
        "date_updated":1513353161,
        "from_user":{
            "user_id":374,
            "role":"default",
            "title":"Yuri Dzabaev",
            "avatar":"https://app.blinger.io/images/users/no-user.png",
            "page_title":"Blinger – Messengers for business", //only for livechat
            "page_url":"https://blinger.io", //only for livechat
            "status":"enabled",
            "service_user_id":"ta4ta4",
            "date_created":1513262192
        }
    }
}

Event: Conversation is assigned to operator

Trigger when a conversation is assigned to operator.

{
    "webhook":"on_conversation_assigned",
    "conversation":{
        "id":180,
        "application":"telegrambot",
        "status":"inbox",
        "date_created":1513350728,
        "date_updated":1513351289,
        "operator":{
            "id":11,
            "name":"Supervisor",
            "email":"[email protected]"
        },
        "from_user":{
            "user_id":374,
            "role":"default",
            "title":"Yuri Dzabaev",
            "avatar":"https://app.blinger.io/images/users/no-user.png",
            "page_title":"Blinger – Messengers for business", //only for livechat
            "page_url":"https://blinger.io", //only for livechat
            "status":"enabled",
            "service_user_id":"ta4ta4",
            "date_created":1513262192
        }
    }
}

Event: Conversation is closed

Trigger when a conversation is closed.

{
    "webhook":"on_conversation_closed",
    "conversation":{
        "id":181,
        "application":"telegrambot",
        "status":"closed",
        "date_created":1513351579,
        "date_updated":1513353917,
        "operator":{
            "id":11,
            "name":"Supervisor",
            "email":"[email protected]"
        },
        "from_user":{
            "user_id":374,
            "role":"default",
            "title":"Yuri Dzabaev",
            "avatar":"https://app.blinger.io/images/users/no-user.png",
            "page_title":"Blinger – Messengers for business", //only for livechat
            "page_url":"https://blinger.io", //only for livechat
            "status":"enabled",
            "service_user_id":"ta4ta4",
            "date_created":1513262192
        }
        "messages":[
            {
                "id":634,
                "from_blinger_user_id":547,
                "to_blinger_user_id":374,
                "from_user_id":547,
                "to_user_id":374,
                "type":"text",
                "application":"telegrambot",
                "message":"123",
                "blinger_message_id":4717,
                "date_created":1513353914,
                "status":"sent",
                "is_outgoing":true,
                "is_inner_message":false,
                "from_user_name":null,
                "to_user_name":"Yuri Dzabaev",
                "fromBlingerUser":{
                    "id":299,
                    "service_blinger_id":18,
                    "blinger_user_id":547,
                    "is_active":true,
                    "date_updated":1513346127,
                    "date_created":1513346127,
                    "tags":"[]",
                    "name":null,
                    "role":"customer",
                    "avatar":null,
                    "application":"telegrambot",
                    "service_user_id":null,
                    "status":"enabled"
                },
                "toBlingerUser":{
                    "id":294,
                    "service_blinger_id":18,
                    "blinger_user_id":374,
                    "is_active":true,
                    "date_updated":1513262192,
                    "date_created":1513262192,
                    "tags":null,
                    "name":"Yuri Dzabaev",
                    "role":"default",
                    "avatar":"https://app.blinger.io/images/users/no-user.png",
                    "application":"telegrambot",
                    "service_user_id":"ta4ta4",
                    "status":"enabled"
                }
            }
        ],
        "tags":[
            {
                "id":"id",
                "title":"test1",
                "message_id":"634"
            },
            {
                "id":"id",
                "title":"test1",
                "message_id":"634"
            },
            {
                "id":"id",
                "title":"test1",
                "message_id":"634"
            }
        ],
        'close_group' => [
            'title' => 'Duplicate',
        ],
    }
}

Event: Incoming message

Trigger when a new incoming message received.

{
    "webhook":"on_message_incoming",
    "from_user_id":481,
    "to_user_id":542,
    "message_id":546,
    "message_blinger_id":4627,
    "conversation_id":173,
    "conversation_token":"G67iEBrRWGx6tz1Q84X5kREL2UhGC8XxzmbLszr60fLep_l6hjGghQ5Umdvac_8U",
    "operator":{
        "id":11, // null if conversation is not assigned to operator
        "name":"Supervisor", // null if conversation is not assigned to operator
        "email":"[email protected]" // null if conversation is not assigned to operator
    },
    "from_user":{
        "user_id":481,
        "role":"default",
        "title":"Yuri Dzabaev",
        "avatar":"https://app.blinger.io/images/users/no-user.png",
        "page_title":"Blinger – Messengers for business", //only for livechat
        "page_url":"https://blinger.io", //only for livechat
        "status":"enabled",
        "application":"vk",
        "service_user_id":"101786025",
        "date_created":1513329664
    },
    "to_user":{
        "user_id":542,
        "role":"customer",
        "title":null,
        "avatar":null,
        "status":"enabled",
        "application":"vk",
        "service_user_id":null,
        "date_created":1513329654
    },
    "message":{
        "id":546,
        "from_user_id":481,
        "to_user_id":542,
        "type":"text",
        "application":"vk",
        "date_created":1513338128,
        "message":"test",
        "tags":["tag1", "tag2"]
    }
}

Event: Outgoing message

Trigger when a new outgoing message received

{
    "webhook":"on_message_outgoing",
    "from_user_id":542,
    "to_user_id":481,
    "message_id":545,
    "message_blinger_id":4626,
    "conversation_id":173,
    "conversation_token":"G67iEBrRWGx6tz1Q84X5kREL2UhGC8XxzmbLszr60fLep_l6hjGghQ5Umdvac_8U",
    "operator":{
        "id":11,
        "name":"Supervisor",
        "email":"[email protected]"
    },
    "from_user":{
        "user_id":542,
        "role":"customer",
        "title":null,
        "avatar":null,
        "page_title":"Blinger – Messengers for business", //only for livechat
        "page_url":"https://blinger.io", //only for livechat
        "status":"enabled",
        "application":"vk",
        "service_user_id":null,
        "date_created":1513329654
    },
    "to_user":{
        "user_id":481,
        "role":"default",
        "title":"Yuri Dzabaev",
        "avatar":"https://app.blinger.io/images/users/no-user.png",
        "page_title":"Blinger – Messengers for business", //only for livechat
        "page_url":"https://blinger.io", //only for livechat
        "status":"enabled",
        "application":"vk",
        "service_user_id":"101786025",
        "date_created":1513329664
    },
    "message":{
        "id":545,
        "from_user_id":542,
        "to_user_id":481,
        "type":"text",
        "application":"vk",
        "date_created":1513337982,
        "message":"123",
        "tags":["tag1", "tag2"]
    }
}

Event: Incoming comment

Trigger when a new incoming comment received

{
    "webhook":"on_comment_incoming",
    "from_user_id":481,
    "to_user_id":542,
    "comment_id":546,
    "comment_blinger_id":4627,
    "conversation_id":173,
    "conversation_token":"G67iEBrRWGx6tz1Q84X5kREL2UhGC8XxzmbLszr60fLep_l6hjGghQ5Umdvac_8U",
    "operator":{
        "id":11, // null if conversation is not assigned to operator
        "name":"Supervisor", // null if conversation is not assigned to operator
        "email":"[email protected]" // null if conversation is not assigned to operator
    },
    "from_user":{
        "user_id":481,
        "role":"default",
        "title":"Yuri Dzabaev",
        "avatar":"https://app.blinger.io/images/users/no-user.png",
        "status":"enabled",
        "application":"vk",
        "service_user_id":"101786025",
        "date_created":1513329664
    },
    "to_user":{
        "user_id":542,
        "role":"customer",
        "title":null,
        "avatar":null,
        "status":"enabled",
        "application":"vk",
        "service_user_id":null,
        "date_created":1513329654
    },
    "comment":{
        "id":546,
        "from_user_id":481,
        "to_user_id":542,
        "reply_comment_id":544,
        "type":"text",
        "post_id":"123123",
        "post_url":"https://vk.com/id1?w=wall1_2307813",
        "post_title":"Пост из вк",
        "application":"vk",
        "date_created":1513338128,
        "message":"test"
    }
}

Event: Outgoing comment

Trigger when a new outgoing comment received

{
    "webhook":"on_comment_outgoing",
    "from_user_id":542,
    "to_user_id":481,
    "comment_id":545,
    "comment_blinger_id":4626,
    "conversation_id":173,
    "conversation_token":"G67iEBrRWGx6tz1Q84X5kREL2UhGC8XxzmbLszr60fLep_l6hjGghQ5Umdvac_8U",
    "operator":{
        "id":11,
        "name":"Supervisor",
        "email":"[email protected]"
    },
    "from_user":{
        "user_id":542,
        "role":"customer",
        "title":null,
        "avatar":null,
        "status":"enabled",
        "application":"vk",
        "service_user_id":null,
        "date_created":1513329654
    },
    "to_user":{
        "user_id":481,
        "role":"default",
        "title":"Yuri Dzabaev",
        "avatar":"https://app.blinger.io/images/users/no-user.png",
        "status":"enabled",
        "application":"vk",
        "service_user_id":"101786025",
        "date_created":1513329664
    },
    "comment":{
        "id":545,
        "from_user_id":542,
        "to_user_id":481,
        "reply_comment_id":544,
        "type":"text",
        "post_id":"123123",
        "post_url":"https://vk.com/id1?w=wall1_2307813",
        "post_title":"Пост из вк",
        "application":"vk",
        "date_created":1513337982,
        "message":"123"
    }
}

Event: New client

Trigger when a new user is created

{
    "webhook":"on_user_new",
    "user":{
        "id":294,
        "blinger_user_id":374,
        "name":"Yuri Dzabaev",
        "avatar":"https://app.blinger.io/images/users/no-user.png",
        "application":"telegrambot",
        "service_user_id":"ta4ta4",
        "date_created":1513262192
    }
}