PUT
https://api.getincloud.online/jacaerys/v1/forwards/{id}Actualizar proceso de reenvío
Modifica la configuración de un proceso de reenvío existente, como palabra clave, destino o estado.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Este endpoint permite modificar la configuración de un proceso de reenvío existente. Al actualizarlo, puedes cambiar los criterios de activación (como palabras clave) o el destino donde se enviarán los mensajes entrantes.
PUT https://api.getincloud.online/jacaerys/v1/forwards/{id}Parámetros de la ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | Identificador único del proceso de reenvío que se desea actualizar. |
Parámetros del cuerpo
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | No | Nombre descriptivo del proceso de reenvío. |
| origin | string | No | Código corto o número largo asociado al proceso. |
| keyword | string | No | Palabra clave específica que activa el reenvío. |
| targetUrl | string | No | URL del servidor (webhook) donde se enviará la información del mensaje entrante. |
| type | string | No | Tipo de acción o protocolo utilizado para el reenvío (ej. HTTP_POST). |
| status | string | No | Estado del proceso. Valores permitidos: ACTIVE, INACTIVE, PAUSED. |
| externalId | string | No | Identificador único de tu propio sistema para este proceso. |
| clientId | string | No | Identificador único del cliente asociado con la solicitud. |
| string | No | Dirección de correo asociada con el proceso para registro o notificación. | |
| callbackUrl | string | No | URL adicional para recibir notificaciones de eventos relacionados con este proceso. |
Respuestas
| Código | Descripción |
|---|---|
| 200 OK | La solicitud se completó con éxito. Devuelve id (string, ID del proceso), status (string, estado actual tras la actualización) y updated_at (string, fecha y hora de la última modificación). |
| 400 Bad Request | Solicitud inválida. Puede deberse a parámetros mal formateados o campos obligatorios faltantes en la estructura del JSON. |
| 401 Unauthorized | No se pudo autenticar la solicitud. El token Bearer o JWT es inválido, falta o ha expirado. |
| 403 Forbidden | El usuario no tiene permisos suficientes para realizar esta acción sobre el recurso. |
| 404 Not Found | El proceso de reenvío con el id proporcionado no existe. |
| 409 Conflict | Se intenta actualizar un proceso con una combinación de origin y keyword que ya usa otro proceso activo. El sistema no permite duplicidad en estas reglas. |
| 500 Internal Server Error | Error inesperado en el servidor. |
Ejemplo de solicitud
curl --request PUT \
--url https://api.getincloud.online/jacaerys/v1/forwards/550e8400-e29b-41d4-a716-446655440000 \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data '
{
"name": "Update Promo Forward",
"keyword": "OFERTA",
"status": "ACTIVE",
"clientId": "client_99",
"email": "soporte@empresa.com",
"externalId": "ext-987"
}
'Nota sobre codificación y costos
Aunque este endpoint es para configuración de reenvío, los mensajes que se procesen a través de este sistema están sujetos a las reglas de codificación GSM-7 y Unicode. Si el reenvío implica una respuesta automática, el uso de caracteres especiales fuera del estándar GSM-7 reducirá el límite de caracteres a 70 por segmento, lo que afecta el costo final.
AnteriorPre-registro de plantillas SMS para EcuadorSiguienteCaracteres especiales que activan Unicode
¿Te sirvió esta página?