Telefonía y alta de números

De un lado está una red de operadores: números de teléfono reales con obligaciones regulatorias reales, a los que se llega mediante un proveedor de comunicaciones que la plataforma revende o que te deja conectar directamente. Ese proveedor tiene el inventario de números, los servicios de mensajería o grupos de remitentes a los que pertenecen los números, los registros que los operadores revisan antes de aceptar tráfico de aplicación a persona y la capa de control de llamadas que decide qué pasa cuando alguien marca. Del lado de AppBO están la bandeja de entrada de conversaciones, las funciones de llamadas y mensajes de texto en la ficha del contacto, los flujos de llamadas y los menús IVR, las grabaciones y el buzón de voz, y las automatizaciones que se disparan con un mensaje entrante o una llamada perdida.

Los conectas porque un CRM sin canal telefónico es solo la mitad de un registro. El valor no es simplemente que puedas marcar desde la página del contacto; es que cada llamada y cada mensaje de texto quedan registrados en la persona de forma automática, que una llamada perdida puede disparar un mensaje de respuesta en segundos, que un mensaje entrante llega a una bandeja de entrada compartida en lugar de al teléfono de una sola persona y que los reportes de llamadas quedan junto a los reportes de todo lo demás.

Esta es la integración con más filtros externos, y eso define el plan del proyecto. Los números se tienen que comprar o portar. El tráfico de mensajes a celulares en varios países tiene que registrarse con los operadores antes de entregarse de forma confiable, lo que toma tiempo real y exige datos exactos del negocio. Grabar llamadas implica obligaciones de consentimiento que cambian según la jurisdicción. Nada de esto son ajustes de la plataforma; son pasos de cumplimiento que la plataforma pone a tu alcance, y la integración no está terminada hasta que se completan.

1. Primero reúne los datos de identidad del negocio, exactamente como aparecen en los registros oficiales: razón social, número de registro o identificación fiscal, domicilio registrado, sitio web y un contacto autorizado. El registro ante los operadores se valida contra estos datos, y una diferencia es la causa más común de rechazos y de semanas de retraso.
2. Decide si vas a usar la telefonía incluida en la plataforma o conectar tu propia cuenta con el proveedor. La incluida es más rápida y se factura a través de la plataforma; tu propia cuenta te da acceso directo a la consola del proveedor, a los registros y al inventario de números, lo que importa cuando hay que depurar algo a nivel del operador.
3. Si conectas tu propio proveedor, crea la cuenta, completa su verificación de identidad y genera las credenciales de API. Ingrésalas en la configuración de teléfono de la subcuenta y confirma que la plataforma muestra la conexión como activa.
4. Define el plan de números antes de comprar nada: cuántos números, en qué códigos de área o regiones, cuáles se usan para llamadas, cuáles para mensajes y si alguno se reserva para una campaña específica para que su reputación quede separada.
5. Compra los números en el catálogo de números de la plataforma y elige las capacidades a propósito (voz, SMS, MMS), porque no todos los números de todas las regiones soportan las tres. Revisa los indicadores de capacidad antes de comprar, no después.
6. Para un número de negocio que ya existe, inicia una portabilidad en lugar de comprar. Envía una carta de autorización, una factura reciente que muestre al titular de la cuenta y la dirección del servicio, y los datos exactos de la cuenta que tiene el operador actual. Mantén activo el servicio anterior hasta que termine la portabilidad; cancelarlo antes deja el número en el aire.
7. Envía el registro de mensajería que exige tu mercado. En Estados Unidos es el registro de marca y de campaña para 10DLC, donde declaras el negocio, el caso de uso, mensajes de ejemplo y el método de consentimiento (opt-in); otros países tienen sus propios regímenes, incluido el registro del identificador de remitente. Envía los mensajes de ejemplo reales y el texto real de consentimiento, porque los revisores los comparan con tu tráfico en vivo.
8. Asigna los números registrados al servicio de mensajería o grupo de remitentes que cubre el registro. Un número sin asignar envía como tráfico no registrado, que se filtra o paga recargo.
9. Publica la evidencia del consentimiento. El formulario, la landing page o el checkout que recoge el consentimiento debe mostrar el texto de aviso, y conviene que guardes una captura de pantalla o la URL, porque los operadores la piden.
10. Configura el enrutamiento de voz: qué número suena a qué usuario o grupo de timbrado, el orden de timbrado y el tiempo de espera, qué pasa si nadie contesta, el saludo y la transcripción del buzón de voz, y el comportamiento dentro y fuera del horario de atención.
11. Arma el IVR o menú de llamadas si lo necesitas, con un árbol poco profundo, y verifica cada rama, incluido el camino por defecto cuando quien llama no presiona nada.
12. Configura el identificador de llamadas. Configura el nombre del identificador de llamadas salientes donde tu mercado lo permita, y asegúrate de que el número que ve la gente sea uno que llegue a ti cuando devuelvan la llamada.
13. Decide y configura la grabación de llamadas, con el anuncio o la solicitud de consentimiento que exige tu jurisdicción. En las regiones donde se necesita el consentimiento de ambas partes, el anuncio tiene que sonar antes de la conversación, no estar en una página de términos.
14. Configura el cumplimiento de mensajería: un manejador de la palabra clave de baja (opt-out) que actualice el estado de mensajería del contacto, la identificación obligatoria del remitente en el primer mensaje de una conversación y el horario de silencio si tu mercado lo exige.
15. Verifica las llamadas entrantes de principio a fin: llama al número desde un teléfono externo, confirma que suena al usuario correcto, confirma que la llamada aparece en la ficha del contacto y confirma que el buzón de voz y la transcripción funcionan cuando nadie contesta.
16. Verifica los mensajes en ambas direcciones con un teléfono real en una red móvil grande y después prueba la palabra clave de baja y confirma que el estado del contacto cambió y que se bloquean los envíos siguientes.
17. Verifica las automatizaciones: respuesta por texto a llamadas perdidas, notificación de mensajes entrantes y flujos según el resultado de la llamada. Después documenta qué hace cada número y a quién contactar en el proveedor cuando haya que darle seguimiento a una portabilidad o a un registro.

De la plataforma al proveedor de telefonía

• Solicitudes de llamadas salientes: el número de origen, el número de destino y las instrucciones de control de llamada que conectan, graban, reproducen un saludo o enrutan a un menú.
• Mensajes salientes: número de origen o grupo de remitentes, destino, texto del mensaje y archivos multimedia para los mensajes con imagen.
• Solicitudes de compra, liberación y configuración de números, incluido qué webhook recibe los eventos entrantes de cada número.
• Envíos de registro cuando la plataforma hace de intermediaria: datos de la marca y de la campaña, caso de uso, mensajes de ejemplo y descripción del consentimiento.
• Solicitudes de portabilidad con sus documentos de respaldo.
• Instrucciones de grabación y transcripción para cada llamada.

Del proveedor de telefonía a la plataforma

• Eventos de llamadas entrantes, con el número de quien llama, el número marcado y las marcas de tiempo, que crean un contacto o se asocian a uno y abren una conversación.
• Avance y resultado de la llamada: contestada, sin respuesta, ocupado, fallida, duración y quién contestó dentro de un grupo de timbrado.
• Archivos de grabación y transcripciones, asociados a la llamada en la ficha del contacto.
• Mensajes entrantes y archivos multimedia, relacionados con un contacto por su número.
• Confirmaciones de entrega de los mensajes: enviado, entregado, no entregado, fallido, con el código de error del operador que explica por qué.
• Señales de baja por las palabras clave estándar y bloqueos a nivel del operador.
• Cambios de estado del registro y de la portabilidad.

Lo que no se mueve

• El historial de llamadas de un sistema telefónico anterior. Nada se carga hacia atrás; una portabilidad mueve el número, no sus registros.
• Los mensajes de voz que quedaron en un sistema anterior y los saludos grabados ahí.
• La reputación ante los operadores o la aprobación del registro para el tráfico que envías fuera de la campaña registrada.
• Los nombres de los contactos. La consulta del identificador de llamadas, donde existe, es una función del proveedor y no llena campos del CRM por sí sola.
• Los mensajes de texto enviados desde el teléfono. Un mensaje que un miembro del equipo envía desde su propio celular nunca aparece en la plataforma.
• El consentimiento. Un contacto que dio su consentimiento en otro lado no lo tiene aquí a menos que el registro lo diga; mantener el estado del consentimiento es tu responsabilidad.
• El detalle de facturación más allá de lo que muestra la plataforma; la conciliación del consumo se queda en la cuenta del proveedor.

Escenario: un negocio de servicios para el hogar porta su línea principal, se registra para mensajería y activa la respuesta por texto a llamadas perdidas.

1. El dueño reúne la razón social, la identificación fiscal y el domicilio registrado a partir de los documentos de constitución, y la última factura del proveedor telefónico actual.
2. Primero se compra un número local nuevo en la plataforma, como línea de trabajo temporal, para que nada dependa de que la portabilidad termine en una fecha límite.
3. Se envía la solicitud de portabilidad del número principal que se anuncia, con la carta de autorización y la factura. El operador actual la rechaza una vez porque la dirección del servicio en la factura es una dirección vieja; el dueño la corrige y la vuelve a enviar.
4. En paralelo se envía el registro de marca y de campaña para mensajería, declarando un caso de uso de atención al cliente y recordatorios de citas, con los tres mensajes de ejemplo que el negocio de verdad envía y un enlace al formulario de reservas que tiene la casilla de consentimiento y el texto de aviso.
5. Se actualiza el formulario de reservas del sitio web para que el texto de consentimiento se vea junto a la casilla, y la casilla no viene marcada de antemano.
6. El registro se aprueba después de la revisión y los dos números se asignan al servicio de mensajería aprobado, para que su tráfico se reconozca como registrado.
7. Se configura el enrutamiento de voz: el número principal suena al mismo tiempo en el teléfono de la oficina y en el celular del dueño durante veinticinco segundos y después pasa al buzón de voz con la transcripción activada.
8. Se activa un anuncio de grabación antes de conectar la llamada, porque el negocio opera en una región que exige el consentimiento de todas las partes.
9. La portabilidad se completa durante la noche en la fecha acordada. El servicio del operador anterior se cancela solo después de que una llamada de prueba confirma que el número ya suena a través de la plataforma.
10. Se activa un flujo de respuesta por texto a llamadas perdidas: cuando una llamada al número principal termina sin respuesta, la plataforma envía un mensaje de texto desde el mismo número para disculparse y ofrecer el enlace de reserva.
11. Una clienta llama a la hora del almuerzo, nadie contesta y veinte segundos después recibe el mensaje. Responde con una pregunta; el mensaje llega a la bandeja de entrada de conversaciones compartida, no al teléfono de una sola persona.
12. Un miembro del equipo responde desde la bandeja de entrada, agenda el trabajo y la cita se crea en el contacto con todo el historial de llamadas y mensajes asociado.
13. La semana siguiente, un recordatorio por texto a otro cliente falla con un error del operador. La confirmación de entrega muestra que el destino es un teléfono fijo, así que la rama alternativa del flujo crea una tarea de llamada.
14. Una tercera clienta responde con la palabra clave de baja. La plataforma registra la baja, bloquea los siguientes mensajes a ese contacto y el flujo de recordatorios la pasa a recibir solo email.

Límites de uso

La capacidad de envío de mensajes está limitada por número y por campaña registrada, y el límite depende del nivel de registro que te asignaron los operadores, no de tu plan con el proveedor. La voz también tiene límites de llamadas simultáneas. El síntoma es una cola: un envío a una lista grande se va vaciando lentamente durante horas, lo que importa cuando el mensaje es urgente. Revisa en la consola de tu proveedor y en la guía vigente de los operadores la capacidad que de verdad tiene asignada tu campaña en lugar de suponer una cifra, y reparte los envíos de alto volumen entre varios números registrados si de verdad necesitas velocidad.

Reintentos e idempotencia

Las fallas al enviar mensajes se reintentan, y un tiempo de espera agotado sin respuesta clara puede producir un envío doble, que por SMS le molesta mucho más al destinatario que un email duplicado. Las confirmaciones de entrega llegan de forma asíncrona y desordenada, y la misma confirmación puede llegar dos veces, así que cualquier manejador tiene que eliminar duplicados con el identificador del mensaje y tomar como válido el estado más reciente, no el último que llegó. Los webhooks de llamadas tienen el mismo carácter de entrega al menos una vez: un flujo de trabajo que se dispara al terminar una llamada tiene que tolerar correr dos veces sin registrar dos llamadas ni enviar dos seguimientos.

Trampas al mapear campos

El formato de los números es la trampa de siempre. Guarda y envía en formato internacional completo; un número en formato nacional importado desde una hoja de cálculo no va a coincidir con un contacto, va a crear una conversación duplicada y no se va a entregar en el extranjero. Las suposiciones sobre el código de país en las importaciones son una causa frecuente de mensajes que llegan a otro país por completo. Los campos combinados en un SMS ocupan caracteres, así que una plantilla que cabe en un segmento con un nombre corto se divide en dos con uno largo, y los mensajes de varios segmentos cuestan y se entregan de forma distinta. Los caracteres no estándar pueden cambiar todo el mensaje a otra codificación y reducir a la mitad los caracteres por segmento.

Creación de duplicados

Los contactos duplicados aparecen cuando la misma persona escribe desde un número guardado en otro formato o llama desde un celular del trabajo que no está en el registro. Las conversaciones duplicadas aparecen con el tráfico entrante a dos números distintos del negocio. Decide cuál es el número público, deja los demás para campañas específicas y normaliza cada número al importar y al recibir formularios.

Pruebas contra producción

Los proveedores ofrecen credenciales de prueba que aceptan solicitudes sin tocar la red de los operadores, lo que demuestra que tu configuración está bien y no demuestra nada sobre la entrega. El filtrado de los operadores, el estado del registro y el comportamiento de los teléfonos solo se ven en vivo. Antes de lanzar, prueba con teléfonos reales en más de una red móvil, y ten en cuenta que los números en modo de prueba no se pueden registrar, así que el proceso de registro hay que recorrerlo de verdad.

Vencimiento de la autenticación

Las credenciales de API del proveedor se pueden rotar o revocar, y una cuenta suspendida con el proveedor (por saldo pendiente, una verificación de identidad fallida o una queja de cumplimiento) desactiva la voz y la mensajería a la vez sin ningún aviso del lado de la plataforma. Las aprobaciones de registro también se pueden revocar si tu tráfico en vivo se aleja de los ejemplos que enviaste. Vigila la tasa de entrega como señal de salud, porque una caída repentina casi siempre es un problema del operador o de la cuenta, no del contenido.

Lo que se rompe con más frecuencia

• Enviar antes de que se apruebe el registro, así que los mensajes se filtran sin avisar y nadie se da cuenta durante días.
• Contenido de los mensajes en vivo que ya no se parece a los ejemplos aprobados, lo que pone en riesgo la aprobación de la campaña.
• Una portabilidad cancelada o retrasada porque los registros del operador actual difieren en un carácter de lo que se envió.
• El servicio telefónico anterior cancelado antes de que termine la portabilidad, con lo que se pierde el número.
• Mensajes a teléfonos fijos, que fallan con un error del operador que parece una falla de la plataforma.
• Grabación de llamadas activada sin el anuncio que exige la jurisdicción de quien llama.
• Un ciclo de respuesta por texto a llamadas perdidas que se dispara con llamadas de números internos del equipo, o que le escribe una y otra vez a un teléfono fijo.
• Reglas de horario de silencio ignoradas, que generan quejas que terminan alimentando el filtrado de los operadores.
• Palabras clave de baja que procesa el operador pero que no se reflejan en el contacto, así que la plataforma sigue poniendo en cola envíos que nunca llegan.
• Un número compartido entre varias subcuentas o marcas, así que una queja sobre una campaña afecta la entrega de todas.