# Solución de problemas

Qué revisar cuando no funcionan las ventanas emergentes, el registro de llamadas, el botón Llamar, las grabaciones o los mensajes.

> [!TIP]
> Revisa primero la [licencia](https://docs.sapiensandmachines.com/es/espocrm-voip/licencia-y-prueba): sin una licencia activa, el envío de mensajes, el botón Llamar,
> el teléfono del navegador y las ventanas emergentes se desactivan (las llamadas y los mensajes entrantes se siguen
> guardando).

Los mensajes de error del servidor aparecen en inglés; abajo se indica qué significan.

## No aparece ninguna ventana ni la lista de llamadas

- Tu Usuario necesita un **SIP Username** (Twilio) o una **Extensión 3CX** (3CX).
- Con 3CX, la ventana al sonar necesita el cliente de API de 3CX con tu extensión en Call Control
  ([Conectar 3CX](https://docs.sapiensandmachines.com/es/espocrm-voip/conectar-3cx#grabaciones-y-ventana-emergente-opcional)).

## Twilio

En la consola de Twilio, abre **Monitor → Logs → Errors**:

- Un **403** del CRM significa que no se aceptó la petición: *Bad Twilio signature* (el Auth Token en EspoCRM o la
  dirección en Twilio no coinciden; usa exactamente las direcciones `https://` de [Conectar Twilio](https://docs.sapiensandmachines.com/es/espocrm-voip/conectar-twilio))
  o *Twilio integration is not enabled* (la integración no está activada).
- El softphone muestra **403 Forbidden**: activa *SIP Registration* en el dominio SIP de Twilio.
- En un móvil las llamadas van directo al buzón de voz: la app del softphone estaba dormida; usa una con
  notificaciones push.

## 3CX

- **TEST** en 3CX dice "not found": abre **Administración → S+M EspoCRM VOIP → Prueba de búsqueda 3CX**. Muestra si
  3CX está activado, cómo se leyó el número, qué registro coincide y las últimas peticiones de 3CX con su resultado
  (*refused: 3CX not enabled in EspoCRM*, *no secret sent*, *wrong secret*).
- *Bad 3CX secret*: descarga de nuevo la plantilla y súbela a 3CX.
- No hay grabaciones: falta el cliente de API de 3CX o su rol no es **Owner**; usa **Test the 3CX API** en la página
  de prueba.

## El botón Llamar

| Mensaje | Qué hacer |
|---|---|
| *Your user has no valid SIP Username.* | Un administrador lo completa en tu Usuario. |
| *The Call button is not set up* | Completa **Dominio SIP** e **Identificador de llamada** en la configuración de Twilio. |
| *That number is not on this record.* | Usa un número guardado en el registro. |
| *Twilio could not place the call: …* | Revisa el registro de errores de Twilio. |

## Mensajes

| Mensaje | Qué hacer |
|---|---|
| *Texting is not set up* | Conecta Twilio y agrega un Número de Twilio. |
| *You may not send texts from this number* | Un administrador te agrega al número en **Números de Twilio**. |
| *This number replied STOP* | Se dio de baja; primero debe escribir START. |
| *Text is too long (max 1600 characters).* | Acórtalo. |
| *Picture is too large (max 5 MB).* / *Only JPEG, PNG or GIF pictures can be texted.* | Usa un JPEG, PNG o GIF más pequeño. |

Los mensajes que no se pudieron enviar y las imágenes que no se pudieron copiar también quedan en el registro de
EspoCRM, empezando por "S+M EspoCRM VOIP:".

## Grabaciones

*No recording.* o *Recording not available.*: la llamada no se grabó, o Twilio o 3CX ya no la conservan.
