BulkVS

BulkVS provides a whole range of telecommunications services with API access for developers. With Ringotel and BulkVS integration, you can enable SMS and MMS messaging for softphone users in a few clicks.

How does it work

The integration allows you to add your BulkVS SMS-enabled phone numbers and assign multiple users who can send/receive messages via these numbers.

SMS/MMS integration is part of the Pro package. Upgrading an organization to Pro pricing is required to enable this feature.

Enable SMS service

  1. Navigate to the connection’s features settings in an organization where you would like to enable the integration. Then, set Enable SMS via Integrations and hit Save changes.

Set up the Integration

Navigate to your organization → Integrations tab. Click the Set up Integration button on the BulkVS panel. Then, copy Webhook URL provided.

Navigate to your BulkVS admin portal (https://portal.bulkvs.com ) → Messaging → Message Webhooks and click Create under Add Webhook to create a new entry. Enter a Webhook Name, and in the Url field, enter the previously copied Webhook URL from the Ringotel admin portal. Click Create Host to create an entry.

Once an entry is created, navigate to API → API Credentials. Copy the provided API Username and API Password/Token and paste them into the BulkVS integration settings in your Ringotel admin portal.

Click Save changes.

Add phone numbers

Once the integration settings are successfully saved, click the Manage users button. Add your SMS-enabled BulkVS phone numbers, and assign users who can send/receive SMS/MMS via these phone numbers. 

In the Phone number field, specify your BulkVS phone number in the E.164 format (without +), for example, 18584376047.

Select Users who will send and receive SMS/MMS via this phone number. You can click Select all to select all users from this connection. 

Session stickiness determines how long a client number will stick to a user who initiates a conversation by sending an outgoing SMS. For example, a user creates a new chat with an external client number of 5136553082. If a client replies to an SMS within the session stickiness time, the message will be routed directly to a user who initiated the conversation. Once the session stickiness timeout, the next incoming message from a client will create a new chat and the users assigned to the SMS phone number will receive a message and be able to communicate with a client.

Note: If Session stickiness is set to Disabled, it sets the timeout to 0, so every incoming message from a new client will create a new group chat.

Reformat outbound/inbound numbers options allows mitigating chats duplication when, for example, an incoming SMS is coming in one format (e.g., E.164), but users are sending outgoing SMS in another format (e.g., National). In addition, you can set a similar option for calls in the connection’s settings (Match phone numbers with e164 format option).

Click Save.

You can add more phone numbers by clicking Add SMS number button.

After setting up an integration, users who you assigned to the phone numbers will need to re-login from their Ringotel app.