Vonage_

Send SMS messages to your Appwrite users using Vonage and Appwrite Messaging.

2 min read

Vonage lets you send customized SMS messages to your users. These SMS messages can be sent immediately or scheduled. You can send SMS messages for purposes like reminders, promotions, announcements, and even custom authentication flows.

1. Add provider

To add Vonage as a provider, navigate to Messaging > Providers > Add provider > SMS.

Give your provider a name > choose Vonage > click Save and continue. The provider will be saved to your project, but not enabled until you complete its configuration.

2. Configure provider

In the Configure step, you will need to provide details from your Vonage dashboard to connect your Appwrite project.

You will need to provide the following information from your Vonage dashboard.

Field name
API key	Head to Vonage dashboard > Build & manage > API settings and copy the API key.
API secret	Head to Vonage dashboard > Build & manage > API settings and copy the API secret.
Sender number	You can access your numbers by navigating to Vonage dashboard > Build & manage > Numbers > Your numbers.

After adding the following details, click Save and continue to enable the provider.

3. Test provider

Before sending your first message, make sure you've configured a topic and a target to send messages to.

To send a test message, navigate to Messaging > Messages > Create message > SMS.

Add your message and in the targets step, select one of your test targets. Set the schedule to Now and click Send.

Verify that you can receive the message in your inbox. If not, check for logs in the Appwrite Console or in your provider's logs.

To send a message programmatically, use an Appwrite Server SDK.

const sdk = require('node-appwrite');

// Init SDK
const client = new sdk.Client();

const messaging = new sdk.Messaging(client);

client
    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
    .setProject('<PROJECT_ID>')                 // Your project ID
    .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key
;

const message = await messaging.createSms({
    messageId: '<MESSAGE_ID>',
    content: '<CONTENT>',
    topics: [],
    users: [],
    targets: [],
    draft: true,
    scheduledAt: ''
});

You can follow the Send SMS messages guide to send your first push notification and test your provider.

4. Manage provider

You can update or delete a provider in the Appwrite Console.

Navigate to Messaging > Providers > click your provider. In the settings, you can update a provider's configuration or delete the provider.

To update or delete providers programmatically, use an Appwrite Server SDK.

const sdk = require('node-appwrite');

// Init SDK
const client = new sdk.Client();

const messaging = new sdk.Messaging(client);

client
    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
    .setProject('<PROJECT_ID>')                 // Your project ID
    .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key
;

const provider = await messaging.updateVonageProvider({
    providerId: '<PROVIDER_ID>',
    name: '<NAME>',
    enabled: false,
    apiKey: '<API_KEY>',
    apiSecret: '<API_SECRET>',
    from: '<FROM>'
});

Was this page helpful?

Share what worked or what we should fix. Once approved, our agents automatically apply suggested updates to the docs.