Connect Twilio to PHPNuxBill

Before you start

• A Routely account (how it works).
• A Twilio account with credit, and a way to send from it: a Twilio phone number, a sender ID where Twilio allows one for your destination, or a messaging service.
• Your Account SID and Auth token, both on the home page of the Twilio Console.

Add Twilio as a gateway

1. In PHPNuxBill open Routely, then SMS, then Gateways.
2. Under Add a gateway, choose Twilio.
3. Give it a name, for example "Twilio backup".
4. Account SID: starts with AC, followed by 32 letters and numbers.
5. Auth token: next to the Account SID in the Twilio Console. It is stored encrypted and is never shown again.
6. Fill in one of these two:
   • From: a Twilio phone number in international format, for example +15551234567, or an alphanumeric sender ID where Twilio allows one.
   • Messaging service SID: starts with MG. Use this instead of From if you send through a messaging service.
7. Messages per minute: 60 is filled in. Lower it to send more gently.
8. Press Add gateway. Routely checks your Account SID and token with Twilio, and tells you if they are refused.

Send a test message

1. On the same page, find Send a test message.
2. Under Send through pick this gateway, so it is tested alone.
3. Enter a phone number with the country code and press Send test.
4. Open SMS, then History. The message shows as sent when Twilio has accepted it.

If it does not work

• Twilio did not accept the details. Copy the Account SID and Auth token again from the Console. If you regenerated the token, use the new one.
• The message failed. History shows the reason Twilio gave. Common causes are an empty balance, a From number that cannot send to that country, and a trial account that can only message numbers you have verified.
• The gateway is resting. After three failed messages in a row it rests for five minutes and messages go to your next gateway. Fix the cause, then press Use again now.