SuguLive integration architecture

SuguLive is designed to fit into companies' technical ecosystems. The SuguLive REST API and real-time webhooks let you sync live sales data with your ERP, CRM, PIM (product catalog) and logistics. This guide is for technical teams (IT directors, architects, developers) who want to industrialize the SuguLive connection to their existing systems.

The 4 main integration flows

Flow 1: Product catalog synchronization (PIM → SuguLive)

Your Product Information Management (PIM) or ERP holds the truth about your catalog. SuguLive must reflect that catalog exactly in real time. The SuguLive API exposes product import/update endpoints:

POST /api/v1/products          # Create a product
PUT  /api/v1/products/{id}     # Update a product
DELETE /api/v1/products/{id}   # Delete a product
PUT  /api/v1/products/{id}/stock  # Update stock

A SuguLive product payload follows this JSON schema:

{
  "sku": "REF-12345",
  "name": "Blue Wax Dress - Size M",
  "description": "...",
  "price": 25000,
  "currency": "XOF",
  "stock": 12,
  "variants": [
    {"label": "Size", "value": "S", "stock": 5},
    {"label": "Size", "value": "M", "stock": 7}
  ],
  "images": ["https://cdn.yourcompany.com/products/ref-12345.jpg"],
  "category": "Women's fashion"
}

Recommended frequency: hourly synchronization for stock, immediate for product creation/deletion via an event from your ERP.

Flow 2: Receiving orders in real time (SuguLive → ERP)

Every sale made during a live must be injected into your OMS (Order Management System) or ERP to trigger preparation and delivery.

SuguLive sends a POST webhook to your endpoint for each confirmed order:

POST https://your-erp.company.com/webhooks/myrealshop/order

{
  "event": "order.confirmed",
  "order_id": "MRS-2025-0841",
  "live_id": "live-abc123",
  "created_at": "2025-07-10T18:23:45Z",
  "customer": {
    "id": "cust-xyz",
    "name": "Aminata Diallo",
    "phone": "+221771234567",
    "payment_method": "orange_money"
  },
  "items": [
    {
      "sku": "REF-12345",
      "variant": "M",
      "quantity": 2,
      "unit_price": 25000,
      "total": 50000
    }
  ],
  "delivery": {
    "type": "home_delivery",
    "address": "Almadies, Dakar",
    "notes": "Call before delivery"
  },
  "payment": {
    "method": "orange_money",
    "status": "confirmed",
    "amount": 50000,
    "currency": "XOF",
    "transaction_id": "TXN-OM-892346"
  }
}

Securing webhooks: Each webhook is signed with an X-SuguLive-Signature header (HMAC-SHA256 with your secret key). Verify this signature on the ERP side before processing the event.

Flow 3: Delivery status updates (ERP → SuguLive)

Once the order is prepared and shipped, your ERP must notify SuguLive so that the customer and seller receive real-time status updates.

PUT /api/v1/orders/{order_id}/status

{
  "status": "shipped",  // confirmed | processing | shipped | delivered | cancelled
  "tracking_number": "DHL-876543",
  "estimated_delivery": "2025-07-12"
}

Flow 4: CRM synchronization — customer history (SuguLive → CRM)

Live buyers' behavioral data (products viewed, products purchased, purchase frequency, average basket) enriches your CRM for segmentation and marketing targeting.

SuguLive offers a daily export of customer events via the API:

GET /api/v1/customers?updated_since=2025-07-09T00:00:00Z

# Returns the list of customers with their live engagement metrics:
# - total_purchases, total_spent, last_purchase_date
# - lives_watched_count, average_watch_time
# - favorite_categories, preferred_payment_method

Available native integrations

For the most common systems on the African market, SuguLive offers native no-code connectors:

Odoo (ERP) — Native connector available. Real-time catalog and order synchronization.
Sage (accounting/management) — Sales and payment synchronization
Hubspot (CRM) — Export of customer data and purchase events
Zoho CRM — Integration via Zapier (available)
WooCommerce / PrestaShop — Official plugin for existing e-commerce stores

Security and data compliance

API authentication

The SuguLive API uses OAuth 2.0 with short-lived JWT tokens (1 hour). Refresh tokens have a 30-day lifetime. API keys can be regenerated at any time from the Corporate dashboard.

Personal data (GDPR/data protection)

SuguLive complies with applicable personal data protection requirements. Customer data is never shared with third parties without explicit consent. Your company can request the export or deletion of a customer's data at any time.

API availability

The SuguLive API is available 24/7 with a 99.5% SLA for Corporate accounts. A staging environment is available for your developers with no impact on production.

Typical integration timeline

D1-D3: Access to the API documentation, creation of credentials, exploration of the staging environment
D4-D7: Develop the PIM → SuguLive catalog connector
D8-D12: Develop the order webhook receiver + ERP injection
D13-D15: End-to-end tests in staging. Simulate 50 live orders.
D16: Go live. First live with full integration.

Technical support for Corporate teams

SuguLive Corporate accounts include direct access to our technical team: private Slack channel, complete Postman documentation, technical ticket responses in under 4 business hours. A dedicated Technical Account Manager supports complex integrations.

FAQ: ERP/CRM Integration

Is the SuguLive API available in REST only?

The API is primarily REST/JSON. A GraphQL interface is in beta for Corporate accounts that need more flexible queries. Contact our technical team to get access.

How do you test the integration without impacting production?

SuguLive provides a full staging environment (sandbox) with test data and fake Mobile Money payments. Everything can be tested without ever touching real data or real transactions.

What load can the API handle during a big live?

The SuguLive API is designed to handle order spikes (up to 500 orders per minute on Corporate accounts). Rate limits apply on read endpoints (1000 req/min) but not on outbound webhooks.

Integrating SuguLive with Your ERP and CRM: Technical Guide for IT Directors