How to Integrate a Custom SMS Provider in Signit?
What is Custom SMS Integration Used For?
Custom SMS Integration allows organizations to connect their own third-party SMS gateway to Signit. This enables branded OTP verification and notifications via your trusted provider.
Step 1: Access and Activate
Navigate to "Organization settings" > "Integrations", select "Custom SMS provider", and click "Activate".
Step 2: Choose Your Provider
Select your SMS gateway from the list. The required fields will change based on your selection.
Step 3: Configure Provider Details
Enter the specific credentials for your chosen provider as detailed below:
Option A: Unifonic
- Unifonic App ID: The unique Application ID provided by Unifonic.
- Unifonic Sender ID: The approved sender name (e.g., "Signit") registered in your Unifonic account.
- Username: Account Username
- Password: Account’s Password
*Note: Ensure your Unifonic account is active and has sufficient balance.*
Option B: T2
- Application ID: Your T2 Application ID.
- Sender ID: The alphanumeric sender identity approved by T2.
- Username: Your T2 account username
- Password: Your T2 account password or API secret.
Option C: Msegat
- User Name: Your Msegat account username.
- API Key: The API key generated from your Msegat dashboard.
- Sender ID: The registered sender ID for your messages.
Option D: Twilio
- Account ID: Your primary Twilio account identifier.
- Auth Token: The secret token used to authenticate API requests.
- Messaging Service SID: The ID of the specific messaging service configured in Twilio for this purpose.
Option E: Other / Custom Gateway
For providers not listed, use the generic configuration:
- Gateway provider name: Name of your provider.
- Gateway API URL: The endpoint URL for sending SMS (e.g., https://api.provider.com/send).
- Gateway Method: Select GET or POST depending on the API requirements.
- Authentication: Choose "No Auth," "Basic Auth," "Bearer Token," or "API Key" and enter the credentials.
- Field Mapping: You must map the API parameters manually:
- "Message" field: The parameter name the API expects for the message body (e.g., "msg" or "text").
- "Destination" field: The parameter name for the recipient number (e.g., "to" or "mobile").
- Additional Fields: Add any extra required static parameters (like "sender_id" or "format").
Step 4: Set Allowed Countries & Test
- Select the countries you want to allow SMS traffic to.
2. Enter a mobile number and click "Send OTP" to verify the integration works.
3. If the OTP is received, enter it to complete the setup.
4. Once done, Click activate