Pubblica un post

crea Publication → Post[]ScritturaUnifiedIn arrivo

Una sola richiesta per TikTok, Instagram, YouTube e altre sei piattaforme. Ognuna restituisce il proprio esito e si pagano solo i post pubblicati. La pubblicazione su X funziona già oggi tramite l'API Direct delle azioni X di AIsa.

Una richiesta, tutte le piattaforme

Scrivi il post una volta e ogni piattaforma risponde per conto suo

Testo, media, account di destinazione e orario sono condivisi. Ciò che esiste su una sola piattaforma ha il suo prefisso, come tiktok.privacy o instagram.format. Ogni account può avere una sua didascalia più breve.

piattaforme
9
per i post non riusciti o bloccati al controllo preliminare
$0
per post pubblicato
[$Z]
{
  "tool": "social.publications.create",
  "arguments": {
    "text": "Our 3-in-1 travel charger is here.",
    "media": ["med_7Hq2Lw"],
    "targets": [
      { "account": "tiktok:acme.home" },
      { "account": "instagram:acme.home",
        "instagram": { "format": "reels" } },
      { "account": "youtube:acmehome" },
      { "account": "x:acme_home",
        "text": "3-in-1 charger, out now." }
    ],
    "when": { "at": "2026-10-03T09:00:00-07:00" },
    "approval": "required",
    "idempotency_key": "launch-charger-01"
  }
}
Prova con una bozza

Ogni destinazione riporta il proprio esito

Esempio · brand fittizio Acme Home

pub_01JB8W3KPubblicata in parte
3 su 6 pubblicati · addebitati 3
AccountFormatoStatoEsitoAddebito
TikToktiktok:acme.homeVideoPubblicatotiktok:[post id]Online alle 09:00 PTAddebitato
Instagraminstagram:acme.homeReelsPubblicatoinstagram:[post id]Online alle 09:00 PTAddebitato
Xx:acme_homeTesto + videoPubblicatox:[post id]Usata la didascalia più breveAddebitato
YouTubeyoutube:acmehomeShortsIn pubblicazione—Caricamento in elaborazione—
LinkedInlinkedin:acme-homeVideoProgrammato—Prima fascia libera, 11:00 PT—
Pinterestpinterest:acmehomePin videoNon riuscitoconnection_expiredPuoi risolvere: ricollega l'account, poi riprova questa destinazioneNon addebitato

Una Publication può essere bozza, programmata, in pubblicazione, pubblicata, pubblicata in parte, non riuscita o ritirata. Riprova solo le destinazioni non riuscite con la stessa chiave di idempotenza; nulla viene pubblicato due volte.

Dal collegamento alla pubblicazione

  1. 01 · Connection

    Collega una volta

    I titolari degli account concedono l'accesso ad AIsa. Ambiti, stato e scadenza sono consultabili, con un avviso prima che l'accesso scada.

  2. 02 · Preflight

    Controlla prima di pubblicare

    Lunghezza, dimensione dei media, formato e tipo di account vengono verificati per ogni piattaforma. Un controllo non superato non costa nulla.

  3. 03 · Approval

    Chiedi prima a una persona

    Pubblicazioni, eliminazioni e DM possono attendere l'approvazione di una persona. L'approvazione è attiva di default per i dipendenti IA.

  4. 04 · Publication

    Pubblica o metti in coda

    Subito, a un orario fissato, nella prima fascia libera o come bozza. Il fuso orario è sempre esplicito.

  5. 05 · Event

    Ricevi le notifiche

    Webhook per ogni post pubblicato o non riuscito, per nuovi commenti e DM e per le connessioni in scadenza.

9 chiamate previsteIn arrivo

La nostra prima bozza dei percorsi, non ancora revisionata. Ogni chiamata agisce sulle piattaforme che elenca tramite la Connection che concedi, e nessuna è ancora in produzione.

  • POST/v1/social/publicationsInvia un post a più account: subito, a un orario fissato o in codaTutte le 9 piattaforme socialBozza
  • POST/v1/social/publications/precheckControllo preliminare di lunghezza, media e tipo di account secondo le regole di ogni piattaformaTutte le 9 piattaforme socialBozza
  • GET/v1/social/publications/{publicationId}Una Publication con il suo stato su ogni piattaformaTutte le 9 piattaforme socialBozza
  • GET/v1/social/publicationsPublication in bozza, programmate e inviateTutte le 9 piattaforme socialBozza
  • PUT/v1/social/publications/{publicationId}Modifica una bozza o una Publication programmataTutte le 9 piattaforme socialBozza
  • POST/v1/social/publications/{publicationId}/retryRiprova l'invio sulle piattaforme in cui non è riuscitoTutte le 9 piattaforme socialBozza
  • DELETE/v1/social/publications/{publicationId}Elimina una bozza o annulla un invio programmatoTutte le 9 piattaforme socialBozza
  • POST/v1/social/publications/bulk-uploadCrea molte Publication da un file CSVTutte le 9 piattaforme socialBozza
  • GET/v1/social/platformsLe piattaforme su cui puoi pubblicare, con i loro limitiTutte le 9 piattaforme socialBozza

Cosa permette ogni piattaforma

La stessa tabella è un endpoint, con versioni che seguono i cambiamenti delle piattaforme: GET /v1/social/platforms

PiattaformaPubblicazioneCommenti e DMLe tue statisticheStato
XTesto, immagini, video, thread, sondaggiCommenti, DM in arrivoSìDisponibile
TikTokVideoCommenti; DM solo in rispostaSìIn arrivo
InstagramPost, Reels, Stories, caroselliCommenti, DMSìIn arrivo
Pagina FacebookTesto, immagini, video, ReelsCommenti, DM, recensioni della paginaSìIn arrivo
YouTubeVideo, ShortsCommentiSìIn arrivo
LinkedInTesto, immagini, video, documentiCommenti sulle pagine aziendaliSìIn arrivo
PinterestPin immagine, Pin videoNon offerti da PinterestSìIn arrivo
ThreadsTesto, immagini, videoCommentiSìIn arrivo
RedditTesto, immagini, video, linkCommenti, DMLimitateIn arrivo

Gli errori indicano chi può risolverli

I codici sono di AIsa. Codici e messaggi a monte non ti arrivano mai, così il canale dietro una piattaforma può cambiare senza toccare il tuo codice.

Puoi risolvere tunessun nuovo tentativo · nessun addebito
  • connection_expired
  • content_spec_mismatch
  • account_type_unsupported
La piattaformanuovi tentativi automatici
  • platform_rate_limited
  • platform_unavailable
AIsanuovi tentativi · a carico nostro
  • aisa_internal

Protezioni che tengono al sicuro gli account

  • La frequenza di pubblicazione resta sotto il limite di ogni piattaforma, per account.
  • Lo stesso post diretto a molti account viene prima revisionato.
  • Un account appena collegato parte con un ritmo ridotto e aumenta gradualmente.
  • Commenti e DM sono trattati come dati personali e mai condivisi tra clienti.

Quanto costa

Account collegato, con le sue statistiche
[$] / mese
Ogni post pubblicato
[$Z]
Ogni risposta a un commento o DM
[$]
X
Per chiamata all'API di X, con prezzo a parte

Gli agenti possono pagare per post con x402, senza account né piano.

Cerca nel catalogo

Piattaforme, entità Unified, API dei fornitori, endpoint e connettori.