Setup Your SMS Channel with Bandwidth
Step 1. Open your Hoory AI dashboard. Go to Settings → Channels and click Create New Channel.
Step 2. Click the "SMS" icon.
Step 3. On the SMS Channel screen, choose "Bandwidth" as the API Provider and fill in the channel details.
These are the inputs required to create this channel. All fields are required.
| Input | Description |
|---|---|
| Channel Name | This is the channel name. It will be used across the application. |
| Phone Number | The Bandwidth number you will be using to communicate with your customers. It must start with a + sign and must not contain any spaces (for example, +14155550100). |
| Account ID | Your Bandwidth Account ID. |
| Application ID | The ID of the Bandwidth messaging application that your phone number is linked to. |
| API Key | The API credential (username) of your Bandwidth account. |
| API Secret | The API credential secret (password) of your Bandwidth account. |
Click Create Bandwidth Channel after filling in the information. If the credentials are incorrect, you will see the message "We were not able to authenticate Bandwidth credentials, please try again".
Step 4. Add agents to your channel. Select at least one agent in the Agents field. Only the selected agents will have access to this channel.
Step 5. Your channel is ready! The final screen shows the Callback URL for your channel. It looks like this:
https://app.hoory.com/webhooks/sms/<your phone number without the + sign>
Copy this URL. It is only shown on this screen, so make sure you save it before leaving the page.
Configure the Callback URL in Bandwidth
To receive messages in Hoory AI, you have to configure the callback URL in Bandwidth.
- Login to your Bandwidth Dashboard.
- Open the messaging application you used for this channel (the one matching the Application ID above).
- Paste the callback URL as the inbound message callback URL and save.
Once the callback URL is set, you will start receiving the messages in your Hoory AI dashboard.