Text messages are included in the Pro plan, and in your free trial. On Growth you can add them. Starter doesn't include them.
ZyfrHub doesn't sell texts. You connect your own account with an SMS provider, texts go out through that account, and you pay the provider directly for each one. That keeps your costs at the provider's own rates.
Set it up
- Create an account with Twilio, ClickSend, Mobile Message, SMSGlobal or Sinch, and add credit. Twilio and ClickSend send to Australia and New Zealand. Mobile Message sends to Australian mobiles only. Check with SMSGlobal about New Zealand.
- In ZyfrHub go to Settings › Text messages. Only the owner and admins can see this page.
- Choose your provider and paste your keys:
- Twilio: the Account SID and Auth Token from your Twilio console home page.
- ClickSend: your username and the API key from Developers › API credentials.
- Mobile Message: the API username and password from Settings › API.
- SMSGlobal: the API key and secret from your REST API keys page.
- Sinch: the region, service plan ID and API token from SMS › Service APIs on your Sinch dashboard.
- Something else: choose Other, tell us the provider's name and we'll look at adding it.
- Enter the number texts should be sent from, in international format (for example +61400000000). It must be a number you own with the provider, not a sender name or a shared number, because customers' replies and STOP only reach ZyfrHub when they're sent to a number you own. Twilio can also use a Messaging Service ID starting with MG.
- Choose Check and connect. ZyfrHub checks the keys with your provider before saving them.
- Type your own mobile number under Send a test text and choose Send test.
- Copy the Delivery receipts address and Replies address into your provider's settings (the page tells you where for your provider). In ClickSend, open Messaging Settings, add a rule with the action URL on the Delivery Report Rules tab for the delivery address, and another on the Inbound Rules tab (match any message) for the replies address. In Mobile Message, paste them under Settings › API. Sinch needs no delivery setup, but ask Sinch to send incoming messages to the replies address. In SMSGlobal, add them as delivery receipt and incoming message callbacks (as GET requests). This is how ZyfrHub learns that a text was delivered and receives STOP replies. Keep these addresses private.
Sending a text
Open a contact. If your provider is connected you will see a Texts card. Pick one of their mobile numbers, write your message and choose Send text. The card shows the conversation and whether each text was delivered.
- ZyfrHub texts Australian and New Zealand mobile numbers, or any number written with a + and country code. Landlines can't be texted.
- Every text ends with your business name and "Reply STOP to opt out". Messages longer than 160 characters (70 with emoji or accents) are billed by your provider as more than one text, and the card counts them as you type.
- ZyfrHub stops one workspace sending more than 300 texts in an hour, as a safety net against mistakes.
Consent and opting out
In Australia and New Zealand you need a person's consent before sending them commercial texts, and every text must say who it's from and how to opt out. You're the sender, so the responsibility is yours. ZyfrHub helps like this:
- The first time you text a contact you confirm they've agreed to hear from you (for example they gave you their number to be contacted, or they're an existing customer). ZyfrHub records who confirmed it and when.
- If someone replies STOP (or UNSUBSCRIBE, CANCEL, END or QUIT), ZyfrHub remembers that number and won't send to it again, even if it's on another contact. If they reply START, they can be texted again.
- STOP replies are matched to contacts however the number was typed (with spaces, 04…, +61…).
Provider rules also apply. Check your provider's guidance on registering numbers for Australian or New Zealand use. Sender names can't receive replies, so ZyfrHub asks for a number.
What ZyfrHub stores
- The texts you send and receive are kept on the contact's record, and are included in the full data export. Deleting a contact deletes their texts.
- Your provider keys are stored encrypted and are never shown again after you save them. Disconnecting removes them.
If something goes wrong
- "Rejected the keys": copy the keys again from your provider. For Twilio, use the Auth Token, not an API key secret.
- A text shows "Not delivered" or "Failed": the reason from your provider is shown under it. Common causes are a landline, a number that can't receive texts, or no credit.
- Delivery status stays on "Sending": the delivery receipts address isn't set up with your provider yet.
- Replies don't appear: the replies address isn't set up with your provider yet. Until it is, STOP replies can't be honoured, so set it up before you send to customers.
- You can't see Texts on a contact: check that you're on Pro (or have the add-on on Growth), and that a provider is connected.