Familias de endpoints

La API se sirve a través de un único gateway (api.rolchat.com) que envía cada familia de rutas al servicio que la gestiona. Esta página enumera todas las familias que el gateway expone a los clientes, agrupadas por módulo. Todas las familias comparten las convenciones - sobre, paginación, idempotencia, códigos de error -, así que la tabla te indica dónde vive un recurso y cómo se autentica la llamada.

Las rutas son prefijos: /api/v1/contacts cubre GET /contacts, POST /contacts, GET /contacts/:id, PATCH /contacts/:id, etc. Gana el prefijo más largo, por eso una subfamilia pública como /kb/public puede estar bajo un /kb autenticado.

Grupos de autenticación

Grupo	Quién puede llamar
user	Miembro de la cuenta - JWT o clave de API, X-Account-Id obligatoria
login	Anónimo, límites estrictos de inicio de sesión (10 por IP por minuto)
unauthenticated	Anónimo
widget	Anónimo, limitado por clave de sitio y origen (60 por sitio e IP por minuto)
webhook-inbound	Firmado por el remitente - consulta Webhooks
partner	JWT de partner (portal de partners)

Familias

Auth & account

Prefijo	Servicio	Grupo
/api/v1/auth	iam-service	login
/api/v1/captcha	iam-service	unauthenticated
/api/v1/me	iam-service	user
/api/v1/accounts	iam-service	user
/api/v1/account-settings	iam-service	user
/api/v1/users	iam-service	user
/api/v1/members	iam-service	user
/api/v1/roles	iam-service	user
/api/v1/tokens	iam-service	user
/api/v1/staff-access-policy	iam-service	user
/api/v1/staff-access-sessions	iam-service	user
/api/v1/presence	iam-service	user
/api/v1/workforce	iam-service	user
/api/v1/sites	sites-service	user
/api/v1/profile	profile-service	user
/api/v1/teams	teams-service	user
/api/v1/audit	audit-service	user

Conversations & inbox

Prefijo	Servicio	Grupo
/api/v1/conversations	conversation-service	user
/api/v1/messages	conversation-service	user
/api/v1/conversation-tags	conversation-service	user
/api/v1/inboxes	conversation-service	user
/api/v1/views	conversation-service	user
/api/v1/templates	conversation-service	user
/api/v1/chat-routing-rules	conversation-service	user
/api/v1/macros	conversation-service	user
/api/v1/chat-settings	conversation-service	user
/api/v1/tasks	conversation-service	user

CRM

Prefijo	Servicio	Grupo
/api/v1/leads	crm-service	user
/api/v1/contacts	crm-service	user
/api/v1/companies	crm-service	user
/api/v1/deals	crm-service	user
/api/v1/pipelines	crm-service	user
/api/v1/lead-statuses	crm-service	user
/api/v1/contact-tags	crm-service	user
/api/v1/segments	crm-service	user
/api/v1/lead-routing-rules	crm-service	user
/api/v1/crm-settings	crm-service	user
/api/v1/crm/campaigns	crm-service	user
/api/v1/custom-fields	meta-service	user

Tickets

Prefijo	Servicio	Grupo
/api/v1/tickets	ticket-service	user
/api/v1/ticket-queues	ticket-service	user
/api/v1/ticket-settings	ticket-service	user
/api/v1/ticket-sla-policies	ticket-service	user
/api/v1/ticket-custom-fields	ticket-service	user
/api/v1/ticket-tags	ticket-service	user

Channels & widget

Prefijo	Servicio	Grupo
/api/v1/channels	channel-service	user
/api/v1/widget-configs	channel-service	user
/api/v1/widget	visitor-service	widget
/api/v1/webhooks	channel-service	webhook-inbound

Visitors

Prefijo	Servicio	Grupo
/api/v1/visitors	visitor-service	user
/api/v1/geo-source	visitor-service	user
/api/v1/funnels	visitor-service	user

Knowledge base

Prefijo	Servicio	Grupo
/api/v1/kb	kb-service	user
/api/v1/kb/public	kb-service	widget

Marketing

Prefijo	Servicio	Grupo
/api/v1/marketing	marketing-service	user
/api/v1/marketing/public	marketing-service	widget
/api/v1/surveys	marketing-service	user
/api/v1/survey-responses	marketing-service	user
/api/v1/meetings	marketing-service	user

Phone

Prefijo	Servicio	Grupo
/api/v1/phone/twilio	phone-service	webhook-inbound
/api/v1/phone	phone-service	user

Automation

Prefijo	Servicio	Grupo
/api/v1/automation	automation-service	user

Reports

Prefijo	Servicio	Grupo
/api/v1/reports	analytics-service	user
/api/v1/dashboards	analytics-service	user
/api/v1/kpi	analytics-service	user

Privacy & consent

Prefijo	Servicio	Grupo
/api/v1/consent	privacy-service	widget
/api/v1/privacy	privacy-service	user
/api/v1/privacy/public	privacy-service	widget

AI

Prefijo	Servicio	Grupo
/api/v1/ai	plugin-service	user · tiempo de espera de 60 s
/api/v1/ai/assistant/reply	plugin-service	webhook-inbound

Notifications

Prefijo	Servicio	Grupo
/api/v1/notifications-policy	notification-service	user
/api/v1/notifications	notification-service	user
/api/v1/notification-templates	notification-service	user
/api/v1/notification-delivery-logs	notification-service	user
/api/v1/push	notification-service	user

Media

Prefijo	Servicio	Grupo
/api/v1/media	media-service	user

Billing

Prefijo	Servicio	Grupo
/api/v1/billing	billing-service	user
/api/v1/billing/webhooks/stripe	billing-service	webhook-inbound

Partner portal

Prefijo	Servicio	Grupo
/api/v1/partner	partner-portal-service	partner
/api/v1/partner/auth	iam-service	login
/api/v1/partner/invitations	partner-portal-service	login
/api/v1/partner/auth/mfa/enroll	iam-service	partner
/api/v1/partner/auth/mfa/confirm	iam-service	partner
/api/v1/partner/auth/step-up	iam-service	partner
/api/v1/r	partner-portal-service	widget

Identity verification (KYC)

Prefijo	Servicio	Grupo
/api/v1/kyc/webhooks/sumsub	kyc-service	webhook-inbound
/api/v1/kyc/webhooks/didww	kyc-service	webhook-inbound
/api/v1/kyc	kyc-service	user

Otras

Prefijo	Servicio	Grupo
/api/v1/auth/me	iam-service	user
/api/v1/auth/sessions	iam-service	user
/api/v1/auth/mfa	iam-service	user
/api/v1/auth/email-change	iam-service	user
/api/v1/auth/swap-company	iam-service	user
/api/v1/privacy/policies	privacy-service	user
/api/v1/compliance	privacy-service	user
/api/v1/identity-graph	identity-graph-service	user

De dónde sale la lista

Esta tabla se genera a partir de la tabla de rutas del gateway en el repositorio del backend, copiada como instantánea en este sitio. Una comprobación antes de cada despliegue compara la instantánea con la tabla de rutas actual, así que no se puede añadir ni quitar una familia en el producto sin que cambie esta página. Se excluyen las rutas internas de la consola del personal. El documento OpenAPI legible por máquina se describe en la página OpenAPI.