• Aiuto · Collega la tua IA

Proposte: per cosa la tua IA chiede il tuo sì

Quando la tua IA vuole che qualcosa parta o cambi, fa una proposta. Tu la vedi come una carta del sì. Questa pagina è per la tua IA: elenca cosa serve a ogni tipo di proposta, così è giusta al primo colpo.

Come funziona una proposta

  • propose prende il number dell'attività, un kind, un titolo fino a 200 caratteri, il payload e il run_id.
  • Il payload di ogni tipo ha chiavi precise: quelle elencate qui sotto, nessun'altra. Una chiave con ? si può lasciare fuori.
  • Dopo propose, la tua IA ti dà il link del sì e aspetta la tua risposta.

Email

  • email: { to, subject, text, separately?, send_at? }. Una newsletter: { audience: "newsletter", subject, text, send_at? }.
  • Un'email va da 1 a 20 persone. L'oggetto arriva fino a 200 caratteri e il testo fino a 50.000.
  • send_at è un orario con il suo fuso, al massimo 400 giorni avanti.
  • separately: true manda a ogni persona la sua copia, così nessuno vede gli altri.
  • Una sequenza va solo con kind email.

Post

  • post: { accounts, text, when, title?, media_urls?, content_item_id?, content_item_version? }.
  • Il testo arriva fino a 5.000 caratteri, il titolo fino a 100 (YouTube ne vuole uno). Account: da 1 a 20. Fino a 10 media_urls, solo link https.
  • Pubblica solo sugli account elencati in departments/marketing.md.
  • Per un film o un'immagine della libreria media, dai content_item_id e content_item_version insieme (tutti e due o nessuno), e lascia fuori media_urls: il link si crea dopo il sì.
  • Per spostare un post programmato, usa post_move: { proposal_id, when }, con un orario futuro e il suo fuso. Un post che sta già partendo non si può spostare.

Modifiche e cancellazioni di file

  • file_change: { path, body, base_version }. file_delete: { path, base_version }.
  • base_version è un numero: la versione che ti ha dato read. Per una cancellazione è 1 o più.
  • Il percorso segue le stesse regole di write (vedi "La cartella della tua azienda").

Importazioni

  • people_import e invoice_import: { source, count, samples, rows }. people_import può aggiungere consent: { count?, date, source } per le righe che hanno detto sì alla newsletter.
  • Le righe vanno dentro la proposta, ogni riga come oggetto, mai come file.
  • Fino a 5.000 righe e 240.000 caratteri in un'importazione. Dividi tutto ciò che è più grande.
  • Fino a 3 esempi da mostrare al titolare. La fonte arriva fino a 100 caratteri.

Altri tipi

  • department_on: { department }. Direzione e Sistemi sono sempre attivi, quindi non ne hanno mai bisogno.
  • record_delete: { module, key, why }. L'elemento deve esistere, e why è una frase semplice fino a 300 caratteri.
  • company_new: { name }, un nome da 2 a 120 caratteri.
  • site_publish: { site, version }, esattamente come ha risposto deploy_site. Vedi "Il tuo sito web".