For Agents
Run AI sales agents over Instagram and WhatsApp, manage conversations and leads, and orchestrate follow-up sequences through the Orsay AI platform.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Orsay AI API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Orsay AI API API.
List and inspect AI agent configurations through GET /v1/agents and GET /v1/agents/{agent_id}
Send messages from a configured agent into a conversation via POST /v1/agents/{agent_id}/message
Retrieve full conversation history and search across conversations using GET /v1/conversations and GET /v1/conversations/search-index
Connect Instagram and WhatsApp accounts through POST /v1/integrations/instagram/account and POST /v1/integrations/whatsapp/account
GET STARTED
Use for: List all conversations my AI agent is managing, Send a follow-up message in an active Instagram conversation, Connect a new WhatsApp account to my Orsay agent, Retrieve the lead profile behind a conversation
Not supported: Does not handle payment processing, ad campaign management, or SMS/email channels — use for AI-driven Instagram and WhatsApp conversations only.
Jentic publishes the only available OpenAPI document for Orsay AI API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Orsay AI API, keeping it validated and agent-ready. Orsay AI is a conversational-commerce platform that lets brands run AI agents over Instagram and WhatsApp to qualify leads, hold sales conversations, and execute follow-up sequences. The 33 endpoints span agent management, conversation history, lead context, integrations with Instagram and WhatsApp accounts, message-level feedback, sequence orchestration, organization configuration, and billing. It targets sales and customer-acquisition teams that want to automate first-touch outreach while keeping humans in the loop for handover.
Look up the lead behind a conversation with GET /v1/lead/{lead_id} for CRM enrichment
Submit message-level feedback for fine-tuning via POST /v1/conversation/{lead_id}/messages/{message_id}/feedback
Build and run automated outreach sequences through /v1/sequences endpoints
Patterns agents use Orsay AI API API for, with concrete tasks.
★ Instagram DM Lead Qualification
Brands receiving high inbound DM volume on Instagram can configure an Orsay agent to qualify leads in chat, ask discovery questions, and route hot prospects to a human. The integrations endpoints connect the Instagram account, and the agent endpoints drive the actual conversation through POST /v1/agents/{agent_id}/message.
POST /v1/integrations/instagram/account to connect, then POST /v1/agents/{agent_id}/message to reply to inbound DMs with qualification questions.
WhatsApp Outbound Sequences
Teams running paid acquisition into WhatsApp can use Orsay's sequence endpoints to deliver multi-step nurture flows that branch on response. POST /v1/sequences creates the sequence definition and POST /v1/agents/{agent_id}/message handles per-step delivery, with handoff to humans on conversion signals.
POST /v1/sequences with a 3-step welcome flow, then enroll new leads via the sequence enrollment endpoint and let the agent run delivery.
Human Handoff on Buy Intent
When a conversation shows buy intent, the agent should step back. PATCH /v1/conversation/{lead_id}/ai disables the AI on that thread so a human seller takes over without losing chat context, and GET /v1/lead/{lead_id} surfaces the full lead profile for the human's first reply.
PATCH /v1/conversation/{lead_id}/ai with enabled=false when intent score crosses threshold, then GET /v1/lead/{lead_id} for the human seller's briefing.
Conversation Export for Analytics
Operations teams want full conversation data in their warehouse to compute per-agent close rate or train on real exchanges. POST /v1/conversations/export starts a job and the GET /v1/conversations/export/{job_id}/download endpoint returns the file for ETL.
POST /v1/conversations/export, poll GET /v1/conversations/export/{job_id}/status, then download via the /download endpoint.
Agent-Driven Conversational Sales via Jentic
Sales-ops agents orchestrating multiple channels can drive Orsay through Jentic without learning all 33 endpoints. Jentic exposes the operations by intent and isolates the bearer token in the vault, letting another agent handle CRM updates while Orsay handles the chat.
Use Jentic to search 'send a message via my AI sales agent', load the POST /v1/agents/{agent_id}/message schema, and execute with the conversation id and message body.
33 endpoints — jentic publishes the only available openapi specification for orsay ai api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/conversations
List conversations across the workspace
/v1/lead/{lead_id}
Retrieve the lead behind a conversation
/v1/agents/{agent_id}/message
Send a message via an AI agent
/v1/conversation/{lead_id}/ai
Pause or resume the AI on a conversation
/v1/integrations/instagram/account
Connect an Instagram account
/v1/integrations/whatsapp/account
Connect a WhatsApp account
/v1/sequences
Create a multi-step outreach sequence
/v1/conversations/export
Start a conversation export job
/v1/conversations
List conversations across the workspace
/v1/lead/{lead_id}
Retrieve the lead behind a conversation
/v1/agents/{agent_id}/message
Send a message via an AI agent
/v1/conversation/{lead_id}/ai
Pause or resume the AI on a conversation
/v1/integrations/instagram/account
Connect an Instagram account
Three things that make agents converge on Jentic-routed access.
Credential isolation
Orsay AI bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped execution access only — the raw token never enters the agent's prompt or context window.
Intent-based discovery
Agents search by intent (e.g., 'send a message in a conversation' or 'pause AI on a conversation') and Jentic returns the matching Orsay operation with its input schema.
Time to first call
Direct Orsay integration: 1-2 weeks for OAuth-style setup, channel integration, and webhook handling. Through Jentic: hours — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Intercom API
Intercom offers AI chat and messenger across web and mobile as an alternative to Orsay's Instagram/WhatsApp focus.
Choose Intercom when the primary channel is in-app messenger rather than Instagram or WhatsApp DMs.
Instagram Graph API
Instagram Graph is the underlying platform Orsay integrates with for DM-based agents.
Use Instagram Graph directly when the team needs media management or insights beyond Orsay's conversational surface.
OpenAI API
OpenAI provides the underlying language models that often power conversational agents like Orsay's.
Use OpenAI alongside Orsay when generating bespoke replies or summaries outside the configured agent flow.
Specific to using Orsay AI API API through Jentic.
Why is there no official OpenAPI spec for Orsay AI API?
Orsay AI publishes documentation on its docs site but not a maintained OpenAPI document. Jentic generates and maintains this spec so that AI agents and developers can call Orsay AI API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Orsay AI API use?
Orsay AI uses bearer-token authentication. Through Jentic the bearer token is stored encrypted in the vault and injected only at execution time, so the agent never sees the raw secret.
Can I connect a WhatsApp account through the Orsay AI API?
Yes. POST /v1/integrations/whatsapp/account creates the integration, GET /v1/integrations/whatsapp/account lists existing connections, and GET /v1/integrations/whatsapp/profiles enumerates the linked WhatsApp profiles.
What are the rate limits for the Orsay AI API?
The OpenAPI spec does not declare numeric rate limits. Messaging-channel rate limits (Instagram and WhatsApp) often dominate in practice — confirm Orsay's per-tenant limits with their team before scaling outbound volume.
How do I pause the AI on a conversation through Jentic?
Search Jentic for 'pause AI on a conversation', load the PATCH /v1/conversation/{lead_id}/ai schema, and execute with enabled set to false. The agent stops responding while the human takes over.
Does the Orsay AI API expose billing data?
Yes. GET /v1/billing/products, GET /v1/billing/subscriptions, and GET /v1/billing/wallets return the product catalogue, current subscription state, and wallet balance for the tenant.
/v1/integrations/whatsapp/account
Connect a WhatsApp account
/v1/sequences
Create a multi-step outreach sequence
/v1/conversations/export
Start a conversation export job