Referencia (endpoints)Campañas

Ver los grupos de una campaña

Úsalo para listar los grupos de una campaña con su estado, origen y conexión del administrador, por ejemplo para detectar grupos llenos o desconectados.

GET
/v1/campaigns/{campaign}/groups

Permiso requerido: Grupos y campañas → Ver

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 id, name, created_at, updated_at; dirección orderByMethod: asc o desc. Otro valor responde 422.

Autorización

http
headerAuthorizationBearer <clave>

Tu clave de API de Funnelchat, en la cabecera Authorization: Bearer de cada llamada.

Parámetros de la ruta

campaign*string

The campaign ID

Patrón^cmp_[A-Za-z0-9]{23}$

Parámetros de consulta

name?string
orderBy?string
orderByMethod?string
perPage?integer
deviceId?string

Id opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^dev_[A-Za-z0-9]{23}$
status?integer
origin?integer
Valor en"0""1"
adminConnection?integer
Valor en"1""2""3"
adminPhone?string

Cuerpo de la respuesta

Paginated set of GroupResource

application/json
  1. response
data*array<>
links*
meta*
curl -X GET "https://example.com/v1/campaigns/cmp_A6RMvAOjr0mHuLr08RpcwWu/groups"
{  "data": [    {      "id": "grp_AK2GMGeWAAdd8fZbtOVvE3Z",      "admins_numbers": "string",      "admins": [],      "admins_count": "string",      "owner": "string",      "owner_display_phone": "string",      "owner_connected": true,      "clicks": "string",      "communityUid": "string",      "newsletterUid": "string",      "description": "string",      "deviceId": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX",      "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,      "participantMode": true,      "ownNumbers": "string",      "adminOnlyMessage": 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  }}

Esto es lo que se copia para tu IA

Cargando…