Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

Spotzee routes SMS sends through a provider you bring. Five providers are supported: Twilio, Plivo, Telnyx, Vonage, and httpSMS. Pick the one your number is registered with and paste the credentials.
SMS provider configuration lives under Settings → Integrations and requires the project admin role. Vonage appears internally as nexmo (its legacy name); the UI labels it Vonage.

​
Pick a provider

Each provider takes a different credential shape:
ProviderCredentialsNotes
TwilioAccount SID, Auth Token, Phone numberPre-built inbound webhook for STOP/HELP and replies
PlivoAuth ID, Auth Token, Phone numberPre-built inbound webhook
TelnyxAPI Key, Phone numberPre-built inbound webhook
VonageAPI Key, API Secret, Phone numberSends through the Vonage SMS API
httpSMSAPI Key, Phone numberSends through an Android device acting as the gateway
Phone numbers should be in E.164 format (for example, +61400000000).

​
Configure your provider

1

Get Twilio credentials

In the Twilio console, copy your Account SID and Auth Token (or create a sub-account API key for tighter scoping). Note the SMS-capable phone number you’ll send from.
2

Add the provider

In Spotzee Settings → Integrations, add a new SMS provider and pick Twilio.
3

Enter credentials

Fill in:
  • Account SID.
  • Auth Token.
  • Phone number in E.164 format.
4

Configure inbound webhook

Spotzee shows an Inbound URL in the provider’s setup metadata. Paste that URL into your Twilio number’s Messaging webhook so STOP, HELP, and replies flow back into Spotzee.
5

Save and test

Save and send a test message (see Test the connection).

​
Test the connection

Each provider has a test-send affordance. Run one before you point real campaigns at the provider.
1

Open the provider you saved

In Settings → Integrations, open the provider’s row.
2

Send a test message

Use the test-send action. Supply a destination number you can read.
3

Check the result

A successful send confirms credentials, network access, and the source number’s sending capability. A failure surfaces the underlying error message and the provider’s status code.

​
Set the default provider

Spotzee picks the default SMS provider for any send that doesn’t name one. Mark one provider as default after saving it. Add more providers as fallbacks; the routing layer prefers the default and only falls back when the default fails or is disabled.

​
Inbound replies and STOP/HELP handling

Inbound webhooks are how Spotzee receives replies, including STOP and HELP keywords. Spotzee writes the reply onto the user record, marks the user as opted-out for STOP, and sends back the project’s configured SMS opt-out message or SMS help message (set under Settings → General → Push and SMS). Twilio, Plivo, and Telnyx have explicit Inbound URLs that Spotzee shows in the provider’s setup metadata. Vonage and httpSMS use their own inbound message conventions; route them at the same Spotzee endpoint shown in the provider’s setup metadata.

​
Next steps

Provider catalogue

Compare providers across email, SMS, push, webhook, and in-app.

Set up a project

Configure SMS opt-out and help messages.

Manage API keys

Issue the keys your servers and apps use to talk to Spotzee.

Trigger a campaign

Send a one-shot SMS campaign through the API.