After you have completed the prerequisites and enabled Conversations for your account, learn how to get started.
Here you will find the complete guide on how to set up the environment, create users and agents (add roles for Agents and Supervisors), queues and routing.
Make sure you have read through the section on Before Getting Started before proceeding with this section.
To use Conversations, configure your environment. Set up a channel and configure your senders (brand representative) so that customers can reach out to you.
- Configure channels
- Create users
- Create agents
Queues and routing are optional functionalities. If you just need to manage conversation threading, you can skip this section.
- Create queue
- Configure conversations routing
Currently, you can set up SMS and Voice calls over the web interface.
Set Up SMS
Buy a two-way SMS number. In the web interface, navigate to Channels and Numbers > Numbers. You will see all the numbers you currently own. Click BUY NUMBER to purchase two-way numbers.
Add Conversations setup on the number.
To start using Conversations, select your purchased two-way number and click Use Conversation.
You can set it up for specific keywords placed at the beginning of incoming messages or for all incoming messages. The Use Conversation option will route all incoming messages to queues and agents. If a flow or a bot is set up for this number, the message will first be routed to them.
Find out more on how to set up automated flows for your numbers or learn how to connect external bots to agents.
Set Up Calls
To receive a call in Conversations, purchase a Voice number and configure it for Conversations.
- Buy a Voice number. In the web interface, navigate to Channels and Numbers > Voice. Select the number you would like to obtain. Click BUY to confirm the purchase. After the transaction has been completed, you will be redirected to the Numbers tab and the newly acquired number will be listed there.
- Enable Conversations for this number.
To complete the Conversations setup, select the number you purchased. In the Configurations side panel choose the Use Conversations action.
To use Flow features for your Voice communication in Conversations, then for the action type choose Use Conversations with Flow.
Web and In-App Calls Setup
To enable calls over the internet, follow these steps:
- Create your application via the Infobip web interface.
- Optional: configure Push for mobile
- Define application type for Conversations use case
- Set up SDKs in your application project.
Use the following guides on GitHub.
Create and Configure Application for Conversations
Navigate to Channels and Numbers > Web and In-App Calls > Applications > ADD NEW.
Then you need to fill in the application name and description, as well as all the other details requested on the page.
This is an optional step but using push is highly recommended if you want to place calls to users in the application.
- Upload APNs Certificate
- If the certificate is encrypted you must enter the password
- Enter the FCM Server API Key
Configure Application Option for Conversations
With each application, you can define in which modes that application will be used. Setup options correspond to SDK method options.
App to Conversations corresponds to SDK
CallConversations method in SDKs (Web, Android, iOS). Select this option in the application and use the above-mentioned method to forward calls to a Conversations agent.
Create Users and Assign Roles
In order to provide a more flexible approach to users and permissions, we have added four Conversations roles that can be set on the user’s profile:
- Conversations Agent – Users assigned to this role can handle conversations
- Conversations Manager – This user can manage conversations regardless to whom they are assigned
- Conversations Analytics Manager – Can check analytics and reports
- Conversations Account Manager – Users who can manage Conversations setup
Note that these roles can be combined, which means that one user can have multiple roles assigned, thus fulfilling any specific permission needs the client might have.
Every user assigned to any of the Conversations roles needs to have an active agent license.
When adding a new user, assign desired roles.
To add an agent user, make sure to assign them the Conversations Agent role. To create a user who will fulfil a supervisor role, be sure to assign them one or a combination of roles - Conversations Manager, Conversations Account Manager or Conversations Analytics Manager.
After you have set this up, the new user will get an email with login data and can successfully log in to the Conversations module.
Set up Queues and Routing
Conversations routing is a process of finding the right queue for new messages from where they can be further processed.
Note that the system will create a default route which you can use for testing and then you can create different routes based on your needs.
The new message is evaluated against each route in routing and when the first route is matched, the message is added to the specified queue. If no route is matched, the message is added to a default queue.
The order of routes inside routing is important because the new message is compared to a rule in a given order in routing to find the first match.
Routing is a set of rules which determine the assignment of a new conversation to a particular queue executed in a specific order.
Route consists of a set of conditions that determine the destination queue and priority for a new conversation.
Conditions are expressions defined based on the message or customer attributes and conversations tags.
- Both queues and routes can be managed over web interface and API.
- Only Supervisors can create and/or change route setup.
- Customers can be defined and stored in the People module.