Publikasi Konten Sosial Omnichannel (`POST /v1/posts`)

Fitur Omnichannel Publishing Kirem memungkinkan developer dan marketer mempublikasikan konten pos sosial secara serentak ke berbagai platform media sosial resmi:

Facebook Pages (Feed Post & Album Foto)
Instagram Business (Single Image Post & Carousel Album)
LinkedIn Profile & Organization Pages (UGC Post & Image Share)
Threads (Postingan Teks, Gambar Tunggal, & Carousel Slide)
WhatsApp Channel (Saluran Resmi WhatsApp)

🔑 Endpoint & Autentikasi

Endpoint: POST /v1/posts
Base URL: https://api.kirem.co
Headers:
- Content-Type: application/json
- Authorization: Bearer <API_KEY> (Gunakan API Key proyek Kirem)

📋 Struktur Payload Request

1. Postingan Teks Saja (Text-Only Post)

Cocok untuk pengumuman singkat, thread opini, atau pesan broadcast:

{
  "content": "Kabar gembira! Fitur Omnichannel Kirem kini resmi mendukung Threads, Instagram, Facebook, dan LinkedIn 🚀 Coba sekarang di dashboard Anda!",
  "platforms": ["threads", "linkedin", "facebook"]
}

2. Postingan dengan Gambar Tunggal (Single Image)

Gunakan field media_url untuk melampirkan 1 file gambar:

{
  "content": "Peluncuran produk terbaru kami hari ini! 🎉 Dapatkan diskon 20% khusus pengguna pertama.",
  "platforms": ["facebook", "instagram", "threads", "linkedin", "whatsapp"],
  "media_url": "https://kirem.co/assets/promo-banner.jpg"
}

3. Postingan Carousel / Multi-Media (Maksimal 10 Media)

Untuk platform yang mendukung format multi-media, Anda dapat mengirimkan array URL gambar melalui field media_urls. Kirem akan secara otomatis membangun 1 postingan carousel/album utuh:

{
  "content": "5 Tips Praktis Mengoptimalkan Strategi Social Media Bisnis Anda 💡 Geser untuk membaca seluruh slide panduan!",
  "platforms": ["instagram", "threads", "facebook", "linkedin"],
  "media_urls": [
    "https://kirem.co/assets/slide-1.jpg",
    "https://kirem.co/assets/slide-2.jpg",
    "https://kirem.co/assets/slide-3.jpg",
    "https://kirem.co/assets/slide-4.jpg"
  ]
}

⚙️ Perilaku Khusus Tiap Platform

Engine Kirem secara cerdas menyesuaikan alur penerbitan dengan spesifikasi resmi masing-masing jejaring sosial:

Platform	Alur Eksekusi Internal Kirem
Instagram	Mengunggah setiap file ke item container, menyusun Meta Carousel Container (`media_type: CAROUSEL`), lalu mempublikasikannya dalam 1 post swipe.
Threads	Membuat Threads Media Container untuk tiap item, menggabungkan ke dalam Threads Carousel Container dengan caption teks utama, menunggu status kontainer siap (ready state), dan menerbitkan postingan.
Facebook	Mengunggah setiap gambar sebagai unpublished photo ke Page, lalu menerbitkan 1 postingan feed album dengan seluruh lampiran foto.
LinkedIn	Mengunggah aset biner ke LinkedIn Media API, lalu menerbitkan UGC Share Post berstatus multi-image.
WhatsApp Channel	Mengirimkan teks pengumuman utama dan menerbitkan gambar lampiran secara berurutan ke saluran resmi.

📤 Contoh Response Sukses (HTTP 200 OK)

Kirem mengembalikan daftar log eksekusi publikasi untuk setiap kanal sosial yang dituju:

{
  "status": 200,
  "message": "posts queued for publishing",
  "data": {
    "posts": [
      {
        "id": "post_fb_90123",
        "platform": "facebook",
        "status": "queued",
        "created_at": "2026-09-08T14:30:00Z"
      },
      {
        "id": "post_ig_90124",
        "platform": "instagram",
        "status": "queued",
        "created_at": "2026-09-08T14:30:00Z"
      },
      {
        "id": "post_th_90125",
        "platform": "threads",
        "status": "queued",
        "created_at": "2026-09-08T14:30:00Z"
      },
      {
        "id": "post_li_90126",
        "platform": "linkedin",
        "status": "queued",
        "created_at": "2026-09-08T14:30:00Z"
      }
    ],
    "errors": []
  }
}

💡 Contoh Implementasi dengan SDK

TypeScript SDK

import { KiremClient } from '@kiremco/sdk';

const kirem = new KiremClient({ apiKey: 'kd_live_xxx' });

await kirem.publishPost({
  content: 'Pengumuman resmi via Kirem SDK!',
  platforms: ['facebook', 'instagram', 'threads', 'linkedin'],
  media_url: 'https://kirem.co/assets/announcement.jpg',
});

Go SDK

resp, err := client.PublishPost(ctx, &kirem.CreatePostRequest{
    Content:   "Pengumuman resmi via Kirem Go SDK!",
    Platforms: []string{"threads", "linkedin", "facebook"},
    MediaURL:  "https://kirem.co/assets/announcement.jpg",
})

PHP SDK

$result = $kirem->publishPost([
    'content'   => 'Pengumuman resmi via Kirem PHP SDK!',
    'platforms' => ['threads', 'instagram', 'facebook', 'linkedin'],
    'media_url' => 'https://kirem.co/assets/announcement.jpg',
]);

Publikasi Konten Sosial Omnichannel

Publikasi Konten Sosial Omnichannel (POST /v1/posts)