Validar palabra clave: notas y ejemplos

Complementa la validación de palabras clave con notas de regulación, codificación y ejemplos de petición y respuesta.

Notas técnicas

• Regulación local: las palabras clave deben cumplir con las regulaciones locales del país de origen. Por ejemplo, algunas regiones prohíben palabras clave relacionadas con contenido para adultos o juegos de azar.
• Codificación: si la palabra clave contiene caracteres especiales (acentos, símbolos no GSM), el procesamiento del mensaje entrante relacionado podría verse afectado por la codificación Unicode. Esto es más crítico en el envío de mensajes (MT) que en la recepción y validación de palabras clave.
• Latencia de registro: una vez que una palabra clave se valida como disponible, se recomienda crear el proceso de reenvío de inmediato para evitar que otro usuario la reserve.

Ejemplo de solicitud

curl --request POST \
 --url https://api.getincloud.online/jacaerys/v1/forwards/keyword-validation \
 --header 'accept: application/json' \
 --header 'content-type: application/json' \
 --header 'Authorization: Bearer YOUR_TOKEN' \
 --data '
{
 "origin": "141518",
 "keyword": "OFERTA",
 "clientId": "client_abc_123",
 "externalId": "val-9988",
 "email": "dev@empresa.com"
}
'

Respuesta 200 OK

{
 "available": true,
 "message": "Keyword is available for the specified origin.",
 "externalId": "val-9988"
}

Respuesta 409 Conflict

{
 "available": false,
 "message": "Keyword is already in use by another process.",
 "error_code": "KEYWORD_ALREADY_EXISTS"
}