Twilio integration

Twilio lets businesses send SMS messages from their own phone numbers, typically reminders, alerts, and notifications. Connect Twilio to NeetoCal to send SMS confirmations and reminders to your customers. This helps you,

• reduce no-shows.

• send messages from your own business number.

Should I choose Phone Number or Messaging Service? 

NeetoCal sends SMS through Twilio in two ways.

1. Pick Phone number if all your customers are in the same country as your Twilio number. NeetoCal sends every message from that one number.

2. Pick Messaging Service if your customers are from multiple countries. You add a Twilio number for each region you send to, and Twilio selects the appropriate number for each message. Some carriers block SMS messages sent from foreign numbers, so this is the safest way to cover multiple regions.

If you're not sure, start with a phone number. You can switch to a Messaging Service later.

Set up Twilio account

Once you create an account, follow the steps below:

(Go to step 7 if you have a ready to use project in Twilio).

1. Visit Twilio console and create a new project.

2. You will be asked to provide your phone number for a 2FA verification.

3. Once the verification is complete, you will be greeted by a welcome page.

4. Fill out the form (example in the picture below) and click the Get Started with Twilio button.

   

5. You will be directed to the console page.

6. Click on Messaging > Try it out > Send an SMS
   

   

7. You will be asked to get a US toll-free number. (If you plan to use a Messaging Service, you can add more numbers for other regions later in Phone Numbers > Manage > Buy a number)

   

8. Now click on Account Dashboard from the top left corner.

   

Now, you will see the Account SID and Auth Token. These values will be required to integrate your Twilio account in NeetoCal.

Create a Messaging Service in Twilio (optional)

These steps go on top of the Twilio setup above — you'll still need at least one phone number and the Account SID / Auth Token from steps 1–9. Skip this section if you're using a single phone number.

1. In the Twilio console, go to Messaging > Services.

2. Click Create Messaging Service.

3. Name the service (e.g., "NeetoCal SMS"), choose Notify my users as the use case, and click Create Messaging Service.

4. On the Add senders step, click Add Senders, choose Phone Number, and pick the numbers you want to use. Add one number per region you send to.

5. Step through the remaining screens and click Complete Messaging Service Setup. Skip the opt-out and integration steps.

   

See Twilio's sender selection docs for how Twilio picks the sender for each message.

Connecting Twilio to NeetoCal

1. Go to Admin Panel > Twilio

2. Click on Connect Twilio.

3. Copy your Twilio SID and Auth token from your Twilio account and paste the values one by one on NeetoCal.

4. Click on the Verify button to verify the values.

5. Once the values are verified, pick what NeetoCal uses to send SMS:

   • Phone number — choose a number from your Twilio account.

   • Messaging service — choose a Messaging Service from your Twilio account.

6. Click Save changes.

   

Now, you have successfully integrated Twilio with NeetoCal.

Enable SMS reminders

Connecting Twilio allows NeetoCal to send SMS messages through your Twilio account, but no SMS reminders are set up yet. You need to enable for individual scheduling link. 

For clients: see SMS reminders for client

For host: see SMS reminders for host

Enabling international SMS sending with Twilio

To send messages to countries other than the one you registered with, you need to enable SMS Geo Permissions in your Twilio account. By default, Twilio restricts SMS sending to the country used during sign-up.

You still need this if you use a Messaging Service. Geo Permissions decide which countries Twilio delivers to. A Messaging Service decides which of your numbers sends the message. They do different jobs, you usually need both for multi-region SMS.

Review this Twilio help article to enable this Twilio SMS Geo Permissions

If you continue to have issues after enabling the permissions, please contact the Twilio support team for account review and resolution: Contact Twilio Support

Verify SMS delivery

Twilio tracks whether your messages were successfully delivered. Here's how to check the status.

1. Visit https://console.twilio.com.

2. Click on the Monitor tab.

3. Click on Logs.

4. Click on Messaging.

5. Click on Error logs.

6. Look for the Status column.

   • Delivered = message sent successfully

   • Undelivered or Failed = click the message to see the error code

Troubleshooting common errors

Unreachable destination (Error 30003)

The phone number doesn't exist or isn't available. Verify that the number is correct and active.

Verification required for Toll-Free numbers

If you see "Verification required to continue using the Toll-free number," follow the verification instructions in your Twilio dashboard. Verification typically takes 3–5 business days.

For more details, see Twilio's toll-free verification guide.

Other error codes

For other errors, check Twilio's error code reference for details about what went wrong.