How to Connect YakChat to Your Flowroute Numbers

How to Connect YakChat to Your Flowroute Numbers

Overview

YakChat can connect with your Flowroute telephony service in 5 easy steps:
  1. Add Messaging Webhooks
  2. Create an API Key and Secret
  3. Enable messaging on your DID’s
  4. Provide API information to YakChat
  5. We’ll then test the connection for you and confirm when everything is setup
After these steps, we’ll then test the connection for you and confirm when everything is set up.

Step 1: Add Messaging Webhooks

To create the Messaging Webhooks so that inbound messages and the status of outbound messages are displayed in YakChat, the following URL needs to be added as the SMS, MMS, SMS DLR and MMS DLR webhook: https://services.yakchat.com:3400/message.  

Navigate to the Preferences page in your Flowroute administration portal and select the API Control tab. Ensure that the SMS Webhook Version is set to v2.1 by selecting v2.1 in the pull down displayed in the SMS Webhook Version section of the page.




Enable SMS and add the above URL and click on the Save URL button.




Repeat for the MMS, SMS DLR and MMS DLR webhooks ensuring that each is saved by clicking on the Save URL button.




Step 2: Create an API Key and Secret

Scroll down to the API Keys section and add a new API Key for the YakChat integration  using the following steps:
 
Enter the Name and a Description.  We receommend including YakChat in either the name or the description so that the API key can be easily identified in the future. Leave the Expiration date blank and click the Add New button.




Click on the API Key displayed in the popup window to copy the key and then paste it into a document so that it can be retrieved and sent to YakChat in step 3.



Close the popup window and you will see a new API Key has been created.  Highlight the Access Key, right click to copy this key and paste it into a document so that it can also be retrieved and sent to YakChat in step 3.




Step 3: Enable Messaging on your DID’s

Navigate Manager your DIDS page using the DIDS menu on the left hand side.  Select the the DID’s that you want SMS to be enabled on using the tick boxes.




Click on the Choose a DID Action pull down and select Enable Messaging in the Messaging Options section to enable messaging on the select numbers.




Step 4: Submit your connection details

Enter the following Telnyx connection details in the the form below:
  1. Select "Flowroute" as the SMS service provider
  2. Enter your Access Key into Integration Data 1
  3. Enter your Secret Key into Integration Data 2
  4. The phone number we can use to test the service is working correctly