Textable

From VoIP.ms Wiki

This is the published version, approved on 30 August 2023.

Accuracy	Well sourced
Depth	High
Readability	Concise

Jump to: navigation, search

Textable


Article en Français	Artículo en Español
Français	Español

Sign up to Textable: Sign up link

Textable is a messaging platform for VoIP phone numbers used by individuals, businesses and Managed Service Providers.

Keep in touch with your customers – on the go

Your customers are constantly on the move and so are you. Give your customers the flexibility they need to keep in touch with you while you’re on the go.

Text Message from any browser

Real-time messaging application in your browser window with push notifications and always in sync with your mobile app.

Features that keep you connected with your customers as:

MMS Support
Organized Contacts
Canned Responses
Auto-Reply
Reminders
Drip Campaigns
Multi-Number Support
Away Messages

Connecting Textable to your VoIP.ms DID

Enable the VoIP.ms API

First, you should login to your customer portal
Once logged in, head to Main menu>>SOAP and REST / JSON API at https://voip.ms/m/api.php
Here, you will need to set your API Password and Enable API. You will also need to disable the IP Whitelist by entering in 0.0.0.0 and clicking “Save IP Addresses”

Enabling the VoIP.ms API

Enable SMS and SMS URL callback for your DID

We must now configure the inbound webhooks for incoming messages.

Go to DID numbers>>Manage DIDs in your customer portal (https://voip.ms/m/managedid.php)
Click the pencil icon to edit the DID number that you would like to use with Textable.
Under the Short Message Service section, check the “Enable SMS/MMS” and “SMS URL Callback” box.
Set the value of the input to https://inbound.textable.app/receive?provider=voipms&to={TO}&from={FROM}&msg={MESSAGE}&media={MEDIA}

 Note: If you are a private label customer, please replace “https://inbound.textable.app” with your private label hostname 
 (e.g. “https://privatelabel-txb.textable.app/receive?provider=voipms”). 
 You should have received this value in your onboarding e-mail, but can also be requested by emailing [email protected].

 You can optionally select the URL Retry option. This will do a continuous retry if the message failed to hit Textable' servers properly. 
 This may result in duplicate inbound messages from time to time.

Enabling SMS & SMS URL Callback

Textable configuration

In the Textable configuration interface, edit the user profile by choosing VoIP.ms as the provider and adding the API username and API password that you set up in the VoIP.ms customer portal.

Save the user details when done.

Textable configuration

Integrations

If you make use of services like Hubspot, MS Teams or Slack, Textable will allow you to integrate and use them with your VoIP.ms SMS service. To see how please see the instructions below.

HubSpot

Step 1: Create a Private App in HubSpot.
To do this, in HubSpot click on the Settings button, and then go to Integrations>>Private Apps, then click on Create a private.
On the Basic info tab, enter a name and a description for your App.

Then, click on the tab Scopes and add the following items:

crm.objects.contact.read
crm.objects.contact.write
conversations.read
conversations.write

Once you have added the scopes, click on the button Create App.

Step 2: Get the App's access token.
After creating the App, will be prompted a window where you can see the App access token. Click on "show token" and then on "copy".

 Paste the token in a notepad since you will need it to connect Textable.

 If you're not prompted a window with the token, you can go back to the Private Apps page and click on View access token.

Step 3: Integrate HubSpot into Textable by using the token of your Private Access App.
Log into your Textable account. On the left menu, go to Integrations, locate Hubspot and click on the connector button.

On the window that will be prompted, set the following.

Select an installation option: Private App.
Name: Any name of your choice.
Webhook URL: Paste the URL of the Private App Access Token.

Click Ok when done.

And that's it. Now HubSpot is ready to receive messages from the VoIP.ms DID that is configured on Textable.

MS Teams

Step 1: Add the App to the Team that will receive the messages from Textable.
For this, in MS Teams go to Apps, search for Incoming Webhook, click on it and then click on Add to a team. Select the team and then click on Setup connector.

Step 2: Configure the App connector for the channel of the team.
Go to the team and select the channel that will receive the messages (You can create a new one if needed), then click on More options and click on Connectors. Then, search for Incoming Webhook and click on Configure.

Set a name for the incoming webhook and then click on Create.

 After clicking on Create an URL will be generated. Copy and paste this into a notepad because you will need it.

Step 3: Integrate MS Teams into Textable by using the Webhook URL.
Log into your Textable account. On the left menu, go to Integrations, locate MS Teams and click on the connector icon.

On the window that will be prompted, set the following.

Select an installation option: Webhook.
Name: Any name of your choice.
Webhook URL: Paste the URL that was generated in Step 3.

Click Ok when done.

And that's it. Now your MS Teams is ready to receive messages from the VoIP.ms DID that is configured on Textable.

Slack

Step 1: Create a new App in Slack. Use this link if you don't know where is this option: Create new App
Pick a name, choose a workspace to associate your app with, and then click Create App.

 Bear in mind that you'll probably be receiving a lot of messages, so you might want to create a channel for Textable too.

Step 2: Enable Incoming Webhooks.
After creating your new App, you'll be redirected to the settings page of this. From here select the Incoming Webhooks feature, and click the Activate Incoming Webhooks toggle to switch it on.

Now that Incoming Webhooks are enabled, the settings page should refresh and some extra options will appear. One of those options will be a really helpful button marked Add New Webhook to Workspace, and you should click it.

Go ahead and pick a channel that the app will post to, and then click to Authorize your app.

After authorizing the App you'll be sent back to your app settings, and you should now see a new entry under the Webhook URLs for your Workspace section, with a Webhook URL as can be seen in the picture below.

 Copy the URL because you will need it to configure Textable.

Step 3: Integrate Slack into Textable by using the Webhook URL.
Log into your Textable account. On the left menu, go to Integrations, locate Slack and click on the connector icon.