io.github.wilmendezofficial/postari

Tools

• account_stats

  Métricas globales de la cuenta (enviados, entregados, aperturas únicas, clics únicos, bajas, rebotes) en un rango de fechas.

  shallow
• activate_flow

  Pone la automatización en servicio (status active) o la pausa con paused:true. OJO: activar NO hace que envíe — para eso hace falta armarla (arm_flow).

  shallow
• add_subscriber_to_list

  Añade un contacto (por email o contact_id) a una lista.

  shallow
• arm_flow

  ARMA la automatización: a partir de aquí envía correos REALES sola. Exige confirm:"ARMAR ENVIOS" literal, haber probado el flujo antes, y que la cuenta permita envíos por agente. NO es retroactivo: solo entra quien cumpla el disparador de ahora en adelante.

  shallow
• clean_bounced_subscribers

  Saca de circulación a los contactos que rebotaron y NUNCA recibieron ningún correo (direcciones muertas que ensucian la reputación en cada envío). Conserva a quien alguna vez recibió bien: ese rebote fue transitorio. Sin `aplicar:true` solo devuelve el recuento, no cambia nada.

  shallow
• create_flow

  Crea una automatización. NACE EN BORRADOR Y DESARMADA: no envía nada hasta que se pruebe, se active y se arme a propósito. El `graph` es el mismo formato que devuelve get_flow.

  shallow
• create_form

  Crea un formulario de captación y devuelve su URL pública y su código para embeber. Si no pasas campos, lleva uno de correo.

  shallow
• create_landing

  Crea una página de aterrizaje y devuelve su URL pública. `kind`: blocks (bloques de Postari) · code (HTML propio) · ai (desde un prompt) · iframe · external_url. Conéctale un formulario con form_id para que capte suscriptores.

  shallow
• create_launch

  Crea un LANZAMIENTO (curso, infoproducto, evento…) con sus etapas: es la unidad que agrupa los correos de una campaña con fechas. Si no pasas `stages` y el tipo es curso/infoproducto, siembra 8 etapas estándar (lead magnet → webinar → apertura de carrito → cierre).

  shallow
• create_list

  Crea una nueva lista de contactos.

  shallow
• create_segment

  Crea un segmento: una regla de "quién entra" que se recalcula sola. Es lo que se usa para segmentar un lanzamiento sin duplicar listas.

  shallow
• create_subscriber

  Crea o actualiza (upsert) un contacto/suscriptor. Si ya existe, lo actualiza sin duplicar.

  shallow
• create_tag

  Crea una etiqueta (idempotente: si ya existe devuelve la que hay, no la duplica).

  shallow
• create_template

  Crea una plantilla propia de la cuenta, opcionalmente duplicando una del catálogo con from_template_id. Las del catálogo son compartidas y no se editan.

  shallow
• diagnose_deliverability

  Diagnóstico de ENTREGABILIDAD de la cuenta (últimos 28 días): rebotes, quejas de spam, aperturas y salud del dominio (DNS). Devuelve un veredicto (sano/a_vigilar/en_riesgo) + acciones priorizadas. Úsalo antes de un envío grande o si los correos no llegan.

  shallow
• get_agent_activity

  Transparencia "qué hizo la IA": lista las acciones de la cuenta originadas por un agente/IA (chat Atelier, API de agente, A2A) — qué se hizo, sobre qué y cuándo. Para auditar lo que un agente ejecutó.

  shallow
• get_campaign_audience

  ¿A cuánta gente le va a llegar este correo? Devuelve los destinatarios REALES aplicando el filtro guardado, ANTES de enviar: base de la lista, cuántos quita la exclusión y el total final.

  shallow
• get_campaign_stats

  Métricas reales de una campaña (enviados, aperturas únicas/totales, clics, rebotes, bajas, ingresos).

  shallow
• get_form

  Un formulario con sus campos y sus KPIs recontados en vivo (form_kpis_v2): primary_count en primary_unit (people en captura, submissions en encuesta), people, submissions (envíos sin papelera), views, views_measured y conversion_rate (primary_count / views, % con 1 decimal, null si las vistas no están medidas). Mismas definiciones que list_forms. Si la lectura falla responde 503 metrics_unavailable (nunca un número sin avisar).

  shallow
• get_launch

  Un lanzamiento con sus etapas y las MÉTRICAS REALES de cada una (enviados, aperturas y clics de personas únicas) más el total. Es la forma de saber cómo va un lanzamiento.

  shallow
• get_subscriber

  Busca un contacto por su correo y devuelve sus datos, estado, etiquetas e historial básico.

  shallow
• launch_campaign

  AGÉNTICA · Lanza una campaña de correo COMPLETA desde un brief en lenguaje natural. Postari GENERA el correo (asunto + diseño con la voz y el color de marca del tenant), lo arma sobre una lista y devuelve un BORRADOR con preview (preview_html). Por defecto NO envía: para enviar de verdad, vuelve a llamar con los mismos campos + confirm_send:true (o scheduled_at para agendar). Es la forma de "dile el objetivo y Postari lo logra". Requiere scope `write` (borrador) o `send` (enviar).

  shallow
• link_campaign_to_launch_stage

  Conecta un correo YA ESCRITO a una etapa del lanzamiento (o lo desconecta con campaign_id null). Sin esto la etapa no mide nada: sus KPIs dependen de este vínculo. También sirve para cambiar título, fecha o estado de la etapa.

  shallow
• list_campaigns

  Lista las campañas/correos del tenant. Filtrable por estado (draft, scheduled, sending, sent).

  shallow
• list_flow_emails

  Los correos de una automatización, cada uno con su node_id, su asunto y su URL propia para compartir con el cliente. Antes estos correos no tenían dirección: vivían enterrados en el flujo.

  shallow
• list_forms

  Lista los formularios con sus KPIs. El número de cada formulario es primary_count en la unidad primary_unit: people = personas distintas (correo normalizado, sin papelera) en un formulario de captura; submissions = respuestas en una encuesta (is_survey true: una persona puede responder varias veces). people = personas distintas; submissions = envíos sin papelera (filas, repeticiones incluidas: NO es el número del formulario de captura); views = cargas del formulario (1 por navegador cada 24 h); views_measured false = la página que envía las altas no avisa de las visitas; conversion_rate = primary_count / views en % con 1 decimal (null si las vistas no están medidas). Los mismos números que la app.

  shallow
• list_landings

  Lista las páginas de aterrizaje con sus visitas, conversiones y tasa de conversión.

  shallow
• list_launches

  Lista los lanzamientos de la cuenta, con cuántas etapas tiene cada uno y cuántas ya están conectadas a un correo.

  shallow
• list_lists

  Lista todas las listas de contactos del tenant con su nombre y conteo.

  shallow
• list_subscribers

  Lista contactos paginados (más recientes primero, cursor keyset). Filtros: status (active|unsubscribed|bounced|complained), list_id (membresías físicas: una lista inteligente devuelve 0 filas; su tamaño está en list_lists (active_count / total_count) o en GET /api/v1/lists/{id}/count) y tag = nombre EXACTO de una etiqueta del catálogo (contact_tags, la misma fuente que /etiquetas). Desde el 3-oct-2026 tag ya no mira las etiquetas importadas (imported_tags): cada fila trae `tags` (importadas, como siempre) y `catalog_tags` (las del catálogo, las que filtra tag). include_count:true añade total_count; si el conteo no se puede hacer responde 503 count_unavailable, nunca 0.

  shallow
• reactivate_bounced_subscriber

  Devuelve a tus envíos a un contacto que salió por un rebote TEMPORAL suelto (buzón lleno, servidor ocupado). Solo funciona si el rebote fue temporal, el dominio no está bloqueado ni mal escrito (gmail.co, hormail.com: corrige la dirección; el 409 trae dominio_sugerido) y no se dio de baja ni marcó spam; si no, responde 409 con el motivo (por ejemplo, rebote definitivo: la dirección no existe). No reanuda flujos viejos ni envía la bienvenida. Úsalo en vez de update_subscriber con status "active".

  shallow
• send_transactional_email

  Envía un correo transaccional 1-a-1 (cotización, recibo, bienvenida, recordatorio) a UNA dirección, usando una plantilla y variables. Síncrono. Requiere scope `send`.

  shallow
• set_campaign_audience

  Define A QUIÉN se le manda un correo y a quién NO: excluir por etiqueta, por lista entera o por haber recibido otra campaña. Devuelve el número REAL de destinatarios para confirmar antes de enviar. Si alguna referencia no existe, falla con 400 en vez de guardar a medias.

  shallow
• tag_subscribers

  Añade o quita una etiqueta a varios contactos (por emails o contact_ids).

  shallow
• test_flow

  Prueba una automatización enviándola de verdad a UN miembro de la cuenta (por defecto el dueño). Es OBLIGATORIO antes de armar. No se puede usar para mandar correo a terceros: to_email tiene que ser de un miembro.

  shallow
• trigger_flow

  Mete un contacto (por email o contact_id) en un flujo automático para que reciba esa secuencia.

  shallow
• update_flow

  Edita una automatización: nombre, disparador, pasos (graph) o estado. NO sirve para armar (eso es arm_flow, que exige confirmación); sí para DESARMAR con armed:false.

  shallow
• update_flow_email

  Edita UN correo de una automatización (asunto, preheader, bloques o etiqueta) sin tocar el resto del flujo. Más seguro que reescribir el graph entero.

  shallow
• update_form

  Edita un formulario: título, campos, lista donde caen las altas, doble opt-in, mensaje de gracias o activarlo/desactivarlo.

  shallow
• update_landing

  Edita una página de aterrizaje: contenido, slug, formulario conectado o activarla/desactivarla. Cambiar el slug rompe la URL que ya se haya compartido (la respuesta avisa).

  shallow
• update_subscriber

  Actualiza datos de un contacto existente (nombre, país, teléfono, etiquetas).

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/76783a08-2bc4-435c-a532-72e2b9de7094/badge.svg)](https://vouch.tools/servers/76783a08-2bc4-435c-a532-72e2b9de7094)