Esta función envía un fax desde un registro de Zoho Creator a través de la API de RingCentral: se autentica, almacena en caché el token de acceso para que no tenga que volver a autenticarse en cada llamada, extrae un PDF de un informe de Creator y lo envía a RingCentral como una solicitud multipart.

Antes de empezar

• Una aplicación de RingCentral en la consola del desarrollador con el flujo de autenticación JWT habilitado y los permisos de fax otorgados. Genere una credencial JWT allí.
• Un formulario de creador llamado RC_Token con los campos Access_Token (varias líneas), Expiry_Time (fecha y hora), Added_User .
• Una conexión Zoho OAuth para descargar el PDF del informe, denominada creator_oauth_connection .
• Guarda CLIENT_ID , CLIENT_SECRET y el JWT en variables de Creator. Se muestran solo en línea a continuación para que el ejemplo se lea de forma coherente.

Función de diluvio

 // ============================================
 // FAX DE RINGCENTRAL DESDE ZOHO CREATOR (AUTENTICACIÓN JWT)
 // Función independiente. Se puede llamar desde un botón o un flujo de trabajo.
 // ============================================

 void ringcentral.sendFax(string faxNumber, string coverText, int recordId)
 {
 // --- Credenciales. Almacenarlas como variables de Creator, no en línea. ---
 ID_CLIENTE = "SU_ID_CLIENTE_RINGCENTRAL";
 SECRETO_DEL_CLIENTE = "SU_SECRETO_DEL_CLIENTE_DE_RINGCENTRAL";
 JWT_CREDENTIAL = "SU_CREDENCIA_JWT_DE_LA_CONSOLA_RC";
 API_SERVER = "https://platform.ringcentral.com";

 // --- 1. Reutilizar un token almacenado en caché si aún es válido ---
 accessToken = "";
 cached = RC_Token[ID != null] ordenar por Added_Time descendente rango de 0 a 1;
 if(cached.count() > 0 && zoho.currenttime < cached.Expiry_Time)
 {
 accessToken = cached.Access_Token;
 }
 demás
 {
 // --- 2. Flujo de portador JWT. Reemplaza la concesión de contraseña obsoleta. ---
 authHeaders = Mapa();
 authHeaders.put("Authorization","Basic " + zoho.encryption.base64Encode(CLIENT_ID + ":" + CLIENT_SECRET));
 authHeaders.put("Content-Type","application/x-www-form-urlencoded");

 authBody = Mapa();
 authBody.put("grant_type","urn:ietf:params:oauth:grant-type:jwt-bearer");
 authBody.put("aserción",JWT_CREDENTIAL);

 authResp = invokeurl
 [
 URL: API_SERVER + "/restapi/oauth/token"
 tipo: POST
 parámetros: authBody
 encabezados: authHeaders
 ];

 accessToken = authResp.getJSON("access_token");
 if(accessToken == null || accessToken == "")
 {
 info "Error de autenticación de RingCentral: " + authResp.toString();
 devolver;
 }

 expiresIn = authResp.getJSON("expires_in").toLong();
 eliminar de RC_Token[ID != null];
 insertar en RC_Token
 [
 Usuario_añadido = zoho.loginuser
 Token_de_acceso = token_de_acceso
 Tiempo_de_Expiración = zoho.currenttime.addSeconds(expiresIn - 300)
 ];
 }

 // --- 3. Obtenga el PDF para enviar por fax, directamente desde Creator ---
 Archivo PDF = URL de invocación
 [
 url: "https://creatorapp.zohopublic.com/TU_CUENTA/TU_APLICACIÓN/reportaje/Facturas/" + recordId + "/pdf"
 tipo: GET
 conexión: "creator_oauth_connection"
 ];

 // --- 4. Envíe el fax. multipart/form-data, directamente a RingCentral. ---
 faxHeaders = Mapa();
 faxHeaders.put("Authorization","Bearer " + accessToken);

 faxParams = Mapa();
 faxParams.put("a",faxNumber);
 faxParams.put("faxResolution","High");
 faxParams.put("coverIndex",0);
 faxParams.put("coverPageText",coverText);

 faxResp = invokeurl
 [
 url: API_SERVER + "/restapi/v1.0/account/~/extension/~/fax"
 tipo: POST
 parámetros: faxParams
 archivos: archivo pdf
 encabezados: faxHeaders
 ];

 msgId = faxResp.getJSON("id");
 si(msgId != null)
 {
 info "Fax en cola. ID del mensaje " + msgId + ", estado " + faxResp.getJSON("messageStatus");
 }
 demás
 {
 info "Error de fax de RingCentral: " + faxResp.toString();
 }
 } 

Notas

• La caché de tokens es importante. RingCentral limita estrictamente la velocidad de acceso al punto final de tokens. Autenticarse en cada fax provocará una limitación de velocidad. La búsqueda RC_Token reutiliza un token hasta cinco minutos antes de su vencimiento.
• from " no lo configuras tú. RingCentral toma el número de fax de envío de la configuración de fax saliente de la extensión. Incluir un from en la solicitud no tiene ningún efecto.
• Límites. 50 MB en total, 200 páginas y sin caracteres especiales en los nombres de archivo adjuntos: un nombre de archivo con una coma o una barra inclinada provocará que la solicitud falle.
• Primero, prueba en el entorno de pruebas. Sustituye API_SERVER por https://platform.devtest.ringcentral.com durante las pruebas. Los faxes en el entorno de pruebas no se envían ni se facturan.