How to send WooCommerce order texts with Vonage or Plivo

Disclosure: Tillpress makes OrderRing. This guide was written against OrderRing 1.29.0, the first version with Vonage and Plivo support.

OrderRing 1.29.0 and later can send your WooCommerce order texts through your own Vonage or Plivo account, with the same consent, quiet-hours and STOP rules it uses for Twilio. We have not yet confirmed Vonage or Plivo with a live customer account; treat the first live texts as a test.

Get OrderRing Pro: $79 for 1 year See pricing

What moves to Vonage or Plivo, and what stays on Twilio

When you pick Vonage or Plivo, these go through that provider: order status texts, manual and bulk texts, reminders, owner alerts, checkout verification codes, and STOP / HELP / START replies.

Customer replies come back to your site through the provider’s inbound webhook.

Still Twilio only: voice calls, WhatsApp, and the Twilio message-history check. If you use voice or WhatsApp, keep your Twilio credentials in Settings as well. If voice or WhatsApp is on without Twilio credentials, OrderRing shows a warning.

One side effect of losing the message-history check: if a text was sent through Vonage or Plivo but the reply from the provider was lost, OrderRing cannot look it up. The text stays “Delivery unknown” and staff must choose Send anyway to resend it, so a customer is not texted twice by accident.

What you need

  • OrderRing 1.29.0 or newer, with an active license or the 30-day trial. OrderRing Lite is Twilio only.
  • Vonage: your API key, API secret, signature secret, and a Vonage number (or a sender ID where allowed).
  • Plivo: your Auth ID, Auth Token, and a Plivo number (or a sender ID where allowed).
  • A site on a public HTTPS address, so the provider can reach your webhooks.
  • For Vonage STOP replies: signed webhooks turned on for your account. Vonage support has to do this for you, so ask early.

Set up Vonage

  1. Ask Vonage support for signed webhooks. OrderRing refuses unsigned or wrongly signed Vonage webhooks, so STOP replies are only processed once signing is on.
  2. Choose the provider. In WordPress open OrderRing → Settings, find SMS provider and choose Vonage. Only administrators can change this.
  3. Enter your credentials. Fill in API key, API secret, Signature secret (from Vonage dashboard → API Settings) and From number or sender ID.
  4. Match the signature method. Set Signature method to the same method chosen in your Vonage API Settings. SHA-256 HMAC is recommended.
  5. Save, then copy the two webhook URLs shown on the Settings screen (they are also on Tools & Docs).
  6. Point Vonage at them. In the Vonage dashboard go to API Settings → SMS settings, choose “SMS API”, and set the Inbound SMS webhook and the Delivery receipts webhook (method POST or POST-JSON). Then link your number to the inbound URL under Numbers.
  7. Send a test. Run the setup wizard under OrderRing → Setup. Its live test SMS uses the provider you selected. Then text STOP from your own phone, check it is logged, and text START to resubscribe.

Set up Plivo

  1. Choose the provider. Open OrderRing → Settings, find SMS provider and choose Plivo.
  2. Enter your credentials. Fill in Auth ID, Auth Token and From number or sender ID. The Auth Token is also used to check Plivo’s webhook signatures, so incoming replies are refused without it.
  3. Save, then copy the Message URL shown on the Settings screen.
  4. Point Plivo at it. In the Plivo console go to Messaging → Applications, create an application with that Message URL (method POST) and attach it to your number. You do not need to set the delivery status URL: OrderRing adds it to each text.
  5. Send a test. Use the live test SMS in OrderRing → Setup, then test STOP and START from your own phone.

Credentials can also live in wp-config.php instead of the database: TOC_VONAGE_API_KEY, TOC_VONAGE_API_SECRET, TOC_VONAGE_SIGNATURE_SECRET, TOC_VONAGE_FROM, or TOC_PLIVO_AUTH_ID, TOC_PLIVO_AUTH_TOKEN, TOC_PLIVO_FROM. Constants override the Settings fields.

Common problems

  • Texts go out, but STOP does nothing (Vonage). Signed webhooks are not on yet, the signature secret is missing, or the signature method does not match. OrderRing shows a warning when the signing secret is missing.
  • Texts go out, but replies never arrive (Plivo). Check the application’s Message URL is set to POST and attached to the number you send from.
  • Customers cannot reply at all. You are sending from an alphanumeric sender ID. Customers can only reply to a number, so STOP replies need a real number.
  • Voice calls or WhatsApp stopped working. They only work through Twilio. Keep your Twilio credentials in Settings if you use either.
  • Nothing changed after updating. Existing installs stay on Twilio until you pick another provider under SMS provider.

FAQ

Do the consent and quiet-hours rules still apply?

Yes. Texts through Vonage or Plivo follow the same consent, quiet-hours, opt-out, footer, logging and retry rules as Twilio. A number that replied STOP is not texted.

Does OrderRing charge for messages?

No. You use your own provider account and pay Vonage or Plivo directly. OrderRing adds no markup.

Can I use Vonage for texts and Twilio for voice calls?

Yes. Choose Vonage as the SMS provider and keep your Twilio credentials filled in. Voice calls and WhatsApp keep using Twilio.

Does OrderRing Lite support Vonage or Plivo?

Yes. Per its WordPress.org listing, OrderRing Lite 1.5.x can send pickup texts through Twilio, Vonage or Plivo. As with Pro, Twilio is the provider tested with live accounts.

What data goes to Vonage or Plivo?

Your credentials, your sender number or ID, the customer’s phone number, the message text and your site’s delivery-status URL, each time a text is sent. The provider sends replies and delivery status back to your site.

Get OrderRing Pro: $79 for 1 year Read the docs

Vonage, Plivo and Twilio are trademarks of their owners. Tillpress is not affiliated with any of them.

Also need invoices or a product designer? The All-Access Suite ($99 a year) includes OrderRing Pro, OrderBay Pro and StoreCanvas Pro for one store.

See also

Send an order-ready text · SMS consent and STOP replies · WhatsApp order updates