Partner API

Partner API

Integrate the TAU assistant with your systems, channels, and digital experiences.

Partner API

The TAU Partner API connects the assistant to the systems already used in your operation. Your application can send messages, preserve conversation context, and retrieve customer interactions without relying on a manual interface.

It is designed for partners and customers building a custom integration, such as an application, portal, CRM, service platform, or digital channel.

The production base URL is https://partners-api.taubot.ai. The interactive reference, including complete request and response formats, is available at partners-api.taubot.ai/docs.

What you can integrate

  • Send messages to the assistant individually or in batches
  • Preserve conversation continuity across messages and authorized channels
  • Retrieve conversation lists and message history
  • Control the assistant state within a customer interaction
  • Check the state of a conversation
  • Check the WhatsApp connection
  • Handle text and media in supported flows

Available operations depend on the permissions granted to your API key.

How it works

  1. In the TAU dashboard, open the assistant and go to Settings → API Keys.
  2. Generate a key and select only the scopes required by the integration.
  3. Your server sends the key in the Authorization header.
  4. The first message creates or retrieves the customer and starts a conversation.
  5. The response returns a chat_id, which must be sent with subsequent messages to preserve context.
  6. When needed, your application can retrieve conversations, history, and status through its authorized endpoints.

Keep the API key on your server. Never include it in public JavaScript, distributed applications, repositories, or logs.

Before you start

You need:

  • An active TAU assistant
  • Access to that assistant's settings
  • An API key generated with the required scopes
  • The assistant identifier used in the integration URL
  • A backend capable of making HTTPS requests

Customers generate their own API keys in the assistant settings.

Next steps

On this page