SMS API
API Overview
This API is intended for owners of services that send SMS messages. It allows you to connect your SMS service to Planfix if it's not in the list of available services for integration, thus enabling you to send SMS messages from Planfix through your service.
After setting up this integration, you can contact our Support Team to see about getting your service added to the list of integrations available to users in the Planfix interface. The exchange happens over HTTPS. Planfix sends requests to the service address specified in the integration settings.
Connecting in the Planfix interface
To connect and configure the integration, go to the section Account management / Integrations / Integrations with SMS services
In this section, go to the bottom of the list and select Planfix API (using username and password) or Planfix API (using key), depending on the method you wish to use to authorize requests in your service.
A window will open with integration settings.
Here, you will specify the address to which Planfix will send requests; the client's username and password; and the SMS sender name (when authorizing using a key, you'll enter the API key instead of the username and password)
API call format for sending SMS when using username and password
The request is sent using a POST method in the format application/x-www-form-urlencoded, to the address specified in the integration settings.
API call parameters
| Name | Description | Data type/format | Notes |
|---|---|---|---|
| username | username, entered in the integration settings | string | |
| password | password, entered in the integration settings | string | |
| from | sender name | string | |
| to | phone number to which SMS is being sent | string | |
| text | message body | string |
API call format for sending SMS when using a key
The request is sent using a POST method in the format application/x-www-form-urlencoded, to the address specified in the integration settings.
API call parameters
| Name | Description | Data type/format | Notes |
|---|---|---|---|
| key | API key, entered in the integration settings | string | |
| from | sender name | string | |
| to | phone number to which SMS is being sent | string | |
| text | message body | string |
Testing the integration
To test the integration, go to the integration settings, enter all the necessary data, and click the flask icon:
In the section that opens, enter the phone number you'd like to send the SMS to, and the body of your message. Then click Test
Planfix then makes the call to send the message. The response, or an error message, will be displayed.
