As an outcome of this guide, you will send an SMS message from your handset to a webhook. This will simulate a scenario in which an end user replies to a message and their reply is stored in a third-party application running on PHP.<\/p>\n\n\n\n
\u2022 Infobip account<\/a><\/p>\n\n\n\n \u2022 PHP, version 7.2 or greater<\/p>\n\n\n\n This guide assumes basic knowledge of PHP 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.<\/p>\n\n\n\n \u2022 Buy a number capable of receiving incoming SMS traffic. To buy a number, you’ll need to log into your Infobip account<\/a>.<\/p>\n\n\n\n For experimenting, you could use a simple free tool like Hook Relay<\/a>, but in this tutorial, we’ll use ngrok<\/a> so we can write some PHP locally to receive these webhooks.<\/p>\n\n\n\n Install ngrok, then run a PHP server from the directory where that In another CLI session start up ngrok and point it at that server:<\/p>\n\n\n\n The output will give you a URL, such as Head back to your Infobip account<\/a> and access your number configuration page (Channels and Numbers > Numbers).<\/p>\n\n\n\n To test that all we have configured worked as expected, send an SMS from your handset to the number you have purchased. This should trigger an event, and you should see your message in a JSON format arriving at your webhook.<\/p>\n\n\n\n That JSON can be deserialized and parsed any way you like, but the Infobip PHP SDK can do a lot of the hard work for you. To do that, we’ll need to install the SDK and authenticate Infobip SMS API.<\/p>\n\n\n\n To use the Infobip API PHP Client<\/a> in your PHP project, you’ll need to add it to your project You’ll use the instance to input your credentials and authenticate Infobip SMS API. Before running the code, don’t forget to replace the placeholders we set in the example below with your account values. You can find your API Key and API Base URL in your Infobip account<\/a> or on the Infobip API landing page<\/a>, once logged in.<\/p>\n\n\n\n Now that we’ve got the configuration done, the next step is configuring your project to listen to and catch webhook events.<\/p>\n\n\n\n Sending a text message to your newly purchased number should mean that a mobile carrier notifies Infobip, Infobip forwards a message to the configured ngrok URL, and that then forwards it to the local PHP server running an appropriate code. Let’s see it in action!<\/p>\n\n\n\n Create a file called As a result, you should see your project intercepting the webhook event as soon as you send an SMS to the number you have purchased and configured for forwarding.<\/p>\n\n\n\n Instead of relying on webhooks, you can always manually check for an incoming traffic. You’d probably want to do that in situations where your system went down briefly for a deploy or crashed unexpectedly.<\/p>\n\n\n\n Before running the solution, don’t forget to replace the placeholders we set with your account values. You can find your API Key and API Base URL either in your Infobip account<\/a> or on the Infobip API landing page<\/a> once logged in.<\/p>\n\n\n\n Running this code will show output that looks a bit like this:<\/p>\n\n\n\n If there are no messages then job done, you’re fine. If there are some messages, you can process them through the same code that’s found in the webhook, and eventual consistency has been reached.<\/p>\n\n\n\n And that’s basically it! You’re now successfully receiving messages from your customers with confidence.<\/p>\n","protected":false},"excerpt":{"rendered":" As an outcome of this guide, you will send […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[12,255,15,264],"tags":[46,76],"coauthors":[133],"class_list":["post-114","post","type-post","status-publish","format-standard","hentry","category-guide","category-infobip-products","category-php","category-sms","tag-developer-docs","tag-sdk"],"acf":[],"yoast_head":"\nDifficulty level<\/h2>\n\n\n\n
Summary of the steps<\/h2>\n\n\n\n
\u2022 Set up a webhook.
\u2022 Add webhook details to the number you’ve purchased.
\u2022 Receive an SMS on your webhook.
\u2022 Install Infobip API PHP Client.
\u2022 Acces webhook with your PHP project.<\/p>\n\n\n\nBuy a number<\/h2>\n\n\n\n
\n
\u2022 Use Filter By Country<\/strong> to select the country you want to test the number in.
\u2022 Use Filter By Capability<\/strong> to select SMS<\/strong> as an option.<\/li>\n\n\n\nSet up a webhook<\/h2>\n\n\n\n
Step 1. Install ngrok<\/h3>\n\n\n\n
webhook-incoming.php<\/code> code is sitting.<\/p>\n\n\n\nphp -S localhost:8088<\/code><\/pre>\n\n\n\nStep 2. Point ngrok at your local server<\/h3>\n\n\n\n
ngrok http http:\/\/localhost:8088\/<\/code><\/pre>\n\n\n\nStep 3. Generate a URL<\/h3>\n\n\n\n
Forwarding https:\/\/d5de-146-90-0-254.eu.ngrok.io -> http:\/\/localhost:8088\/<\/code>. Copy the URL to finish setting up your webhook configuration for the number you have purchased from Infobip. In this case, you’ll use the following URL: https:\/\/d5de-146-90-0-254.eu.ngrok.io\/webhook-incoming.php<\/code>. We will shortly explain why we’ve added the webhook-incoming.php<\/code> bit to the URL.<\/p>\n\n\n\nConfigure your number with webhook details<\/h2>\n\n\n\n
\n
Receive an SMS on your webhook<\/h2>\n\n\n\n
{\n \"results\": [\n {\n \"messageId\": \"817790313235066447\",\n \"from\": \"385916242493\",\n \"to\": \"385921004026\",\n \"text\": \"QUIZ Correct answer is Paris\",\n \"cleanText\": \"Correct answer is Paris\",\n \"keyword\": \"QUIZ\",\n \"receivedAt\": \"2016-10-06T09:28:39.220+0000\",\n \"smsCount\": 1,\n \"price\": {\n \"pricePerMessage\": 0,\n \"currency\": \"EUR\"\n },\n \"callbackData\": \"callbackData\"\n }\n ],\n \"messageCount\": 1,\n \"pendingMessageCount\": 0\n}<\/code><\/pre>\n\n\n\nAdd Infobip API PHP Client to your project<\/h2>\n\n\n\n
composer.json<\/code> file, either directly or with this convenient command-line shortcut.<\/p>\n\n\n\ncomposer require infobip\/infobip-api-php-client<\/code><\/pre>\n\n\n\nCreate an InfobipConfiguration instance<\/h2>\n\n\n\n
<?php\n\nconst API_KEY_PREFIX = 'App';\nconst API_KEY = '<your-api-key>';\nconst URL_BASE_PATH = '<your-base-URL>';\n\n$configuration = (new InfobipConfiguration())\n ->setHost(URL_BASE_PATH)\n ->setApiKeyPrefix('Authorization', API_KEY_PREFIX)\n ->setApiKey('Authorization', API_KEY);\n\n$client = new GuzzleHttpClient();<\/code><\/pre>\n\n\n\nIntercept a webhook with your local PHP server<\/h2>\n\n\n\n
webhook-incoming.php<\/code> in the same directory you just ran the php -S ...<\/code> and that file will be accessible to ngrok.<\/p>\n\n\n\n<?php\n\nrequire \"vendor\/autoload.php\";\n\nuse InfobipObjectSerializer;\n\n$data = file_get_contents(\"php:\/\/input\");\n\n$type = 'InfobipModelSmsInboundMessageResult';\n$messages = ObjectSerializer::deserialize($data, $type);\n\nforeach ($messages->getResults() as $message) {\n echo $message->getFrom() . \" - \" . $message-> getCleanText() . \"n\";\n}<\/code><\/pre>\n\n\n\n[Thu Jun 16 09:09:22 2022] 447785374887 - Hello world!\n[Thu Jun 16 09:09:22 2022] [::1]:60030 [200]: POST \/webhook-incoming.php\n[Thu Jun 16 09:09:22 2022] [::1]:60030 Closing<\/code><\/pre>\n\n\n\nManually check for incoming messages<\/h2>\n\n\n\n
use InfobipAPIReceiveSmsApi;\n\nconst API_KEY = '<your-api-key>';\nconst URL_BASE_PATH = '<your-base-URL>';\n\n$configuration = (new InfobipConfiguration())\n ->setHost(URL_BASE_PATH)\n ->setApiKeyPrefix('Authorization', API_KEY_PREFIX)\n ->setApiKey('Authorization', API_KEY);\n\n$client = new GuzzleHttpClient();\n$receiveSmsApi = new ReceiveSmsApi($client, $configuration);\n\ntry {\n $smsIncoming = $receiveSmsApi->getInboundSmsMessages();\n var_dump($smsIncoming);\n} catch (Throwable $apiException) {\n var_dump($apiException);\n}<\/code><\/pre>\n\n\n\nobject(InfobipModelSmsInboundMessageResult)#44 (1) {\n [\"container\":protected]=>\n array(3) {\n [\"messageCount\"]=>\n int(0)\n [\"pendingMessageCount\"]=>\n int(0)\n [\"results\"]=>\n array(0) {\n }\n }\n}<\/code><\/pre>\n\n\n\n