Skip to main content

Operator API

Operator API is the REST API that can be used to integrate customer engagement platforms with Tovie Platform.

You can use the Operator API to connect any customer engagement platform to the chatbot project created on Tovie Platform. When the agent application is integrated with the platform, data received by the chatbot during the conversation with the client is sent to the application.

You can use API methods to:

  • Send a message or a file link to an agent.
  • Select a group of agents for message processing.
  • Pass additional client info to an agent.
  • Subscribe to notifications used by the Operator API to notify about messages for the client, delivery of client messages, message closed by an agent or other events.
tip

Learn how to create an Operator API channel

Getting started​

  1. Create a web server. It must support the following requests:

    MethodDescription
    POST {apiUrl}/setWebhookThe method sets the URL where events will be routed to be processed by Tovie Platform.
    GET {apiUrl}/getDestinationsGet available agent groups where events can be routed to.
    POST {apiUrl}/selectDestinationCreate a session between the chatbot client and the selected agent.
    POST {apiUrl}/sendTextThe client sent a message to the chat with the agent.
    POST {apiUrl}/sendFileThe client sent a file to the chat with the agent.
    POST {apiUrl}/closeChatThe client closed the chat with the agent.
    tip
    For Operator API integration, specify the web server URL (apiUrl) where Operator API requests will be routed to.

    {apiUrl}/setWebhook will receive a request containing the url field in its body. The value of that field is Tovie Platform webhook you need to route events to according to the specification.

  2. Create an Operator API channel and specify the URL of your web server in the API URL field.