# Números de teléfono

Vincula el número SIP del cliente a un asistente para las llamadas de voz entrantes

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Añade un número de teléfono SIP, vincúlalo a un asistente y el agente de voz de IA responderá las llamadas entrantes.

<VoiceSetupDemo />

## Conectar un teléfono [#connect-a-phone]

1. Obtén las credenciales SIP de un [proveedor compatible](/docs/integrations/telephony): número de teléfono, usuario SIP, contraseña SIP, URL de telefonía.
2. **Teléfonos** > **Añadir teléfono**, rellena los campos de abajo, **Guardar**.
3. Vincúlalo: selecciona un **Agente** en la configuración del teléfono (un teléfono → un agente), **Guardar**.
4. Añade la integración del proveedor de telefonía: **Integraciones** > **Añadir integración** > elige el proveedor, introduce las credenciales, actívala.
5. Configura los ajustes de voz del asistente y luego llama al número para probar el saludo y una herramienta.

## Campos del teléfono [#phone-fields]

| Campo              | Valor                                          |
| ------------------ | ---------------------------------------------- |
| Número de teléfono | Número de teléfono SIP (p. ej., +380501234567) |
| Usuario SIP        | Nombre de usuario de autenticación             |
| Contraseña SIP     | Contraseña de autenticación                    |
| URL del proveedor  | Dirección del servidor SIP                     |
| Códec              | A-law (por defecto) o μ-law                    |
| Comentario         | Etiqueta opcional                              |

## Ajustes de voz (en el asistente) [#voice-settings-on-assistant]

| Ajuste                 | Valor                                                    |
| ---------------------- | -------------------------------------------------------- |
| Voz                    | 30 voces integradas o ElevenLabs                         |
| Formato de audio       | Formato de entrada/salida (por defecto PCM 8000)         |
| Eagerness              | Eager, Normal o Patient                                  |
| Turno tras silencio    | Segundos antes de que hable el asistente (por defecto 7) |
| Tiempo de espera suave | Espera máxima a la respuesta del usuario; -1 = ilimitado |

Consulta [Agentes > Ajustes de voz](/docs/agents).

## API [#api]

```bash
POST /api/phones
X-Access-Token: happ_your_token_here
Content-Type: application/json

{
  "phoneNumber": "+380501234567",
  "sipLogin": "your-sip-login",
  "password": "your-sip-password",
  "telephonyUrl": "sip.provider.com",
  "codec": "alaw",
  "comment": "Main office line"
}
```

Vincúlalo a un asistente con `PATCH /api/phones/{phoneId}` (`{ "assistantId": "..." }`). Lista con `GET /api/phones`, actualiza con `PATCH`, elimina con `DELETE /api/phones/{phoneId}`.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Solución de problemas [#troubleshooting]

| Problema           | Solución                                                           |
| ------------------ | ------------------------------------------------------------------ |
| Sin audio          | Verifica las credenciales SIP y la URL del proveedor               |
| Audio entrecortado | Revisa la red; prueba el otro códec (alaw o ulaw)                  |
| Respuestas lentas  | Pon eagerness en Eager                                             |
| Sin conexión       | Verifica que la integración del proveedor de telefonía esté activa |
| Voz incorrecta     | Revisa el ajuste de voz en la configuración del asistente          |

## Siguiente [#next]

* [Proveedores de telefonía](/docs/integrations/telephony): lista de proveedores
* [Asistente de voz](/docs/agents/voice): visión general