Funnelchat APIDifusiones
Una difusión es un envío masivo de una plantilla (template_id) desde uno de tus números a una audiencia segmentada por etiquetas, países, etapa de un tablero o lead score.
Una difusión es un envío masivo de una plantilla (template_id) desde uno de tus números a una audiencia segmentada por etiquetas, países, etapa de un tablero o lead score. Desde la API la podés consultar, medir (estadísticas, costo y estado por destinatario), cancelar y ordenar en carpetas. Para dimensionar una audiencia, empezá por Contar contactos para una difusión.
Endpoints
Listar difusiones
GET /api/v1/broadcasts · Usalo para armar un panel o reporte de tus difusiones: filtrá por número, estado, carpeta, tipo de envío o fecha programada y ubicá rápido la que te interesa.
Buscar contactos para una difusión
POST /api/v1/broadcasts/contacts · Sirve para previsualizar la audiencia de una difusión antes de crearla: le pasás los filtros (etiquetas, países, etapa del kanban, lead score) y te devuelve, paginados, los contactos que entrarían.
Contar contactos para una difusión
POST /api/v1/broadcasts/contacts-count · Usalo para dimensionar una difusión antes de lanzarla: con los mismos filtros de segmentación te dice cuántos contactos entran, cuántos no son alcanzables y cuántos están pausados.
Ver los tramos de costo
GET /api/v1/broadcasts/cost-tiers · Sirve para consultar los tramos de costo vigentes y la fecha de la última actualización de tarifas, como referencia para estimar cuánto puede costar una difusión.
Mover difusiones a una carpeta
POST /api/v1/broadcasts/move-to-folder · Usalo para ordenar difusiones en bloque: mové varias a una carpeta con una sola llamada, por ejemplo al agruparlas por campaña o por cliente.
Ver una difusión
GET /api/v1/broadcasts/{broadcast} · Usalo para ver la configuración completa de una difusión: número, plantilla, carpeta y los filtros de audiencia que usó (etiquetas, países, kanban, lead score).
Eliminar una difusión
DELETE /api/v1/broadcasts/{broadcast} · Sirve para quitar de tu cuenta una difusión que ya no necesitás. Si lo que querés es frenar un envío, mirá la operación de cancelar.
Ver las estadísticas de una difusión
GET /api/v1/broadcasts/{broadcast}/statistics · Usalo para medir el resultado de una difusión: entregados, leídos, respondidos, fallidos, pendientes y omitidos (con su motivo), más los clics en cada botón.
Ver el costo de una difusión
GET /api/v1/broadcasts/{broadcast}/cost · Sirve para saber cuánto cuesta una difusión: la estimación previa y el costo calculado de lo enviado, desglosado por mercado, con aviso de si el dato todavía es parcial.
Listar los contactos de una difusión
GET /api/v1/broadcasts/{broadcast}/contacts · Usalo para obtener la lista de destinatarios de una difusión, por ejemplo para cruzarla con tu CRM o auditar a quién se le envió.
Cancelar una difusión
POST /api/v1/broadcasts/{broadcast}/cancel · Usalo para frenar una difusión programada o en curso antes de que siga enviando. Si ya no se puede cancelar, responde 409.
Listar los mensajes de una difusión
GET /api/v1/broadcasts/{broadcast}/messages · Sirve para ver el detalle por destinatario de una difusión: estado de cada mensaje, motivo de omisión y fecha de envío. Ideal para detectar fallidos o ver quién leyó o respondió.
Listar carpetas de difusiones
GET /api/v1/broadcasts/folders · Usalo para obtener las carpetas de difusiones con cuántas difusiones tiene cada una, por ejemplo para replicar esa organización en tu sistema.
Crear una carpeta de difusiones
POST /api/v1/broadcasts/folders · Sirve para crear una carpeta y agrupar difusiones por campaña, cliente o el criterio que uses.
Eliminar una carpeta de difusiones
DELETE /api/v1/broadcasts/folders/{broadcastFolder} · Sirve para eliminar una carpeta de difusiones que ya no usás.
Actualizar una carpeta de difusiones
PUT /api/v1/broadcasts/folders/{broadcastFolder} · Usalo para renombrar una carpeta de difusiones.
Listar países presentes GET
Sirve para obtener la lista de países presentes en tus datos, por ejemplo para armar el filtro de países de tus reportes.
Listar difusiones GET
Usalo para armar un panel o reporte de tus difusiones: filtrá por número, estado, carpeta, tipo de envío o fecha programada y ubicá rápido la que te interesa.