Home / Callback URL

Callback URL

The Callback URL (webhook) feature allows you to forward incoming SMS messages to a defined URL address.

Feature Details

Callback URL function allows incoming SMS messages to be redirected to a defined URL. If the function is enabled any message coming into SMSEagle will trigger an HTTP(S) request to the remote url. The HTTP(S) request can be of type GET or POST.

Configuration

The feature allows you to create a webhook for incoming SMS/MMS. On each incoming SMS/MMS message SMSEagle will trigger HTTP(S) request to a defined URL. The “Callback URL” allows to add unlimited number of rules. Each rule can be enabled or disabled by user.

Adding/editing rules

For each new rule user has to fill in the requested fields:

  • ‘URL’ field defines remote address of your callback script
  • ‘Test URL’ button allows to test whether your Callback URL configuration is correct. SMSEagle will make a callback request with test parameters and will verify the response of remote server
  • ‘URL method’ allows to choose whether callback to your URL is done with HTTP(S) GET or POST method
  • “Send request when” defines if the request is always sent, sent only when SMS sender belongs to a given Phonebook contact/group and/or when incoming message contains a given character string
  • Optionally you can define “API key of your service” value. This will be passed to your callback URL in parameter ‘apikey’. If you leave the field blank, ‘apikey’ parameter will not be passed to your callback URL
  • User may also choose whether to enable support of self-signed SSL certificate

After sending HTTP(S) GET/POST request to your callback URL, SMSEagle will be expecting HTTP response: 200 [OK].  If other or no response is received from your callback URL, SMSEagle will keep retrying every X minutes (user defined) for 24 hours.

What is hardware
SMS Gateway?

Find a detailed description
in the User's Manual