Help-Center
Terms of servicePricing
English
English
  • About Blinger.io
  • Quick launch
  • Customer cases
  • Documentation
    • Definitions
    • Sign up and Login
    • Tab: Apps
      • Adding accounts
        • Facebook
        • WhatsApp
        • Telegram
        • Viber
        • Twitter
        • WeChat
        • Vkontakte
        • Odnoklassniki
        • Skype
        • Line
        • Email
        • LiveChat
        • Custom app
      • Tagging accounts
      • Assigning channel to a group
    • Tab: Integrations
      • Freshchat
      • Freshdesk
      • Zendesk
      • Intercom
      • Salesforce
      • Kayako
      • BPM'online
      • Slack
      • Iframe
    • Tab: Conversations
    • Tab: Widget
    • Tab: Operators
      • Manage operators
      • Manage operator groups
      • Manage roles
      • Distribution by keywords
    • Tab: Analytics
      • Tags
      • Clients
      • Agents
      • Conversations
    • Tab: Settings
      • Subtab: General
      • Subtab: Autoresponder
      • Subtab: Auto assign messages
      • Subtab: Topics of conversations
      • Subtab: Advanced
    • New message notifications
    • Webhooks
    • Widget API (beta version)
      • Conversation
      • Agent
      • Webhook
      • API Token
    • API
      • API Token
      • Conversation
      • Operator
      • User
  • FAQ
    • Frequently asked questions
      • About functions
        • Autoresponder
        • Assign channels to groups
      • About intergrations
        • Viber
        • Telegram
        • Freshdesk
        • Zendesk
        • WhatsApp
    • Widget
  • Releases
    • Changelog
Powered by GitBook
On this page
  • Event: Conversation is unassigned
  • Event: Conversation is assigned to operator
  • Event: Conversation is closed
  • Event: Incoming message
  • Event: Outgoing message
  • Event: Incoming comment
  • Event: Outgoing comment
  • Event: New client

Was this helpful?

  1. Documentation

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":"ta4@tut.by"
        },
        "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":"ta4@tut.by"
        },
        "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":"ta4@tut.by" // 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":"ta4@tut.by"
    },
    "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":"ta4@tut.by" // 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":"ta4@tut.by"
    },
    "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
    }
}

PreviousNew message notificationsNextWidget API (beta version)

Last updated 4 years ago

Was this helpful?