This is a sample iOS Application that exemplifies how to gather information from within an application and send that information to the Callback API and originate a callback. More information on this API can be found on the Callback API documentation page.
The main goal of the application is to collect the following information:
As Context:
- The user Name
- The Issue
- The associated Reservation number with the issue
Callback API Callback Arguments:
- The callback Phone Number (mandatory)
- Talkdesk Number (provided by the App)
For this, a simple ViewController (ViewController.swift) requests this information and builds the Context Fields. For each of these fields extra information is added (ContextField.swift):
| Field Property | Description |
|---|---|
| Name | An unique identifier for this field |
| Display Name | A Human-readable name for the field |
| Tooltip Text | An informative help text that can be shown as a tooltip on the Agent interface |
| Data Type | The type of this field (one of: phone, text, url) |
| Value | The value (a String). If the type is url, it should be a valid URI. A field of type phone should be in the E.164 format. |
The application requires an access token to contact the Callback API - see Authenticating your Requests on how to authenticate requests to the Callback API.
In this example the access token is used to contact the Callback API. This access token should be provided by the application backend, as described in detail in Using a Signed JWT. The required scope to access this API is callback:write.
Xcode 9.3 or above is required to build the app.
In order to run this sample against the Callback API, a Talkdesk ID authorization token with the correct scope is required.