Receive Message

In order to receive SMS messages, you have to set up MessageBird Receive URL. Receiving messages is technically done using Message Received webhook call which you receive from Amio server whenever someone sends you an SMS.

For the purpose of this tutorial, we will use Ngrok to route incoming webhook calls to your local machine.

1. Download and install Ngrok.
2. (Optional) Create a server app with opened url for Amio webhooks, i.e. http://localhost:<YOUR_APP_PORT>/webhook/amio and start it.
3. Start Ngrok for routing to your local server with command ./ngrok http <YOUR_APP_PORT>.

4. Copy the forward url from Ngrok (https://c25d851e.ngrok.io in our case) and set this url in Amio app (Administration - Channel Detail - Webhook tab).
5. If you haven't done that before, send SMS to your phone number.

📘

Receive Messages - Phone Number

You can receive SMS messages to a dedicated phone number. You have to have a custom number registered at MessageBird and have your channel configured accordingly (See MessageBird setup documentation for more details).

6. Reply to your incoming message on your mobile phone.
7. Observe your local server has received an HTTP POST request.
8. You can see all incoming requests in Ngrok web interface as well http://127.0.0.1:4040.