diff --git a/docs/api-reference/phone/buy.mdx b/docs/api-reference/phone/buy.mdx new file mode 100644 index 000000000..99a6fda06 --- /dev/null +++ b/docs/api-reference/phone/buy.mdx @@ -0,0 +1,21 @@ +--- +title: 'Buy AI phone number' +api: 'POST https://api-v2.opencopilot.so/backend/voice-channel/phone-number/buy' +authMethod: 'bearer' +description: 'This endpoint allows you to purchase a new phone number for your organization, enabling AI-driven communication. The phone number can be used to automatically answer calls, handle customer complaints, and respond to questions efficiently, leveraging AI to enhance customer support and streamline interactions.' +--- + + + The unique identifier for the copilot (organization) you want to create an AI + phone for. This is a required parameter. + + + + The area code for the phone number you want to buy. This is a required + parameter. + + + + The name to associate with the purchased phone number. If not provided, a + default name will be used. + diff --git a/docs/api-reference/phone/delete.mdx b/docs/api-reference/phone/delete.mdx new file mode 100644 index 000000000..d88c76232 --- /dev/null +++ b/docs/api-reference/phone/delete.mdx @@ -0,0 +1,11 @@ +--- +title: 'Delete phone number' +api: 'DELETE https://api-v2.opencopilot.so/backend/voice-channel/phone-number/:phone_number_id' +authMethod: 'bearer' +description: 'This endpoint allows you to delete a phone number from your organization' +--- + + + The unique identifier for the phone number you would like to delete from your + organization + diff --git a/docs/api-reference/phone/get-all-phones.mdx b/docs/api-reference/phone/get-all-phones.mdx new file mode 100644 index 000000000..24863935e --- /dev/null +++ b/docs/api-reference/phone/get-all-phones.mdx @@ -0,0 +1,38 @@ +--- +title: 'Get all phone numbers' +api: 'GET https://api-v2.opencopilot.so/backend/voice-channel/phone-numbers/:organization_id' +authMethod: 'bearer' +description: 'This endpoint allows you to list all the phone number of your organization.' +--- + + + The unique identifier for the copilot (organization) you want to create an AI + phone for. This is a required parameter. + + + +```json Response +[ +{ + "id": "123e4567-e89b-12d3-a456-426614174000", + "organization_id": "15ca3add-0b6c-4fca-9829-b13bc8a39bba", + "provider_id": "091274", + "phone_number": "+14155690123", + "name": "My AI phone agent that calms down customers", + "base_prompt": "You are phone voice assistant. Always provice a short, to the point, and clear response. Do not engage in conversation with the user. Always ask the user to configure their account on Open CoPilot.", + "initial_message": "Hello, this phone is being managed by Open, how can I help you today?", + "handoff_phone_number": "+15103435446", + "created_at": "2024-08-12T22:02:40.000Z" +}, +{ "id": "568e0f1d-f81f-4b31-a8dc-3c19be8a4654", + "organization_id": "b492c760-f0c4-43a7-8027-fa6c181f3369", + "provider_id": "091274", + "phone_number": "+14155690907", + "name": "My AI phone agent that compliments customers", + "base_prompt": "You are phone voice assistant. Always provice a short, to the point, and clear response. Do not engage in conversation with the user. Always ask the user to configure their account on Open CoPilot.", + "initial_message": "Hello, this phone is being managed by Open, how can I help you today?", + "handoff_phone_number": "+15103435446", + "created_at": "2024-08-24T12:01:59.000Z"} +] +``` + diff --git a/docs/api-reference/phone/update.mdx b/docs/api-reference/phone/update.mdx new file mode 100644 index 000000000..e93fba9f2 --- /dev/null +++ b/docs/api-reference/phone/update.mdx @@ -0,0 +1,35 @@ +--- +title: 'Update phone number' +api: 'PUT https://api-v2.opencopilot.so/backend/voice-channel/phone-number/:phone_number_id' +authMethod: 'bearer' +description: 'This endpoint allows you to update a phone number from your organization' +--- + + + The unique identifier for the phone number you would like to update from your + organization + +{/* body */} + + The name that identifies your AI phone + + + + The base prompt guides the AI's responses when interacting with customers. It + serves as the foundational instruction set for the AI phone, defining how it + should initiate conversations, handle customer inquiries, and respond to + various scenarios. This prompt helps ensure that the AI provides consistent + and relevant responses tailored to the specific needs of the organization and + its customers. + + + + The handoff phone number is the phone number that the AI agent uses to handoff + the conversation with the customer if the customer asks to talk to a human, or + the AI phone agent cannot answer on of the customer's questions + + + + The initial message is the first thing that the AI phone agent says when + answering the phone call. + diff --git a/docs/introduction.mdx b/docs/introduction.mdx index d6b304a76..de3e6ca43 100644 --- a/docs/introduction.mdx +++ b/docs/introduction.mdx @@ -26,7 +26,7 @@ icon: "book" Use our phone support AI agent to handle customer support on the phone. diff --git a/docs/mint.json b/docs/mint.json index 58b06bc73..3ffec080c 100644 --- a/docs/mint.json +++ b/docs/mint.json @@ -59,7 +59,7 @@ { "group": "Phone Support", "icon": "phone", - "pages": ["phone/new"] + "pages": ["phone/phone-support", "phone/ai-phone-agent", "phone/human-phone-agent"] }, { "group": "Actions", @@ -91,6 +91,16 @@ "api-reference/contacts/update" ] }, + { + "group": "Phone", + "icon": "phone", + "pages": [ + "api-reference/phone/buy", + "api-reference/phone/get-all-phones", + "api-reference/phone/delete", + "api-reference/phone/update" + ] + }, { "group": "Email", "icon": "envelope", diff --git a/docs/phone/ai-phone-agent.mdx b/docs/phone/ai-phone-agent.mdx new file mode 100644 index 000000000..e5aadb89d --- /dev/null +++ b/docs/phone/ai-phone-agent.mdx @@ -0,0 +1,45 @@ +--- +title: 'AI Phone Agent' +icon: 'headset' +--- + +The **AI Phone Agent** is designed to enhance your organization's customer service by: + +- **Answering calls immediately** without any delay, ensuring your customers are attended to as soon as they call. +- **Handling customer inquiries** with AI-driven responses that are both accurate and context-aware. +- **Redirecting calls to a human agent** if the customer requests human assistance or if the AI Phone Agent is unable to provide an appropriate answer. The transition is seamless, ensuring a smooth experience for the customer. + +### Buying an AI Phone Number + +To get started with the AI Phone Agent, you can buy an AI phone number directly from the dashboard. This number will be linked to your organization and can be customized for specific use cases. + +Buy AI Phone Number + +### Customizing the AI Phone Agent + +You can change the base prompt of the AI Phone Agent to tailor it to different scenarios within your business. For example, you might want to have different AI agents for various departments, such as: + +- **Customer Support:** An AI agent specifically trained to handle common product questions and basic troubleshooting. +- **Sales Inquiries:** An AI agent focused on providing information about your products and services, helping to drive sales. + +Buy AI Phone Number +In general, consider the following when customizing your AI Phone Agent: + +- **Keep the base prompt clear and concise** to ensure the AI understands the core responsibilities. +- **Simplify the language** to make the AI's responses easy to understand, especially over the phone. +- **Align the prompt with specific goals**, such as increasing sales conversions or improving customer satisfaction. + +{/* ### Video Demo + + */} + +{/* This video provides a demo of the AI phone agent answering calls and handing off to a human agent to answer. The human agent is talked about more in the following section. */} diff --git a/docs/phone/buy-ai-phone.png b/docs/phone/buy-ai-phone.png new file mode 100644 index 000000000..26c639e26 Binary files /dev/null and b/docs/phone/buy-ai-phone.png differ diff --git a/docs/phone/customize-phone.png b/docs/phone/customize-phone.png new file mode 100644 index 000000000..e7dd31462 Binary files /dev/null and b/docs/phone/customize-phone.png differ diff --git a/docs/phone/human-phone-agent.mdx b/docs/phone/human-phone-agent.mdx new file mode 100644 index 000000000..0600a643d --- /dev/null +++ b/docs/phone/human-phone-agent.mdx @@ -0,0 +1,38 @@ +--- +title: 'Human Agent' +icon: 'user-headset' +--- + +The **Human Phone Agent** empowers your organization with a personal touch, enabling human agents to: + +- **Make outbound calls** directly to customers, using the handoff phone number set up after purchasing the AI phone number. +- **Receive incoming calls**, ensuring that customer queries and issues are handled by a real person when needed. +- **Instantly call contacts**, allowing for quick and efficient communication with key customers or stakeholders. + +### Setting Up the Handoff Phone Number + +After purchasing your AI phone number, you can set up a handoff phone number for human agents. This number will be used to make and receive calls, offering a seamless transition from AI to human interaction. + +Setup AI Phone Number + +### Using the Human Phone Agent + +Once the handoff phone number is configured, human agents can immediately begin making and receiving calls. This feature is especially useful for: + +- **Personalized customer support**: When AI alone isn’t enough, human agents can take over to provide detailed and empathetic support. +- **Sales and follow-ups**: Human agents can directly engage with leads and clients, driving sales and fostering stronger relationships. + +{/* ### Video Demo +This video provides a quick demonstration of how to set up and use the Human Phone Agent, showcasing the ease and efficiency of integrating human agents into your communication flow. + */} + + diff --git a/docs/phone/new.mdx b/docs/phone/phone-support.mdx similarity index 100% rename from docs/phone/new.mdx rename to docs/phone/phone-support.mdx diff --git a/docs/phone/setting-up-phone.png b/docs/phone/setting-up-phone.png new file mode 100644 index 000000000..fc8dfa832 Binary files /dev/null and b/docs/phone/setting-up-phone.png differ