Instagram

curl "https://fliok.com/api/v1/instagram/conversations?limit=20" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

curl "https://fliok.com/api/v1/instagram/conversations/9f1c2b7e-5d1a-4c3e-9b0a-2f6d8e7c1a44/messages?limit=50" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

// 200 OK — Instagram has no phone number: the contact is a name and an @username
{
  "conversations": [
    {
      "id": "9f1c2b7e-5d1a-4c3e-9b0a-2f6d8e7c1a44",
      "channel": "instagram",
      "contact": { "id": "c4f6…", "name": "Riya Sen", "username": "riya.makes" },
      "state": "open",
      "unreadCount": 2,
      "isArchived": false,
      "assignedAgentId": null,
      "lastMessageAt": "2026-10-05T09:58:12.000Z",
      "lastCustomerMessageAt": "2026-10-05T09:58:12.000Z",
      "windowOpen": true,
      "windowExpiresAt": "2026-10-06T09:58:12.000Z",
      "createdAt": "2026-10-01T11:00:00.000Z"
    }
  ],
  "nextCursor": null
}

// …/messages → the chat, then its messages (newest first). sender: contact | agent | ai | smb_echo
{
  "conversation": { "id": "9f1c…", "windowOpen": true, … },
  "messages": [
    { "id": "5d0e…", "mid": "aWdfZAG1…", "conversationId": "9f1c…", "sender": "contact", "type": "text",
      "status": "delivered", "payload": { "type": "text", "text": { "body": "Is the blue one in stock?" } },
      "createdAt": "2026-10-05T09:58:12.000Z", "sentAt": null, "failedAt": null, "errors": null }
  ],
  "nextCursor": null
}

curl -X POST https://fliok.com/api/v1/instagram/send \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: dm-riya-1042" \
  -d '{ "conversationId": "9f1c2b7e-5d1a-4c3e-9b0a-2f6d8e7c1a44", "text": "Yes! Size M and L are in stock." }'

// 200 OK — sent straight to Instagram, not queued
{ "ok": true, "messageIds": ["7a3b…"], "humanAgentTag": false }

// More than 24 hours since the customer last wrote. A teammate can still answer from the
// Instagram inbox; an integration only ever gets Instagram's 24-hour window.
// 422 { "error": "outside_24h_window", "message": "It's been more than 24 hours since they last wrote. …" }
// 422 { "error": "never_wrote", … }       — they have never messaged you
// 502 { "error": "send_unconfirmed", … }  — Instagram didn't answer; check the chat before sending again

# 1. Hand Fliok the photo: a JPEG at a public https:// address, up to 8 MB
curl -X POST https://fliok.com/api/v1/instagram/media \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://cdn.example.com/diwali-lamps.jpg", "for": "image" }'
# -> 201 { "media": { "mediaId": "instagram-posts/…/1b2c….jpg", "size": 412233, "mime": "image/jpeg",
#          "kind": "image", "width": 1080, "height": 1350 }, "hints": [] }

# 2. Schedule it (admin key). action: draft | schedule | publish
curl -X POST https://fliok.com/api/v1/instagram/posts \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "image",
    "caption": "Diwali lamps are back in stock ✨",
    "media": ["instagram-posts/…/1b2c….jpg"],
    "action": "schedule",
    "scheduledAt": "2026-10-20T18:30:00+05:30"
  }'

# 3. Changed your mind?
curl -X POST https://fliok.com/api/v1/instagram/posts/3e7a…/cancel -H "Authorization: Bearer wa_YOUR_API_KEY"

// 201 Created (cancel → 200 with "status": "cancelled")
{
  "post": {
    "id": "3e7a…",
    "kind": "image",
    "caption": "Diwali lamps are back in stock ✨",
    "media": [ { "mediaId": "instagram-posts/…/1b2c….jpg", "size": 412233, "mime": "image/jpeg", "kind": "image", "width": 1080, "height": 1350 } ],
    "cover": null,
    "shareToFeed": true,
    "status": "scheduled",
    "scheduledAt": "2026-10-20T13:00:00.000Z",
    "publishedAt": null,
    "igMediaId": null,
    "permalink": null,
    "errorMessage": null,
    "attempts": 0,
    "outcomeUnknown": false,
    "otherAccount": false,
    "createdById": null,
    "createdAt": "2026-10-05T10:00:00.000Z",
    "updatedAt": "2026-10-05T10:00:00.000Z"
  }
}

// Instagram's rules are checked before anything is saved for later:
// 422 { "error": "invalid_post", "message": "…", "issues": ["…"] }
// 422 { "error": "invalid_schedule", "message": "…" }   — 2 minutes to 75 days ahead
// The instagram.post.published webhook fires when it goes out.

curl "https://fliok.com/api/v1/instagram/comments?filter=needs_reply&limit=20" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

curl -X POST https://fliok.com/api/v1/instagram/comments/6c2d…/reply \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "₹1,499 — DM us to order!" }'

curl -X POST https://fliok.com/api/v1/instagram/comments/8e1f…/hide \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "hidden": true }'

// GET → 200 OK
{
  "comments": [
    {
      "id": "6c2d…",
      "kind": "comment",
      "mediaId": "17800000000000001",
      "inThread": false,
      "username": "riya.makes",
      "text": "Price?",
      "commentedAt": "2026-10-05T09:40:00.000Z",
      "hidden": false,
      "reply": null,
      "privateReply": null,
      "privateReplyBlocked": null,
      "ai": null,
      "canHide": true,
      "canDelete": true,
      "media": { "permalink": "https://www.instagram.com/p/abc123/", "thumbnailUrl": "https://…", "caption": "New arrivals", "type": "IMAGE", "owner": null }
    }
  ],
  "nextCursor": null,
  "counts": { "needs_reply": 1, "all": 14, "mentions": 2, "hidden": 0 },
  "connection": { "connected": true, "canManage": true, "igUserId": "17841400000000001", "username": "yourshop" }
}

// reply → 200 { "ok": true }          hide → 200 { "ok": true, "hidden": true }
// Replies are PUBLIC. Deleting a comment is not offered by the API — it can't be undone.

curl "https://fliok.com/api/v1/instagram/insights?days=28" -H "Authorization: Bearer wa_YOUR_API_KEY"

// 200 OK — cached for three hours per period, so polling costs nothing at Instagram
{
  "days": 28,
  "fetchedAt": "2026-10-05T08:00:00.000Z",
  "account": { "username": "yourshop", "name": "Your Shop", "followers": 12840, "follows": 310, "posts": 412, "pictureUrl": "https://…" },
  "totals": { "views": 98213, "reach": 40122, … },
  "approximate": [],
  "followerChange": { "follows": 420, "unfollows": 96, "net": 324 },
  "daily": [ { "day": "2026-09-08", "reach": 1210 }, … ],
  "unavailable": [],
  "posts": [ { "id": "1780…", "caption": "…", "permalink": "https://www.instagram.com/p/…/", "likeCount": 412, "commentsCount": 38, "insights": { … }, … } ],
  "postsInPeriod": true,
  "cached": true
}