> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavus.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Interactions Protocol
> Control conversations with a Replica using the defined protocol by sending and listening to interaction events.
The Interactions Protocol lets you control and customize live conversations with a Replica in real time. You can send interaction events to the Conversational Video Interface (CVI) and listen to events the Replica sends back during the call.
### Interaction Types
* [Echo interactions](/sections/event-schemas/conversation-echo)
* [Response interactions](/sections/event-schemas/conversation-respond)
* [Interrupt interactions](/sections/event-schemas/conversation-interrupt)
* [Override conversation context interactions](/sections/event-schemas/conversation-overwrite-context)
* [Sensitivity interactions](/sections/event-schemas/conversation-sensitivity)
### Observable Events
* [Utterance Events](/sections/event-schemas/conversation-utterance)
* [Tool Call Events](/sections/event-schemas/conversation-toolcall)
* [Perception Tool Call Events](/sections/event-schemas/conversation-perception-tool-call)
* [Perception Analysis Events](/sections/event-schemas/conversation-perception-analysis)
* [Replica Started/Stopped Speaking](/sections/event-schemas/conversation-replica-started-stopped-speaking)
* [User Started/Stopped Speaking](/sections/event-schemas/conversation-user-started-stopped-speaking)
* [Replica Interrupted](/sections/event-schemas/conversation-replica-interrupted)
## Call Client Example
The interactions protocol uses a WebRTC data channel for communication. In Tavus's case, this is powered by Daily, which makes setting up the call client quick and simple.
Here’s an example of using DailyJS to create a call client in JavaScript:
The Daily `app-message` event is used to send and receive events and interactions between your server and CVI.
```js theme={null}
```
Here’s an example of using Daily Python to create a call client in Python:
The Daily `app-message` event is used to send and receive events and interactions between your server and CVI.
```py theme={null}
call_client = None
class RoomHandler(EventHandler):
def __init__(self):
super().__init__()
def on_app_message(self, message, sender: str) -> None:
print(f"Incoming app message from {sender}: {message}")
def join_room(url):
global call_client
try:
Daily.init()
output_handler = RoomHandler()
call_client = CallClient(event_handler=output_handler)
call_client.join(url)
except Exception as e:
print(f"Error joining room: {e}")
raise
def send_message(message):
global call_client
call_client.send_app_message(message)
```
Here’s an example of using Daily React to create a call client in React:
The Daily `app-message` event is used to send and receive events and interactions between your server and CVI.
```tsx theme={null}
"use client"
import React, { useEffect, useRef, useState } from 'react';
const TavusConversation = () => {
const [message, setMessage] = useState('');
const callRef = useRef(null);
const containerRef = useRef(null);
useEffect(() => {
const loadDaily = async () => {
const DailyIframe = (await import('@daily-co/daily-js')).default;
callRef.current = DailyIframe.createFrame({
iframeStyle: {
width: '100%',
height: '500px',
border: '0',
}
});
if (containerRef.current) {
containerRef.current.appendChild(callRef.current.iframe());
}
callRef.current.on('app-message', (event) => {
console.log('app-message received:', event);
});
callRef.current.join({
url: 'YOUR_CONVERSATION_URL',
});
};
loadDaily();
return () => {
if (callRef.current) {
callRef.current.leave();
callRef.current.destroy();
}
};
}, []);
const sendAppMessage = () => {
if (!message || !callRef.current) return;
const interaction = {
message_type: 'conversation',
event_type: 'conversation.echo',
conversation_id: 'YOUR_CONVERSATION_ID',
properties: { text: message }
};
callRef.current.sendAppMessage(interaction, '*');
setMessage('');
};
return (
setMessage(e.target.value)}
placeholder="Type a message"
/>
);
};
export default TavusConversation;
```
Built with [Mintlify](https://mintlify.com).