• Ayuda · Conecta tu IA

Propuestas: lo que tu IA te pide que apruebes

Cuando tu IA quiere que algo salga o cambie, hace una propuesta. Tú la ves como una tarjeta de sí. Esta página es para tu IA: dice lo que necesita cada tipo de propuesta, para que salga bien a la primera.

Cómo funciona una propuesta

  • propose recibe el number de la tarea, un kind, un título de hasta 200 caracteres, el payload y el run_id.
  • El payload de cada tipo tiene claves exactas: las que aparecen abajo, ninguna más. Una clave con ? se puede omitir.
  • Después de propose, tu IA te da el enlace del sí y espera tu respuesta.

Correos

  • email: { to, subject, text, separately?, send_at? }. Un boletín: { audience: "newsletter", subject, text, send_at? }.
  • Un correo va a entre 1 y 20 personas. El asunto tiene hasta 200 caracteres y el texto hasta 50.000.
  • send_at es una hora con su desfase horario, como mucho a 400 días vista.
  • separately: true envía a cada persona su propia copia, así nadie ve a los demás.
  • Una secuencia solo va con kind email.

Publicaciones

  • post: { accounts, text, when, title?, media_urls?, content_item_id?, content_item_version? }.
  • El texto tiene hasta 5.000 caracteres y el título hasta 100 (YouTube necesita uno). Cuentas: de 1 a 20. Hasta 10 media_urls, solo enlaces https.
  • Publica solo en las cuentas que aparecen en departments/marketing.md.
  • Para un vídeo o una imagen de la biblioteca de medios, da content_item_id y content_item_version juntos (los dos o ninguno), y deja fuera media_urls: el enlace se crea después del sí.
  • Para mover una publicación programada, usa post_move: { proposal_id, when }, con una hora futura y su desfase horario. Una publicación que ya se está enviando no se puede mover.

Cambios y borrados de archivos

  • file_change: { path, body, base_version }. file_delete: { path, base_version }.
  • base_version es un número: la versión que te dio read. Para un borrado es 1 o más.
  • La ruta sigue las mismas reglas que write (mira "La carpeta de tu empresa").

Importaciones

  • people_import y invoice_import: { source, count, samples, rows }. people_import puede añadir consent: { count?, date, source } para las filas que dijeron sí al boletín.
  • Las filas van dentro del mensaje, cada fila como un objeto, nunca como un archivo.
  • Hasta 5.000 filas y 240.000 caracteres en una importación. Divide lo que sea más grande.
  • Hasta 3 ejemplos para enseñar al propietario. El origen tiene hasta 100 caracteres.

Otros tipos

  • department_on: { department }. Dirección y Sistemas están siempre activos, así que nunca lo necesitan.
  • record_delete: { module, key, why }. El registro tiene que existir, y why es una frase sencilla de hasta 300 caracteres.
  • company_new: { name }, un nombre de 2 a 120 caracteres.
  • site_publish: { site, version }, tal cual respondió deploy_site. Mira "Tu web".