Quickstart

Your first AI reply through the ORYKSA API in three calls.

1. Create an API key

Open the API keys page (sign in with your ORYKSA account if asked) and click Create key. Copy it right away: for security we only show it once. Store it on your server (never inside a public website or app bundle).

export ORYKSA_API_KEY="oryk_live_..."   # from Account > Developer

curl https://api.oryksa.com/v1/account -H "Authorization: Bearer $ORYKSA_API_KEY"

2. Teach the business

The AI employee answers from the business profile and the knowledge you give it. Add a first FAQ (you can later send whole pages or let ORYKSA read the live site, see Knowledge).

curl https://api.oryksa.com/v1/knowledge/faq \
  -H "Authorization: Bearer $ORYKSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"question":"What are your opening hours?","answer":"Monday to Friday, 9am to 7pm."}]}'

3. Send a customer message

curl https://api.oryksa.com/v1/chat \
  -H "Authorization: Bearer $ORYKSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Are you open on Friday afternoon?"}'

The response contains the reply and a conversation_id. Send the same conversation_id with the next message to keep the context. Every reply counts as one interaction of the plan, exactly like WhatsApp.