Referencia de configuración de la organización

Administra una organización de ThunderPhone: perfil, idioma del panel, miembros, confirmación de llamadas salientes, quienes llaman bloqueados, webhooks, SSO, claves de API, alertas, facturación, límites de gasto e historial.

Abre Configuración de la organización (/dashboard/organization) para administrar la organización activa y tu propia cuenta. La configuración se divide en seis pestañas; tu rol determina qué controles puedes modificar.

Mi cuenta#

La pestaña Mi cuenta contiene la configuración del usuario que inició sesión, no de toda la organización:

• Nombre, apellido, correo electrónico y una URL de avatar.
• Idioma de visualización del panel.
• Descarga de la aplicación de escritorio para macOS.
• Agregar, verificar, listar y eliminar claves de acceso.
• Preferencias de cookies.
• Cerrar sesión en el dispositivo actual.

Cuando inicias sesión mediante el SSO de la organización, el proveedor de identidad administra tu correo electrónico y aquí es de solo lectura. Consulta Cuenta y seguridad para conocer el flujo detallado de claves de acceso y perfil.

General#

Cumplimiento de llamadas salientes#

Para las organizaciones donde aplica el requisito, un propietario o administrador debe revisar y registrar la confirmación única de llamadas salientes antes de que los agentes puedan realizar llamadas salientes. Los miembros pueden ver que se requiere esta acción, pero no pueden enviarla. Consulta Leyes sobre llamadas salientes.

Reportes#

La zona horaria, el horario comercial semanal y los números de prueba propios de la organización. El horario comercial determina qué llamadas cuentan como fuera de horario en los números de reportes de Inicio, en la pestaña Llamadas de cada agente y en los Portales de clientes, y en el filtro Horario comercial del Historial de llamadas. Si no se selecciona ningún día, las llamadas fuera de horario no se registran y todas las llamadas cuentan como horario comercial. Las llamadas desde o hacia un número de prueba se excluyen de todos los conteos de reportes, así como de las listas de portales, los números de Resumen y las exportaciones CSV; no se pueden abrir en un portal. Un agente puede tener su propia zona horaria y horario en Reportes en el creador de agentes, que luego se aplican solo a las llamadas de ese agente.

Los propietarios y administradores cambian esta configuración en General → Reportes. Elige la zona horaria y selecciona cada día de atención, luego ingresa sus horarios de apertura y cierre. En Números de prueba, ingresa cada número y selecciona Agregar. Luego selecciona Guardar configuración de reportes. Hasta que se guarde una zona horaria, los reportes usan UTC; la página sugiere la zona de tu navegador como un cambio sin guardar. Una vez que se configura cualquier horario comercial, los días no seleccionados cuentan como fuera de horario para las llamadas que usan ese horario.

Configurar reportes mediante la API#

Los propietarios y administradores pueden usar PATCH /v1/orgs/{id}/ con timezone, business_hours y excluded_numbers:

• timezone: un nombre de zona horaria de IANA, como America/Los_Angeles, de hasta 64 caracteres.
• business_hours: claves de días de la semana de mon a sun, cada una con una lista de hasta cuatro franjas {start, end} en formato de 24 horas HH:MM, donde cada hora de fin debe ser posterior a su hora de inicio. {} significa que no hay división de fuera de horario.
• excluded_numbers: hasta 50 números de teléfono, almacenados en formato E.164. Un número norteamericano de 10 dígitos sin prefijo recibe el código de país +1.

curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/Los_Angeles",
    "business_hours": {
      "mon": [{"start": "09:00", "end": "17:00"}],
      "sat": [{"start": "10:00", "end": "14:00"}]
    },
    "excluded_numbers": ["+14155550199"]
  }'

Quienes llaman bloqueados#

Los números de esta lista no pueden comunicarse con tus agentes. Cuando un número bloqueado llama a cualquiera de los números de teléfono de tu organización, ThunderPhone cuelga antes de que un agente responda y no factura la llamada. Aun así, aparece en el Historial de llamadas como una llamada entrante fallida con el motivo de finalización Quien llama bloqueado. Las llamadas con un ID de quien llama oculto o anónimo nunca coinciden, y las llamadas salientes a un número bloqueado no se ven afectadas. A quien bloquees durante una llamada no se le corta la llamada; el bloqueo se aplica a partir de su siguiente llamada.

Todos los miembros pueden ver la lista; los propietarios y administradores la cambian en General → Quienes llaman bloqueados:

• Para bloquear un número, ingrésalo con una nota opcional y selecciona Bloquear número. Usa + y el código de país; un formato nacional como (415) 555-0123 también funciona cuando todos los números de teléfono de tu organización están en un solo país.
• Para bloquear varios números a la vez, selecciona Pegar una lista, pega hasta 500 números (uno por línea o separados por comas) y envíala. El resultado muestra cuántos se agregaron, ya estaban bloqueados o no son válidos, y enumera las entradas no válidas.
• Para desbloquear un número, selecciona Eliminar en su fila y confirma.

También puedes abrir una llamada entrante en el Historial de llamadas y seleccionar Bloquear a quien llama. Una organización puede bloquear hasta 10,000 números. Para administrar la lista mediante la API, consulta Quienes llaman bloqueados.

Identidad y membresía de la organización#

La tarjeta de la organización muestra el ID de la organización, tu rol de miembro y el nombre editable de la organización. La tarjeta del equipo combina miembros activos e invitaciones pendientes.

Los propietarios y administradores pueden invitar a un Miembro o Administrador, revocar una invitación pendiente, cambiar los roles de miembros elegibles y eliminar miembros. Las invitaciones son específicas para cada correo electrónico y vencen después de siete días. Consulta Invita a tu equipo.

La zona de peligro permite que un usuario elegible abandone una organización o la elimine permanentemente. La eliminación borra los agentes, números, historial de llamadas y datos de facturación de la organización, y no se puede deshacer.

Para eliminar tu propia cuenta, abre la pestaña Cuenta y elige Eliminar cuenta. El cuadro de diálogo muestra las organizaciones que se eliminarán (aquellas en las que eres el único miembro) y las que abandonarás. Se revocan las claves de API que creaste en una organización que abandones. La eliminación se bloquea si eres el único propietario de una organización que tiene otros miembros (primero asigna a otra persona como propietaria), si creaste voces personalizadas en una organización que permanece, si hay una llamada en curso o si aplica una retención legal; el cuadro de diálogo muestra lo que la está bloqueando. No se puede deshacer.

Webhook predeterminado#

Configura una URL de webhook heredado para recibir eventos de todos los widgets web y números telefónicos de la organización. Para secretos por punto de conexión, suscripciones, historial de entregas y reintentos, usa los puntos de conexión de webhook recomendados.

SSO empresarial#

Configura una o más conexiones SSO, dominios de correo electrónico permitidos, aprovisionamiento justo a tiempo, el rol predeterminado y asignaciones opcionales de grupo a rol. La política de seguridad puede requerir SSO, permitir acceso de emergencia con contraseña para administradores y requerir claves de acceso para el acceso a la organización. Consulta SSO.

Claves#

La pestaña Claves administra claves de API secretas de servidor sk_live_. Cada fila muestra el nombre, prefijo, estado activo o revocado, hora de creación, último uso y hora de revocación.

El secreto completo se muestra solo una vez, inmediatamente después de crearlo. Cópialo entonces y guárdalo en un administrador de secretos. La revocación es permanente y detiene todas las integraciones que usan la clave. Consulta Claves de API.

Las claves publicables pk_live_ pertenecen a los Widgets web, porque son credenciales de navegador restringidas por origen en lugar de claves de servidor.

Alertas#

Crea reglas de métricas para tasa de éxito, tasa de fallos, puntuación promedio, volumen de llamadas o regresiones de suites. Una regla incluye:

• Comparador y umbral numérico.
• Ventana de evaluación de 1 a 720 horas.
• Hasta 10 destinatarios de correo electrónico.
• URL opcional de webhook entrante de Slack.
• Entrega opcional mediante webhook para desarrolladores.
• Periodo de espera en minutos enteros y estado habilitado.

La misma pestaña muestra las activaciones recientes. Consulta Alertas.

Configuración de facturación#

Administra el saldo y el comportamiento de pago de la organización:

• Agrega o reemplaza la tarjeta de pago predeterminada.
• Agrega fondos manualmente.
• Habilita la recarga automática y configura su umbral y monto de recarga.
• Configura o elimina un límite mensual de gasto.

El límite mensual pausa las llamadas nuevas y el uso al 100 %, y permanece activo incluso cuando la recarga automática está desactivada. Consulta Precios y Facturación y recargas.

Historial de facturación#

Usa Historial de facturación para revisar el saldo y el gasto de hoy, 7 días, 30 días, 90 días o todo el período. Incluye:

• Tendencia del saldo.
• Distribución de facturación entre cargos por llamadas, informes, tarifas de números telefónicos y recargas.
• Mayor gasto por agente.
• Tabla de transacciones con fecha, categoría, descripción, tipo, importe y saldo resultante.
• Filtrado por categoría y exportación en CSV o JSON del historial mostrado.

El dashboard indica cuándo solo se muestran las transacciones más recientes; las filas anteriores que superen ese límite tampoco se incluyen en la exportación. La API de facturación admite paginación programática.