Integration · Customer support

Connect Claude & ChatGPT to raia

Ask your AI to put a question to your raia agent, find a customer's conversation, or read what the agent told them. It can search conversations, list messages with user votes, look up users and check the agent's statistics and usage. When a chat needs a person, it can switch the conversation to manual and send a message written by you.

Connect raia free

Free plan, no credit card. Takes about a minute.

Try asking

“Ask our raia agent what our return policy says about opened items.”
The AI sends a one-off question to the agent and returns its answer, without starting a saved conversation.
“Find the conversation with [email protected] and show me the messages.”
It finds the user by email, searches their conversations and lists the messages, oldest first.
“Which conversations mention a refund this week?”
It searches conversations by keyword and an updated-at date range and lists titles, users and status.

What your AI can do

Talk to the agent

Ask the agent one-off questions, start conversations with existing users and send messages into a conversation to get the agent's reply.

Conversations and users

Search and read conversations and messages, see user votes, find users by email, phone or your own ID, and update or archive conversations.

Human handover and insight

Switch a conversation between AI and manual mode, send human-written messages, and read the agent's details, statistics, usage and files.

“How active was the agent last month, and how many tokens did it use?”
It reads the agent's statistics for the date range and its usage of tokens, SMS and emails.
“Take over the chat with Peter and tell him we will call him tomorrow.”
It switches the conversation to manual so the agent stays silent, then sends your message to Peter on his channel.
“Which files is the agent's knowledge base built on?”
It lists the files uploaded to the agent's knowledge base with their IDs.

45 tools for raia

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

ask_agentChanges dataSend a one-off question to the raia agent in `prompt` and get its answer back, without starting a saved conversation.
create_a_prompt_requestChanges dataCreate a new message. Required: prompt. Search messages first to avoid duplicates. API summary: Create a prompt request.
create_conversationChanges dataStart a new conversation between the agent and an existing user, given `conversation_user_id`, plus an optional `title` and background `context`. Find the user first with find_user or list_users.
create_conversation_user_limits_by_idChanges dataCreate a new user for a user. Required: tokens amount per month, sms amount per month, emails amount per month or seconds amount per month. Search users first to avoid duplicates. API summary: Create conversation user limits by ID.
create_document_to_vector_storeChanges dataCreate a new document. API summary: Add agent file to vector store by ID.
create_limitChanges dataCreate a new limit. Required: tokens amount per month, sms amount per month, emails amount per month or seconds amount per month. API summary: Create agent limits by Agent API key.
create_or_update_conversation_message_feedbackVisible to othersCreate a new message. Required: conversation message id, user id, vote type or question. Search messages first to avoid duplicates. Has effects visible outside this system. API summary: Create or update conversation message feedback.
create_resource_usageChanges dataCreate a new resource usage. Required: type or amount. API summary: Add new resource usage log.
create_userChanges dataCreate a new user. Required: body. Search users first to avoid duplicates. API summary: Create a conversation user.
create_webhookDeletesCreate a new webhook. Required: title, description, url or trigger condition. Destructive action; may require approval. API summary: Create agent webhook.
delete_document_deletesMoves moneyPermanently delete a delete by agent file id. Financial or irreversible action; may require approval. API summary: Delete agent file by ID.
delete_document_from_vector_storeDeletesPermanently delete a document by agent file id. Destructive action; may require approval. API summary: Delete agent file from vector store by ID.
delete_documentsMoves moneyPermanently delete a document. Financial or irreversible action; may require approval. API summary: Delete agent files by IDs.
delete_limitsMoves moneyPermanently delete a limit. Financial or irreversible action; may require approval. API summary: Delete agent limits by Agent API key.
delete_messagesMoves moneyPermanently delete a message. Financial or irreversible action; may require approval. API summary: Delete all user conversations in current agent.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete conversation user by ID.
delete_usersMoves moneyPermanently delete a user by user id. Financial or irreversible action; may require approval. API summary: Delete conversation user limits by ID.
find_userFind a conversation user by `email`, `phone_number` or your own external ID `fk_id`. Use this before creating a conversation for someone.
get_agentGet the details of the raia AI agent this connection is linked to (its name and configuration). Use to confirm which agent you are talking to.
get_agent_admin_users_by_agent_api_keyList users. Optional filters: order by or order direction. Results are paginated. API summary: Get agent admin users by Agent API key.
get_agent_statisticsGet activity statistics for the agent, for an optional `start_date` to `end_date` range or a single user.
get_agent_usageGet the agent's resource usage, such as tokens, SMS and emails consumed.
get_conversationGet one conversation by `message_id` (the conversation ID), including its title, status, mode and user.
get_userGet one conversation user by `user_id`, with their contact details.
list_agent_filesList the files uploaded to the agent's knowledge base, with their IDs.
list_conversation_messagesList all messages in a conversation by `conversation_id`, oldest or newest first via `order_direction`. Set `should_include_feedbacks` to also get user votes.
list_document_messagesList messages for a document. API summary: Get signed download URL for conversation message file.
list_limitsList limits. API summary: Get agent limits by Agent API key.
list_message_response_onsList response ons for a message. API summary: Get response on.
list_messagesList messages. API summary: Get conversation states.
list_prompt_response_onsList response ons for a prompt. API summary: Get a response on prompt request.
list_usersList the users who have talked to this agent, paginated with `page` and `limit` and sorted with `order_by` and `order_direction`.
list_users_2List users for a user. API summary: Get conversation user limits by ID.
search_conversationsSearch the agent's conversations by `search_keyword` (title, summary, user name, email or phone), `user_id`, or an updated-at `start_date`/`end_date` range. Paginated with `page` and `limit`.
send_a_message_to_an_agent_asyncVisible to othersCreate a new message. Required: message. Search messages first to avoid duplicates. Has effects visible outside this system. API summary: Send a message to an agent (async).
send_manual_messageVisible to othersSend a message written by a human (`message`) straight to the user in a conversation (`conversation_id`), bypassing the AI. The user receives it on their channel, and it cannot be unsent.
send_message_to_agentVisible to othersSend a `message` into a conversation (`conversation_id`) as the user and get the agent's reply. Optional `context` adds background for this message only.
set_conversation_modeVisible to othersSwitch a conversation (`conversation_id`) between `mode` ai (the agent answers) and manual (a human answers and the agent stays silent).
start_a_new_conversationChanges dataCreate a new message. Required: body. Search messages first to avoid duplicates. API summary: Start a new conversation.
update_conversationChanges dataUpdate a conversation's `title`, `context` or `status` (active, inactive, archived) by `message_id` (the conversation ID). Only the fields you pass change.
update_limitsVisible to othersUpdate an existing limit. Has effects visible outside this system. API summary: Update agent limits by Agent API key.
update_messages_external_api_agent_files_controller_add_file_to_Visible to othersUpdate an existing message identified by agent file id. Has effects visible outside this system. API summary: Add agent file to vector store asynchronously by ID.
update_usersVisible to othersUpdate an existing user identified by user id. Has effects visible outside this system. API summary: Update conversation user limits by ID.
upload_document_urlVisible to othersUpload a document (conversation id). Has effects visible outside this system. API summary: Create signed upload URL for conversation message file.
upload_prompt_urlChanges dataUpload a prompt. API summary: Create signed upload URL for prompt file.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose raia from the app list.
2
Paste your key
Paste your raia Agent Secret Key. In raia Command, open your agent and enable the API Skill; this generates the agent's Agent Secret Key. Each key is scoped to a single agent, so connect one HeyMyApps endpoint per agent.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in raia?

The AI can ask your raia agent questions, start conversations and send messages into them, and read the agent's details, statistics, usage and knowledge base files. It can search and read conversations and messages, find and list users, update a conversation's title, context or status, switch it between AI and manual mode, and send a human-written message to the user.

Does the AI see my raia credentials?

No. Your Agent Secret Key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. A manual message reaches the user on their channel and cannot be unsent, and switching a conversation to manual silences the agent. These actions can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own raia account.

Can I connect more than one raia agent?

Yes, but each Agent Secret Key belongs to a single agent. To use several agents, enable the API Skill on each one and connect each key as its own HeyMyApps endpoint. The AI can call get_agent to confirm which agent a connection is linked to.