Listar las conexiones activas

GET
/api/meta/connections

Devuelve las conexiones activas del tenant de la API key (Messenger, Instagram y WhatsApp), incluidas las de sus clientes. Las desconectadas no aparecen. El id es el mismo page.id que llega en cada evento del webhook y es el que se usa en PATCH /api/meta/connections/{id}.

Una conexión de un canal que la cuenta ya no tiene habilitado se sigue listando, pero no se puede editar.

AuthorizationBearer <token>

API key opaca del tenant, creada en Settings → API Tokens. Una key revocada, inexistente o malformada responde 401 {"error":"unauthorized"}.

In: header

Query Parameters

channel?string

Filtra por canal.

Value in

  • "messenger"
  • "instagram"
  • "whatsapp"

Header Parameters

x-request-id?string

Identificador de correlación opcional que se copia a los logs del servidor.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/meta/connections"
{  "connections": [    {      "id": "6f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",      "channel": "instagram",      "metaPageId": "17841400000000000",      "name": "Tienda",      "username": "tienda",      "webhookUrl": "https://n8n.example.com/webhook/abc",      "signed": true,      "paused": false    },    {      "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",      "channel": "whatsapp",      "metaPageId": "106540352242922",      "name": "Ventas",      "username": null,      "webhookUrl": null,      "signed": false,      "paused": false,      "phoneNumberId": "106540352242922",      "displayPhoneNumber": "+5491100000000",      "wabaId": "102290129340398"    }  ]}