Outgoing Conversations

So far we have seen ways to programmatically create a new conversation by either processing an incoming message or doing a direct API call, but how can an app user do that? Twilio Frontline has a dedicated Outgoing Conversation callback for that. Whenever a user initiates a new conversation from the Customer Details screen, the app will make an API request to the configured callback URL to facilitate the process.

When a user initiates a new conversation, the app does the following:

1. Creates a new conversation
2. Calls an outgoing callback with GetProxyAddress location. In order to add a customer to conversation the app needs to know how they're in contact with — i.e. what phone number or WA number they reach out to at — your business.
3. Adds a customer to the new conversation.
4. Adds a worker to the new conversation.
5. Navigates a user to the new conversation.

Expand image

To configure it, open Frontline console and set the Outgoing Conversation Callback URL configuration option to a URL that will respond back with a proxy phone number.

Expand image

When the Frontline application makes a POST HTTP request to your server, it includes information about the action that triggered the callback to your web application. Each action has its own Location type. The Location will be sent with the rest of the parameters in the request body in application/x-www-urlencoded format.

In addition to the location-specific parameters, each request also contains the following parameters and information:

The application needs to know a proxy address in order to add a customer as a participant to an outgoing conversation. See an example in src/routes/callbacks/outgoing-conversation.js file.

Request parameters:

Response format:

JSON response example:

1
{
2
  "proxy_address": "+123456789"
3
}