How to send data from your bot using Webhooks

To send the data generated in a bot to other tools it is possible to configure Webhooks in Blip. That way, whenever information (messages or events) is trafficked on the platform it is also triggered for all Webhook URLs defined by your bot in Blip.

Important:

Webhook does not work in real time, and it can take up to 2 hours for the event to be sent and the information to be available.

Adding a Webhook

Access the Blip portal, select your bot and choose the Integrations module. Choose the option Webhook and add at least one URL that will receive all the information sent by Blip. If more than one URL is added, they will all receive the same information.

Example:

Imagine that the application responsible for receiving the information sent by Blip is available at the URL https://requestb.in/14rxsmm1. Add the URL to the Blip portal, click the Save button and then click the Activate key as shown in the figure below. If you need to add a new URL, click the Add button.

Note: This URL must be prepared to receive HTTP requests from the POST method with JSON type objects in the request body. The objects received by the application defined in the Webhook follow the definitions of the Message and Events documents.

Example of request made by Blip (in the configured application) when the chatbot receives a message from a user on the Facebook channel.

HTTP/1.1 200 OK
Content-Type: application/json
{
    "id": "65603604-fe19-479c-c885-3195b196fe8e",
    "from": "182310923192@messenger.gw.msging.net",
    "to": "mychatbot@msging.net",
    "type": "text/plain",
    "content": "Hello World!"
}