Integrations Setup

Integration Overview

Integration	Purpose	Required
ElevenLabs	Voice AI engine	Yes
Twilio	Phone numbers & SMS	Optional
Google Calendar	Appointment scheduling	Optional
HubSpot	CRM sync	Optional
Salesforce	CRM sync	Optional
Microsoft Teams	Agent presence	Optional

Navigate to Settings → Integrations to manage all connections.

ElevenLabs (Required)

ElevenLabs powers your AI voice agents with natural-sounding speech and conversational AI.

Getting Your API Key

Create an account at elevenlabs.io if you don’t have one

Navigate to API Keys

Go to your ElevenLabs dashboard → Profile → API Keys

Generate Key

Click “Create new API key” and copy the generated key

Store Securely

Save the key somewhere safe - it’s only shown once

Connecting to Renchi AI

Go to Settings → Integrations → ElevenLabs
Click Connect
Paste your API key
Click Verify & Save

A green “Connected” badge appears when successful.

Syncing Agents

If you have existing agents in ElevenLabs:

After connecting, click Sync Agents
Renchi AI imports all agents from your ElevenLabs account
Configure each imported agent with your business settings

ElevenLabs Features Used

Feature	Description
Conversational AI	Powers real-time voice conversations
Voice Library	Multiple natural voices (UK/US)
Knowledge Base	Upload documents for context
Phone Numbers	Provision numbers directly

Subscription Requirements

A paid ElevenLabs subscription is required. Renchi AI uses:

Conversational AI credits (per minute)
Phone number provisioning (monthly fee)
Knowledge base storage

Twilio (Optional)

Twilio provides phone numbers and SMS capabilities. Use it if you want to manage phone numbers separately from ElevenLabs.

Getting Twilio Credentials

Create Account

Find Credentials

In the Twilio Console, locate your:

Account SID (starts with AC)
Auth Token

Get a Phone Number

Purchase a phone number in your target region (e.g., UK +44)

Connecting Twilio

Go to Settings → Integrations → Twilio
Enter your Account SID
Enter your Auth Token
Click Connect

Configuring Webhooks

After connecting, configure Twilio to send call events to Renchi AI: Voice Webhook URL:

https://your-domain.com/api/webhooks/twilio/voice

Status Callback URL:

https://your-domain.com/api/webhooks/twilio/status

Recording Callback URL:

https://your-domain.com/api/webhooks/twilio/recording

Webhook URLs must be publicly accessible. Local development requires a tunnel like ngrok.

When to Use Twilio vs ElevenLabs Numbers

Scenario	Recommendation
Starting fresh	Use ElevenLabs numbers (simpler)
Existing Twilio numbers	Connect Twilio to keep them
Multiple countries	Use both as needed
Advanced call routing	Twilio for complex flows

Google Calendar

Sync appointments with Google Calendar for scheduling visibility.

Setting Up Google Integration

Navigate to Integration

Go to Settings → Integrations → Google Calendar

Authorize

Click Connect with Google and sign in with your Google account

Grant Permissions

Allow the app to view and edit your calendar

Select Calendar

Choose which calendar to sync appointments to

What Gets Synced

Direction	Data
Renchi AI → Google	New bookings create calendar events
Google → Renchi AI	Availability blocks respected

Calendar Event Format

Bookings appear in Google Calendar as:

📅 Service Call - John Smith
─────────────────────────────
When: Mon, Jan 15, 9:00 AM - 11:00 AM
Where: 123 High Street, London SW1A 1AA

Service: Boiler Repair
Phone: +44 7700 900000
Notes: "Enter through side gate"

Created by Renchi AI

HubSpot

Sync customers and calls with HubSpot CRM.

Connecting HubSpot

Navigate to Integration

Go to Settings → Integrations → HubSpot

Click Connect

Click Connect with HubSpot

Authorize

Log into HubSpot and authorize the integration

Configure Sync

Choose which data to sync

Sync Options

Contacts
Calls
Deals

New customers create HubSpot contacts
Contact updates sync both ways
Phone numbers match existing contacts

Field Mapping

Renchi AI Field	HubSpot Field
Customer Name	Contact Name
Phone	Phone Number
Email	Email
Address	Address
Last Call	Last Activity Date
Total Bookings	Custom Property

Salesforce

Enterprise CRM integration for Salesforce users.

Connecting Salesforce

Navigate to Integration

Go to Settings → Integrations → Salesforce

Click Connect

Click Connect with Salesforce

Enter your Salesforce credentials

Authorize

Grant access to the connected app

Data Sync

Object	Sync Direction
Contacts	Bidirectional
Accounts	Renchi AI → Salesforce
Activities	Renchi AI → Salesforce
Custom Objects	Configurable

Requirements

Salesforce integration requires:

Salesforce Professional or higher
API access enabled
Connected App permissions

Microsoft Teams

Show agent availability and enable warm handoffs through Teams.

Setting Up Teams Integration

Navigate to Integration

Go to Settings → Integrations → Microsoft Teams

Click Connect with Microsoft and sign in

Grant Permissions

Authorize presence and messaging access

Map Users

Link Renchi AI team members to Teams accounts

Features

Feature	Description
Presence Sync	Show agent availability in Renchi AI
Notifications	Alert team of transfers via Teams
Call Handoff	Warm transfer to Teams call

Firecrawl (Knowledge Base)

Firecrawl enables web scraping to build your agent’s knowledge base automatically.

How It Works

Enter a URL from your website
Firecrawl extracts the content
Content is cleaned and formatted
Uploaded to ElevenLabs knowledge base
Your agent can reference this information

Using Web Crawl

Go to Agents → [Agent] → Context Tab
Click Crawl Website
Enter the URL (e.g., your FAQ page)
Set crawl depth:
- 1 - Just this page
- 2 - Page + linked pages
- 3 - Deeper crawl (use carefully)
Click Start Crawl
Review extracted content
Click Sync to Agent

Best Pages to Crawl

FAQ pages
Service descriptions
Pricing pages
About us
Terms of service
Contact information

Only crawl pages you own or have permission to use. Respect robots.txt.

Managing Integrations

Checking Status

The Integrations page shows status for each connection:

Status	Meaning
🟢 Connected	Working normally
🟡 Reconnect Required	Token expired, needs reauth
🔴 Error	Connection failed
⚪ Not Connected	Never set up

Disconnecting

To remove an integration:

Go to Settings → Integrations
Find the integration
Click Disconnect
Confirm the action

Disconnecting stops all syncing. Existing data in the external system remains.

Troubleshooting

ElevenLabs shows 'Invalid API Key'

Verify the key is copied correctly (no extra spaces)
Check your ElevenLabs subscription is active
Generate a new key if needed

Twilio webhooks not receiving events

Verify webhook URLs are publicly accessible
Check the URLs are correctly configured in Twilio Console
Ensure your domain SSL certificate is valid

Google Calendar not syncing

Try disconnecting and reconnecting
Check you selected the correct calendar
Verify Google account permissions

CRM contacts duplicating

Check field mapping for phone number matching
Enable duplicate detection if available
Review sync direction settings

Data Privacy

What Data is Shared

Integration	Data Shared
ElevenLabs	Voice audio, transcripts, knowledge base
Twilio	Call metadata, recordings (if enabled)
Google Calendar	Appointment details, customer names
HubSpot/Salesforce	Customer profiles, call logs
Microsoft Teams	User presence, notifications

Compliance

Review your data processing agreements with each provider. Ensure integrations comply with GDPR if serving EU customers.

​Integration Overview

​ElevenLabs (Required)

​Getting Your API Key

​Connecting to Renchi AI

​Syncing Agents

​ElevenLabs Features Used

​Subscription Requirements

​Twilio (Optional)

​Getting Twilio Credentials

​Connecting Twilio

​Configuring Webhooks

​When to Use Twilio vs ElevenLabs Numbers

​Google Calendar

​Setting Up Google Integration

​What Gets Synced

​Calendar Event Format

​HubSpot

​Connecting HubSpot

​Sync Options

​Field Mapping

​Salesforce

​Connecting Salesforce

​Data Sync

​Requirements

​Microsoft Teams

​Setting Up Teams Integration

​Features

​Firecrawl (Knowledge Base)

​How It Works

​Using Web Crawl

​Best Pages to Crawl

​Managing Integrations

​Checking Status

​Disconnecting

​Troubleshooting

​Data Privacy

​What Data is Shared

​Compliance

​Next Steps

API Reference

Webhooks Guide

Integration Overview

ElevenLabs (Required)

Getting Your API Key

Connecting to Renchi AI

Syncing Agents

ElevenLabs Features Used

Subscription Requirements

Twilio (Optional)

Getting Twilio Credentials

Connecting Twilio

Configuring Webhooks

When to Use Twilio vs ElevenLabs Numbers

Google Calendar

Setting Up Google Integration

What Gets Synced

Calendar Event Format

HubSpot

Connecting HubSpot

Sync Options

Field Mapping

Salesforce

Connecting Salesforce

Data Sync

Requirements

Microsoft Teams

Setting Up Teams Integration

Features

Firecrawl (Knowledge Base)

How It Works

Using Web Crawl

Best Pages to Crawl

Managing Integrations

Checking Status

Disconnecting

Troubleshooting

Data Privacy

What Data is Shared

Compliance

Next Steps