Skip to main content
Cada ámbito es una puerta en su clave: enviar, consultar, cancelar o gestionar agentes — abra solo lo necesario.
Cada ámbito libera un tipo de operación en RCS. Use solo lo que su integración necesita.

​
Cómo enviar la clave

Recomendado
Alternativo
La API Key pertenece a un workspace. No accede a otro workspace con la misma clave.

​
Combinaciones comunes

Solo enviar

rcs:send

Enviar y consultar

rcs:send, rcs:read

Con programación

rcs:send, rcs:cancel

Flujo completo de mensajes

rcs:send, rcs:read, rcs:cancel

Gestionar agentes

rcs:instances:list, rcs:instances:create, rcs:instances:delete

Integración completa

Todos los ámbitos RCS anteriores
Lista de ámbitos vacía al crear = acceso ADMIN. En producción, restrinja siempre.

​
Ámbitos disponibles

Envío RCS inmediato o programado a 1–500 números por solicitud. Tipos: BASIC, CARD, CAROUSEL, FILE, plantilla. Use from para el agente de marca (id o nombre).Endpoint: POST /v1/rcs/messages
Listar y consultar envíos RCS, y listar/detallar mensajes recibidos (inbound).Endpoints: GET /v1/rcs/messages, GET /v1/rcs/messages/:id, GET /v1/rcs/inbound, GET /v1/rcs/inbound/:id
Cancelar mensaje en cola o programado. Solo con estado QUEUED o SCHEDULED. Los créditos se devuelven cuando aplica.Endpoint: POST /v1/rcs/messages/:id/cancel
Listar instancias RCS del workspace y consultar detalle de un agente.Endpoints: GET /v1/rcs/instances, GET /v1/rcs/instances/:instanceId
Crear instancia, actualizar perfil del agente y enviar a aprovisionamiento.Endpoints: POST /v1/rcs/instances, PATCH /v1/rcs/instances/:instanceId, POST /v1/rcs/instances/:instanceId/submit
Eliminar instancia RCS del workspace.Endpoint: DELETE /v1/rcs/instances/:instanceId

​
Restricción por instancia

Si la API Key tiene instanceIds definido, solo accede y envía por las instancias listadas. Lista vacía = acceso a todas.

​
Errores comunes

Verifique Authorization: Bearer sk_... y que la clave no fue eliminada en el panel.
Créditos insuficientes (INSUFFICIENT_CREDITS) o plan expirado (WORKSPACE_BLOCKED).
Verifique el ámbito de la operación. La programación depende del plan (PLAN_LIMIT_SCHEDULING). Instancia no permitida por la clave devuelve FORBIDDEN.
Límite de instancias del plan alcanzado al crear agente.
Solo cancela con estado QUEUED o SCHEDULED. Después de enviado, no hay cancelación.
Intento de envío con instanceId de agente aún no aprobado.

​
Próximos pasos