Si tu equipo llama a leads de Zoho CRM, revisá el teléfono al crearlo o cuando cambie. La función Deluge puede tomar Mobile o Phone, pedir una validación de formato y dejar el número en E.164 en un campo separado para quien va a llamar.
1. Prepará la función y la conexión
Usá una función de workflow del módulo Leads. Pasale leadId con el ID del lead y defaultCountry con el código ISO de dos letras del país del teléfono, si lo conocés. Por ejemplo, usá AR para un formulario que solo recibe teléfonos argentinos. En un formulario multinacional, pedí el código de país o el número internacional.
Creá una conexión personalizada con nombre de enlace byebouncer_api que envíe el encabezado Authorization con el valor Bearer seguido de tu clave de ByeBouncer. Configurá el secreto en la conexión del lado servidor.
2. Validá el formato antes de consultar el operador
Este ejemplo toma Mobile primero y recurre a Phone si está vacío. Enviá solo el teléfono y el país de referencia. Ajustá los nombres API si tu CRM usa campos personalizados.
lead = zoho.crm.getRecordById("Leads", leadId.toLong());
phone = ifnull(lead.get("Mobile"), "").trim();
if(phone == "")
{
phone = ifnull(lead.get("Phone"), "").trim();
}
if(phone != "")
{
payload = Map();
payload.put("phone", phone);
if(defaultCountry != null && defaultCountry != "")
{
payload.put("default_country", defaultCountry);
}
response = invokeurl
[
url: "https://api.byebouncer.com/api/v1/verify-phone/local?result_format=validation-v1"
type: POST
headers: {"Content-Type":"application/json"}
body: payload.toString()
connection: "byebouncer_api"
detailed: true
];
// Inspect responseCode before using responseText.
// Save the format result in a separate CRM field.
}3. Guardá el resultado en campos separados
Con HTTP 200, leé results.phone.checks.format. Si state es completed y value es true, guardá results.phone.normalized cuando esté presente. Si value es false, marcá el formato para revisión. Si el check no está disponible o falla la llamada, dejá el resultado pendiente. Conservá el valor original y registrá cuándo se hizo la comprobación.
Probá primero con tres leads de prueba: un número internacional bien formado, un formato inválido y un campo vacío. Configurá el workflow para ejecutarse al crear el lead o al cambiar el teléfono, así la escritura del resultado en el CRM no vuelve a disparar la consulta.
Si tu proceso necesita conocer la compañía, usá el endpoint separado /api/v1/verify-phone/carrier y consultá checks.carrier y attributes.carrier. El formato describe el plan de numeración. La consulta de operador aporta información de red cuando está disponible.
Ver cómo funciona la validación de teléfono →
Ejemplos de celulares y fijos de Argentina →
Consultar la documentación de la API →