Funnelchat APIGrupos
Tu propia gestión de grupos de WhatsApp, sin pasar por nuestras campañas: qué se puede leer y qué avisos te llegan de lo que pasa adentro.
Tu propia gestión de comunidades, sin pasar por nuestras campañas.
| Pieza | Estado |
|---|---|
| Leer grupos, participantes, entradas y salidas y los mensajes enviados a un grupo | Disponible |
| Avisos de lo que pasa adentro: mensajes, reacciones, grupo lleno y solicitudes para unirse | Disponible |
Lo que podés leer hoy
- Listar grupos: los grupos de tu cuenta, con filtros por tipo, estado, número o sin campaña.
- Listar los participantes de un grupo y sus entradas y salidas.
- Los mensajes enviados a un grupo.
Los avisos —group_participant.joined, group_participant.left, group.message_received, poll.voted, entre otros— están en el catálogo de eventos y se suscriben, como todos, en /api/v1/webhooks (abajo). Paso a paso: Seguir grupos.
Avisos de lo que pasa adentro
Además de las entradas y salidas, te llegan group.message_received (alguien escribió en el grupo), group.reaction_added (alguien reaccionó a un mensaje), group.full (el grupo se llenó) y group_join_request.created y group_join_request.revoked (alguien pidió unirse a un grupo que pide aprobación, o retiró el pedido). Cada uno trae el grupo (uid, name) y, cuando corresponde, la persona (identity, identity_type, name).
Se suscriben en /api/v1/webhooks, con webhooks:write y además communities:read, el permiso de lectura de su área (Webhooks). Paso a paso: Seguir grupos.
Probalo acá
Los grupos de tu cuenta, con tu clave. Es una lectura: no cambia nada.
Permiso requerido: communities:read (Leer)
Con API key: la respuesta siempre viene paginada. Tamaño de página: perPage (por defecto 25, máximo 100; un valor mayor, menor que 1 o no entero responde 422). Orden: orderBy acepta created_at, id, name, updated_at; dirección orderByMethod: asc o desc. Otro valor responde 422.
httpAuthorizationBearer <clave>Tu API key de Funnelchat, enviada en cada llamada como Authorization: Bearer <id>|fc_live_....
name?stringorderBy?stringorderByMethod?stringtype?string"1""2""3""4"perPage?integerstatus?string"0""1""2""3""4""5""6""7""8"deviceId?integernoCampaign?booleanPaginated set of GroupResource
application/json- response
data*array<>links*meta*curl -X GET "https://example.com/v1/groups"{ "data": [ { "id": "string", "admins_numbers": "string", "admins": [ { "phone": "string", "lid": "string", "isConnected": true, "displayPhone": "string", "accessDenied": true } ], "admins_count": "string", "owner": "string", "owner_display_phone": "string", "owner_connected": true, "clicks": "string", "communityUid": "string", "newsletterUid": "string", "description": "string", "deviceId": "string", "image": "string", "isFull": "string", "isApi": true, "link": "string", "campaign_link": "string", "campaign_custom_domain": "string", "name": "string", "order": "string", "participants_numbers": "string", "participants_count": "string", "status": "string", "uid": "string", "updatedAt": "string", "createdAt": "string", "scheduled_message_count": "string", "type": "string", "manual_import": true, "origin": 1, "lastSyncAt": "string", "property1": null, "property2": null } ], "links": { "first": "string", "last": "string", "prev": "string", "next": "string" }, "meta": { "current_page": 1, "from": 1, "last_page": 1, "links": [ { "url": "string", "label": "string", "active": true } ], "path": "string", "per_page": 0, "to": 1, "total": 0, "cloud_api_groups_enabled": "string" }}Estados de mensaje
Saber qué pasó con cada mensaje que mandaste —en cola, enviado, entregado, leído o falló—, por el aviso message.status_changed o consultando el mensaje.
Números
Tus números de WhatsApp, oficiales de Meta o por QR, con la misma API: estado, salud, conexión por QR y qué puede hacer cada uno.