Saltar al contenido
Desarrolladores
2 min de lectura

Servicios

Enumera los servicios configurados en una cuenta y lee sus metadatos de programación.

Compartir artículo

Un servicio es un programa de mensajería configurado en una cuenta. Usa este endpoint para descubrir qué está disponible antes de enviar o programar algo.

La respuesta contiene solo metadatos. Este endpoint nunca devuelve credenciales, plantillas, listas de destinatarios ni mapas de contactos.

GET /v0/account/{account_id}/service
curl https://api.furcata.com/v0/account/acc_123/service \
  -H "Authorization: Bearer YOUR_FURCATA_TOKEN"
Respuesta
[
  {
    "id": "svc_123",
    "account": "acc_123",
    "name": "Weekly reminders",
    "status": "active",
    "type": "messaging",
    "frequency": "daily",
    "limit": 500,
    "startTime": "2026-01-01T09:00:00.000Z",
    "endTime": "2026-06-30T09:00:00.000Z",
    "lastRun": "2026-01-08T09:00:00.000Z",
    "runHour": 9,
    "runsTotal": 8,
    "thread": false,
    "generated": "2026-01-01T08:00:00.000Z",
    "placeId": null
  }
]

Campos del servicio

  • id: el identificador del servicio. Siempre está presente.
  • account: la cuenta a la que pertenece el servicio.
  • name: el nombre visible.
  • status: draft, review, active, archived, scheduled o paused.
  • type: messaging o feed.
  • frequency: once, daily o date.
  • limit: cuántos contactos puede alcanzar el servicio.
  • startTime, endTime, lastRun y runHour: la ventana de programación y la última ejecución.
  • runsTotal: cuántas veces se ha ejecutado el servicio.
  • thread: si las respuestas se agrupan en una sola conversación.
  • generated: cuándo se creó el servicio.
  • placeId: el lugar con el que se asocia el servicio, cuando existe.

Solo metadatos

Este endpoint nunca devuelve credenciales, plantillas, listas de destinatarios ni mapas de contactos. Si necesitas los totales de contactos de un servicio, usa Recuento de contactos en su lugar.

Errores

  • 401 cuando falta el token o no se acepta.
  • 403 cuando quien llama no tiene acceso a la cuenta.
  • 404 cuando la cuenta no existe.
  • 429 cuando superas el límite de peticiones de lectura.

Próximos pasos

Lee Recuento de contactos para actualizar los totales de contactos de un servicio, o Cuentas para listar las cuentas a las que puedes llegar.