Funnelchat APIGrupos
Un grupo es un grupo de WhatsApp que administra uno de tus números, con o sin campaña asignada; acá también aparecen los canales y los grupos de anuncios de una comunidad.
Un grupo es un grupo de WhatsApp que administra uno de tus números, con o sin campaña asignada; acá también aparecen los canales y los grupos de anuncios de una comunidad. Su ficha trae uid, nombre, link de invitación, administradores, si el dueño está conectado, participantes, clics, status e isFull (lleno). Podés leer sus datos en vivo desde WhatsApp, sus acciones, sus mensajes y qué envíos programados lo incluyen.
Endpoints
Listar grupos
GET /api/v1/groups · Usalo para listar los grupos de tu cuenta con filtros por tipo, estado, número o sin campaña asignada, por ejemplo para sincronizarlos con tu sistema.
Listar los grupos que administra un número
GET /api/v1/devices/{device}/groups · Sirve para ver los grupos que administra un número según lo que informa el proveedor de WhatsApp, por ejemplo para encontrar grupos que todavía no sumaste a una campaña.
Listar los grupos de anuncios de un número
GET /api/v1/devices/{device}/ad-groups · Usalo para listar los grupos de anuncios que administra un número (la respuesta indica la comunidad a la que pertenecen), por ejemplo para elegir cuáles sumar a una campaña.
Listar los canales de un número
GET /api/v1/devices/{device}/channels · Sirve para listar los canales de WhatsApp de un número y obtener sus identificadores.
Ver los datos actuales de un grupo en WhatsApp
GET /api/v1/groups/{groupUid}/metadata · Usalo para leer en vivo desde WhatsApp el nombre, la foto, la descripción, el link y los administradores actuales de un grupo o canal, por ejemplo para verificar que coincidan con lo esperado.
Ver un grupo
GET /api/v1/groups/{group} · Sirve para ver el detalle de un grupo: administradores, si el dueño está conectado, clics, link de invitación y de campaña, y si está lleno.
Listar las acciones de sesión sobre un grupo
GET /api/v1/groups/{group}/actions · Usalo para ver el historial de acciones ejecutadas sobre un grupo puntual y su resultado, por ejemplo para entender por qué cambió su nombre o sus administradores.
Listar los mensajes enviados a un grupo
GET /api/v1/groups/{group}/messages · Sirve para ver los mensajes que se enviaron a un grupo y de qué envío programado salió cada uno.
Listar los envíos programados que incluyen un grupo
GET /api/v1/groups/{group}/scheduled-messages · Usalo para saber qué envíos programados incluyen a un grupo, por ejemplo antes de hacerle cambios.
Actualizar un campo personalizado PUT
Usalo para renombrar un campo personalizado o actualizar su descripción; el tipo no se cambia por acá.
Listar grupos GET
Usalo para listar los grupos de tu cuenta con filtros por tipo, estado, número o sin campaña asignada, por ejemplo para sincronizarlos con tu sistema.