Documentation — Cueline

rocket_launch

Quick Start

Get your first widget live in under 5 minutes.

code

Widget Embed

Add the Cueline widget to any website.

<!-- Paste before </head> -->
<script
  src="https://cdn.cueline.app/widget.js"
  data-widget="YOUR_WIDGET_ID"
  async
></script>

api

REST API

Base URL: https://api.cueline.alcings.com

fiber_manual_record POST /api/auth/signup — Create account
fiber_manual_record POST /api/auth/signin — Sign in, get JWT
fiber_manual_record GET /api/tickets — List tickets (auth required)
fiber_manual_record POST /api/tickets/:id/messages — Reply to ticket
fiber_manual_record GET /api/public/tickets/:trackingId — Public ticket status
fiber_manual_record GET /api/widgets — List your widgets
fiber_manual_record GET /api/analytics/overview — Platform analytics

lock

Authentication

Cueline uses JWT bearer tokens. Include Authorization: Bearer <token> in all protected requests. Tokens expire after 15 minutes — use the refresh token to get a new one.

fiber_manual_record POST /api/auth/refresh — Refresh access token
fiber_manual_record POST /api/auth/logout — Invalidate refresh token
fiber_manual_record GET /api/auth/me — Get current user + org

webhook

Webhooks (Paystack)

Paystack sends webhook events to POST /api/billing/webhook. Verified via HMAC-SHA512 of the request body using your PAYSTACK_WEBHOOK_SECRET.

fiber_manual_record charge.success — Payment completed, plan upgraded
fiber_manual_record subscription.disable — Subscription cancelled, downgraded to free
fiber_manual_record invoice.payment_failed — Payment failed

settings

Google OAuth Setup

To enable Google sign-in:

fiber_manual_record 1. Go to console.cloud.google.com
fiber_manual_record 2. Create a project → APIs & Services → Credentials
fiber_manual_record 3. Create OAuth 2.0 Client ID (Web application)
fiber_manual_record 4. Add authorized redirect URI: https://api.cueline.alcings.com/api/auth/google/callback
fiber_manual_record 5. Copy Client ID and Client Secret
fiber_manual_record 6. Add to wrangler secrets: wrangler secret put GOOGLE_CLIENT_ID
fiber_manual_record 7. wrangler secret put GOOGLE_CLIENT_SECRET