Platform/AI assistants and API

Run Yusr from Claude, ChatGPT or your own systems.

Connect Yusr to the AI assistant you already use, or to your own software through the API and webhooks. Both are on Basic and above.

Connect your AI assistantSee the API
ClaudeChatGPTCursorand any app that supports MCP
AI assistants · MCP

Your workspace, inside your AI assistant.

MCP is the open standard AI assistants use to connect to other apps. Add Yusr once, and your assistant can look things up in your workspace and, if you allow it, act on it. You ask in plain words; it picks the right tool.

  1. Add the connectorIn Claude or ChatGPT, add a custom connector with this address:https://yusr-ai.com/mcp
  2. Sign in and chooseSign in to Yusr, pick the workspace, and choose read-only or read and change.
  3. Ask“Who is still waiting for a reply?” It answers from your real data.
ClaudeYusr connected
Who is still waiting for a reply, and is anything broken?
Used Yusr: list_conversations, check_setup

Three customers are waiting:

  • Noura K. on Instagram asked about delivery to Jeddah, 2 hours ago.
  • Khalid A. by email asked where order #1043 is.
  • Sara M. on WhatsApp wants a Tuesday appointment.

Your channels are all connected. Want me to draft replies?

Example conversation
Look things upRead-only is enough
  • Conversations and what customers said
  • Customers and leads
  • Your business overview
  • How the AI and the team are performing
  • Catalogue and knowledge base
  • Connected channels, and whether anything is broken
Make changesNeeds read and change
  • Update a customer or a conversation
  • Add a note to a conversation
  • Add or change products
  • Teach the assistants a new document
  • Create or adjust an assistant and its scenarios
  • Choose which assistant answers a channel
  • Add a website chat; WhatsApp and Instagram give you a link to finish
  • Delete, only after asking you
Reply to customersNeeds read and change
  • Draft a reply with the full context
  • Send it to the customer on their own channel
  • Only what you asked it to send
  • Never because a customer's message told it to
Things owners ask
  • “Who is still waiting for a reply?”
  • “How did the AI do this week?”
  • “What are customers asking about most?”
  • “Move Sara to qualified and add a note.”
  • “Add the new oud collection to the catalogue.”
  • “Is any channel disconnected?”
You choose what it can doRead-only, or read and change. You see the choice before you approve.
It follows team rolesIt sees only what that person can see in the dashboard.
Every change is recordedChanges made from an assistant appear in history, like any other.
It asks before it sends or deletesAnd a customer's message can never tell it to do either.
API and webhooks

Connect your own systems.

Read and update conversations and contacts from your own app, and receive a signed event the moment something happens in Yusr.

REST API

Create a key in Yusr and send it as a Bearer token.

# List your latest conversations
curl https://yusr-ai.com/api/v1/conversations \
  -H "Authorization: Bearer yusr_…"
GET/api/v1/conversationsList conversations
GET/api/v1/conversations/{id}Read one conversation
PATCH/api/v1/conversations/{id}Open or close it, star it, or pause the AI
GET/api/v1/conversations/{id}/messagesRead the messages
POST/api/v1/conversations/{id}/messagesSend a reply
GET/api/v1/contactsList contacts
POST/api/v1/contactsCreate a contact
GET/api/v1/contacts/{id}Read one contact
PATCH/api/v1/contacts/{id}Update a contact
POST/api/v1/channels/{id}/messagesBring a message in from your own app

Webhooks

Choose the events, give us your address, and we post each one, signed with HMAC-SHA256 in the X-Yusr-Signature header.

  • message.receivedA customer wrote
  • message.sentA reply went out
  • conversation.closedA conversation was closed
  • lead.createdA new lead was saved
  • lead.stage_changedA lead moved stage
  • order.createdAn order was started
  • order.submittedThe customer confirmed an order
  • order.cancelledAn order was cancelled

Using n8n? Point a webhook at it and start a workflow from any of these events.

Ready to put Yusr to work?

Start on the free plan. No card needed.

Start free Book a demo