Integrations

Integrations connect your Valuez AI agents to the outside world. Without an integration, your agent can only be tested inside the platform. Once connected, it starts handling real conversations - through your website, a phone number, or an external application. Click Integrations in the left sidebar to open the Integrations screen.

The Integrations Screen

The Integrations screen shows all your active integrations as cards. Each card displays:

Field	What It Shows
Integration Name	The label you gave this integration when creating it
Provider	The integration type - e.g. `TTS-STT API Key`
Created on	The date this integration was created
Three dots menu	Options to edit or delete the integration

Use the search bar at the top right to find a specific integration by name. Click + Add Integration to create a new one.

Adding a New Integration

Click + Add Integration at the top right. The Add New Integration popup appears with four integration types across three categories.

The left sidebar of the popup has three categories - Website, API, and IVR. Click All Integrations to see every available option at once.

Integration Types

Website

The Website integration embeds your AI agent as a chat or voice widget directly on your website. Visitors can interact with your agent without needing to make a phone call. Use this when: You want to add an AI assistant to your website homepage, contact page, or support portal. To set up: Select Website from the left sidebar, click the Website option, then click Add Integration. You will receive an embed code to paste into your website’s HTML.

API - Agent API

The Agent API gives external applications programmatic access to your AI agents - triggering conversations, sending messages, and receiving responses via API calls. Use this when: You want to trigger agent conversations from your CRM, custom application, or automation workflow. To create an Agent API key:

Select API integration

Click API in the left sidebar of the popup, then select Agent API and click Add Integration.

Select Agent

In the Create API Key dialog, use the Select Agent dropdown to choose which agent this key will connect to.

Name your integration

Enter a descriptive name in the Name Integration field - e.g. CRM Integration or Mobile App Key. This label helps you identify it later.

Set a credit limit

Enter a Credit Limit (Monthly) to cap how many credits this integration can consume per month. This prevents unexpected overuse.

Configure endpoint access

Under Endpoints, set access for each conversation mode independently:

Text to Text - toggle Access to allow text-based conversations via API
Speech to Speech - toggle Access to allow voice-based conversations via API Set either to No Access to restrict that mode for this key.

Create the key

Click Create Key. Your API key is generated. Copy it immediately - it is only shown once.

Copy your API key as soon as it is generated. For security reasons, the full key is only displayed once. If you lose it, you will need to delete it and create a new one.

API - STT/TTS API

The STT/TTS API gives you direct access to Valuez AI’s speech-to-text and text-to-speech infrastructure - independent of any specific agent. Use this to build custom voice applications that use Valuez AI’s voice processing capabilities. Use this when: You are building a custom application that needs speech recognition or voice synthesis without going through a full agent conversation flow. To create an STT/TTS API key:

Select STT/TTS API

Click API in the left sidebar, select STT/TTS API, and click Add Integration.

Name your integration

Enter a descriptive name in the Name Integration field - e.g. My Mobile App Speech Key.

Set a credit limit

Enter a Credit Limit (Monthly) to cap monthly usage for this key.

Create the key

Click Create Key. Your STT/TTS API key is generated.

STT/TTS	What It Does
STT (Speech to Text)	Converts spoken audio into text - used to transcribe what callers say
TTS (Text to Speech)	Converts text into spoken audio - used to generate what your agent says

IVR

The IVR integration connects your agent to a phone number through an Interactive Voice Response system. This is how you enable real inbound calling - customers call a phone number and your AI agent answers automatically. Use this when: You want customers to be able to call a real phone number and have your AI agent handle the conversation. To set up: Select IVR from the left sidebar, click IVR, then click Add Integration and follow the phone number configuration steps.

Managing Existing Integrations

From the Integrations screen you can manage all active integrations:

Action	How
View all integrations	All active integrations are shown as cards on the main screen
Search	Use the search bar top right to find an integration by name
Edit an integration	Click the three dots menu on any card and select Edit
Delete an integration	Click the three dots menu on any card and select Delete

Deleting an integration immediately revokes access for any system using that key. Make sure to update your application or website before deleting an active integration.

Which Integration Should You Use?

Your Goal	Integration to Use
Add a chat or voice widget to your website	Website
Connect your CRM or custom app to an agent	Agent API
Build a custom voice app using Valuez AI’s speech engine	STT/TTS API
Enable customers to call a phone number	IVR
Trigger agent conversations from an automation tool like Zapier	Agent API

API Logs

Monitor all STT/TTS API calls - usage, latency, transcriptions, and audio files.

API Keys

Learn about API authentication and how to manage your keys securely.

Agents

Configure the agent you want to connect before setting up an integration.

Call Logs

Review all conversations that come through your integrations.

Getting Started

Core Concepts

Voice Calling

Platform

Account

The Integrations Screen

Adding a New Integration