Webhooks
Webhooks¶
Webhooks are used to receive status updates on message and receiving user events.
If you filter IPs, you can find the IP used with the following commands: IPv4 for the EU-setup
1 | |
IPv6 for the global setup
1 | |
Your webhook will be called whenever a message changes state, either by our systems or our providers.
If we cannot reach your server, or you reply with an HTTP status code ≥ 300, or the request times out after 5 seconds, the delivery attempt is marked as failed and scheduled for retry a bit later, with the delay being calculated based on how many previous failed attempts has been made, with a lot of randomization, to smooth out bursts that may overwhelm the receiving server. If the delivery attempts keep failing a high number of times and for at least 24 hours, the event is eventually dropped and no further retries will be made.
SSL certificates will be verified, and you will not receive callbacks if you have an invalid certificate.
Use the dashboard to configure and test webhooks
Receiving SMS Messages¶
Webhooks are also used to receive SMS messages, which is often referred to as MO SMS.
Prerequisites¶
In order to receive an SMS, you will need a short code and/or keyword to which the user sends the SMS. This short code and/or keyword is leased to you, so when we receive an SMS on the specific short code, with the specific keyword, we know where to deliver the SMS.
You can either lease a keyword on a shared short code, such as +45 1204, or you can lease an entire short code, such as +45 60575797. Contact us via the live chat if you need a new short code and/or keyword.
If you lease the keyword “foo” on the short code 45 1204, a Danish (+45) user would send i.e. “foo hello world” to “1204”, and you will receive the SMS.
Once you have a keyword lease, you will need to assign the keyword to a webhook. You can do this from the dashboard.
- If you do not have a webhook, add one
- Click the webhook you want to receive SMS messages
- Click the tab “Keywords”
- Make sure the checkbox next to “Assign” is checked for the keywords you want to assign to this webhook
If you have any questions, please contact us using the live chat.