Textmagic is a business text messaging service. Its web app and REST API send and receive SMS, and its dashboard manages your API keys, sender numbers, and sender IDs.
How does the integration work?
You can use the Textmagic 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 Textmagic using your username and API key, and sends your messages through the Textmagic API.
How to implement
To implement the Textmagic provider in Appwrite Messaging, there are several steps you must complete:
Step 1: Set up Textmagic
First, sign up for a Textmagic account. Then save the following information from the Textmagic dashboard:
| Field name | |
|---|---|
| API key | Head to Services > API and click Add new API key. |
| Username | Head to My account and copy your Username. |
| Sender number | Head to Services > Sender settings to see the numbers your SMS messages can be sent from. |
Step 2: Add the Textmagic 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 Textmagic, and click Save and continue.
In the Configure step, add the API key and Username you saved from the Textmagic dashboard. 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 Textmagic 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 your Textmagic dashboard.
To send SMS messages from your backend instead, follow the Send SMS messages guide with an Appwrite Server SDK.
Read more about Textmagic and Appwrite Messaging
If you would like to learn more about Textmagic and Appwrite Messaging, we have some resources that you should visit:
