As an outcome of this guide, you will receive a Delivery Report of a sent SMS using Infobip SMS API and an online free webhook tool. Once configured, for every SMS sent, you will get a delivery notification sent in real-time to an endpoint you have specified for that SMS.<\/p>\n\n\n\n
\u2022 Infobip account<\/a><\/p>\n\n\n\n \u2022 Working Python 3 environment<\/p>\n\n\n\n \u2022 a webhook that will listen to incoming events<\/p>\n\n\n\n This guide assumes very basic knowledge of Python and basic familiarity with APIs. It is important, however, that you are familiar with the webhook technology and know how to use it for this project. For ease of replicating the scenario, we have used a free online webhook tool, HookRelay<\/a>. You may replace HookRelay with your own hook server if you need to process your events programmatically.<\/p>\n\n\n\n \u2022 Set up a webhook. For the purpose of this guide, we will use a simple online webhook tool, HookRelay<\/a>. This section will show you how to create an account and configure the webhook with HookRelay.<\/p>\n\n\n\n Sign in to HookRelay<\/a> with your GitHub or GitLab credentials. Once logged in, you’ll access a dashboard where you can start creating webhooks.<\/p>\n\n\n\n To create an inbound webhook, from your dashboard, click the New Hook<\/strong> button on the top right. That will take you to the configuration screen where all you need to provide is a descriptive name for your webhook, e.g. Infobip SMS Delivery Reports<\/strong>.<\/p>\n\n\n\n Once you click the Create hook<\/strong> button, you’ll be able to view and copy its URL that you will need to provide in your SMS payload, so the Infobip platform knows where to send its delivery reports. You’ll do that for each SMS you wish to receive delivery reports for.<\/p>\n\n\n\n Send an SMS as you would normally do, but additionally use the Key points:<\/p>\n\n\n\n \u2022 If for some reason your webhook was not available to receive traffic, the Infobip platform will make several attempts to communicate with it<\/a>.<\/p>\n\n\n\nDifficulty level<\/h2>\n\n\n\n
Summary of the steps<\/h2>\n\n\n\n
\u2022 Send an SMS with the URL to your webhook specified in the payload.
\u2022 Receive a Delivery Report in real time on to the previously provided URL.<\/p>\n\n\n\nSet up a webhook<\/h2>\n\n\n\n
Step 1. Sign in with git credentials<\/h3>\n\n\n\n
Step 2. Create a webhook<\/h3>\n\n\n\n
Send an SMS<\/h2>\n\n\n\n
notifyUrl<\/code> field to include the URL for your inbound webhook. Check out our Send an SMS<\/a> guide for more details, if need be.<\/p>\n\n\n\nfrom infobip_channels.sms.channel import SMSChannel\n\nfrom credentials import api_key\n\nchannel = SMSChannel.from_auth_params(\n {\n "base_url": "jdzkyv.api.infobip.com",\n "api_key": api_key\n }\n)\n\nsms_response = channel.send_sms_message({\n "messages": [{\n "destinations": [{\n "to": "447415774432"\n }],\n "from": "InfobipSMS",\n "text": "Hi! I'm your first Infobip message. Have a lovely day!",\n "notifyUrl": "https:\/\/api.hookrelay.dev\/hooks\/jogep17l25r0hejdnkwzx830\/72e082cb9edc40bc7952a939"\n }\n ]\n }\n)\n\nprint(sms_response)<\/code><\/pre><\/div>\n\n\n\nReceive a Delivery Report<\/h2>\n\n\n\n