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
- In the TAU dashboard, open the assistant and go to Settings → API Keys.
- Generate a key and select only the scopes required by the integration.
- Your server sends the key in the
Authorizationheader. - The first message creates or retrieves the customer and starts a conversation.
- The response returns a
chat_id, which must be sent with subsequent messages to preserve context. - 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.