Skip to content

Sunono AI developer platform

Build with Sunono AI.

Connect your catalog, inventory, and orders to the conversations that drive your shop. One integration contract, from your first product update to your next order.

Start building Explore the API

Catalog & inventory Orders & webhooks JSON · CSV · XML

Your integration starts here

Build a connector that translates your commerce system’s data into Sunono’s shared format. Keep your existing system in charge of products and fulfillment, and connect it to your shopping assistant.

  • Canonical contract

    Understand events, authentication, product payloads, and signed order webhooks.

    Read the contract

  • API reference

    Find the three connector endpoints, request examples, responses, and status codes.

    Explore the endpoints

How the connection works

You build one small connector that speaks our contract. Everything flows through it — your catalog comes in, and the orders your Sunono assistant places go out to you to fulfill.

flowchart LR
    sys[("Your system:<br/>catalog & orders")]
    conn["Your connector<br/>(your format ⇄ our contract)"]
    hkj["Sunono"]
    bot(["Shopper ↔ assistant"])

    sys <--> conn
    conn -- "catalog · stock · prices" --> hkj
    hkj -- "order placed (signed webhook)" --> conn
    conn -- "order status updates" --> hkj
    hkj --- bot
  • You → Sunono: keep the catalog, stock, and prices in sync; report order status as you fulfill.
  • Sunono → you: the orders the assistant places, pushed to you signed and ready to fulfill.

The two sides never learn each other's internals — the contract in the middle is the only thing you implement.

Quickstart

  1. Get credentials. The shop owner provisions your integration in the Sunono dashboard and gives you an API key (ik_live_…) and a signing secret. The key is shown once.

  2. Push your catalog. Either stream live updates or upload a file:

    curl -X POST https://api.sunono.ai/api/integration/events \
  -H "X-API-Key: ik_live_xxx" -H "Content-Type: application/json" \
  -d '{
        "event_id": "evt-1",
        "event_type": "product.upserted",
        "data": { "sku": "HNY-500", "title_en": "Honey", "title_ar": "عسل",
                  "price_fils": 5000, "stock_qty": 12 }
      }'

    curl -X POST "https://api.sunono.ai/api/integration/bulk?format=csv" \
  -H "X-API-Key: ik_live_xxx" -F "file=@catalog.csv"
# → { "batch_id": 42, "status": "pending", "total_rows": 1200 }

  3. Receive orders. Sunono POSTs order.placed to your registered URL, signed with X-Signature. Verify the signature, create the order, and reply with your order id.

  4. Report status. As you fulfill, send order.status_changed back so the shopper can track the order in chat.

See the Canonical Contract for the full event catalogue and field-level details.

Base URL

The production API base URL is https://api.sunono.ai/api. Use your environment's API base URL for local development or testing.

Building an integration for your shop?

Walk through your catalog, order flow, and connection setup with our team.

Talk to Sunono