Opciones del CRM

GET/clients/{clientId}/contacts/options

Etapas, campos personalizados y orígenes del CRM de un cliente.

Devuelve los ids de las etapas y de los campos personalizados que necesitas para crear o actualizar contactos, y los orígenes que ya hay en el CRM.

Autenticación

Cabecera Authorization: Bearer ack_live_…. Permiso necesario: contacts:read (o el de escritura). Cada llamada correcta consume créditos (créditos y límites).

Parámetros de la ruta

clientIduuidobligatorio

Id del cliente.

Respuestas

200Correcto. Consume créditos.

401UNAUTHORIZED · Falta el token o no es válido.

401TOKEN_REVOKED · El token se ha revocado.

401TOKEN_EXPIRED · El token ha caducado.

403PLAN_REQUIRED · La cuenta no tiene el plan Agentes ilimitados.

402NO_CREDITS · No quedan créditos en la cuenta.

429RATE_LIMITED · Más de 60 llamadas por minuto con el mismo token.

403FORBIDDEN_SCOPE · El token no tiene el permiso necesario.

404NOT_FOUND · El cliente no existe, no es tuyo o el token está limitado a otro cliente.

Las respuestas de error no consumen créditos.

curl -X GET "https://agentclic.com/api/public/pro/v1/clients/3f1c2a8e-5b7d-4e19-9a62-0c4d8b7e1f20/contacts/options" \
  -H "Authorization: Bearer ack_live_TU_TOKEN"

Respuesta200

{
  "stages": [
    {
      "id": "b7c1d2e3-4f50-4a61-8b72-9c83d4e5f601",
      "name": "Nuevo",
      "color": "#8B5CF6",
      "position": 0,
      "isDefault": true
    }
  ],
  "fieldGroups": [],
  "fields": [
    {
      "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "groupId": null,
      "name": "Tratamiento",
      "type": "text",
      "position": 0
    }
  ],
  "channels": [
    "api",
    "manual",
    "whatsapp"
  ]
}