Telesign is a digital identity and communications platform. Its APIs send SMS and voice messages and verify phone numbers, and its portal manages your customer ID, API keys, and sender numbers.
How does the integration work?
You can use the Telesign provider in Appwrite Messaging to send customized SMS messages to your users, such as reminders, promotions, announcements, and custom authentication flows. Messages can be sent immediately or scheduled, to topics, users, or individual targets.
Appwrite authenticates with Telesign using your customer ID and API key, and sends your messages through Telesign's API.
How to implement
To implement the Telesign provider in Appwrite Messaging, there are several steps you must complete:
Step 1: Set up Telesign
First, sign up for a Telesign account and open the Telesign portal. Save the following information for later use:
| Field name | |
|---|---|
| Customer ID | Head to Telesign portal > Profile > Customer ID. |
| API key | Head to Telesign portal > Profile > API Keys. |
| Sender number | The phone number your SMS messages are sent from. You may need to purchase a number from Telesign first. |
Telesign's guide to finding your customer ID and API key walks through the portal.
Step 2: Add the Telesign provider to your Appwrite project
For this step, you must create an account on Appwrite Cloud or self-host Appwrite if you haven't already. In your Appwrite project, head to Messaging > Providers, click Add provider, and choose SMS. Give your provider a name, choose Telesign, and click Save and continue.
In the Configure step, add the Customer ID and API key you saved from the Telesign portal. Enter the Sender number with a leading + and the country code, such as +14155550123. Click Save and continue to enable the provider.
Step 3: Test the Telesign provider
Before you proceed, you must already have at least one topic or target set up.
Go to Messaging > Messages, click Create message, and choose SMS. Write a test message, select one of your test targets, set the schedule to Now, and click Send. Check that the SMS arrives on your phone. If it doesn't, check the logs in the Appwrite Console and in the Telesign portal.
To send SMS messages from your backend instead, follow the Send SMS messages guide with an Appwrite Server SDK.
Read more about Telesign and Appwrite Messaging
If you would like to learn more about Telesign and Appwrite Messaging, we have some resources that you should visit:
