> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ServiceM8

Con las [herramientas de webhook](/docs/es/reception-ai/integrations/webhooks) siguientes, tu recepcionista puede crear un presupuesto o trabajo en ServiceM8 cuando alguien llama porque necesita un servicio, y añadir a quienes llaman por primera vez como clientes.

## Antes de empezar

En ServiceM8, abre **Configuración** → **Claves de API** y crea una clave. Todas las herramientas siguientes la envían en la cabecera de solicitud `X-Api-Key`. Cualquiera que tenga la clave puede leer y modificar tus datos de ServiceM8, así que no la incluyas en documentos compartidos.

## Crea las herramientas

Para cada herramienta, ve a **Integraciones**, selecciona **Añadir integración**, elige **Herramienta de webhook** y configura **Asignar a agentes** como **Recepcionista**.

### Crea un trabajo

| Campo                      | Valor                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nombre**                 | `create_servicem8_job`                                                                                                                                                                                                                                                                                                                                                   |
| **Descripción**            | "Crea un trabajo cuando alguien llama porque necesita un servicio o quiere un presupuesto."                                                                                                                                                                                                                                                                              |
| **Método**                 | POST                                                                                                                                                                                                                                                                                                                                                                     |
| **URL**                    | `https://api.servicem8.com/api_1.0/job.json`                                                                                                                                                                                                                                                                                                                             |
| **Cabeceras de solicitud** | `X-Api-Key`: tu clave de API                                                                                                                                                                                                                                                                                                                                             |
| **Parámetros del cuerpo**  | `status` (cadena, obligatorio): "Siempre el valor exacto `Quote`."  `job_address` (cadena, obligatorio): "La dirección completa donde se necesita el servicio, incluido el código postal."  `job_description` (cadena, obligatorio): "El nombre y número de teléfono de quien llama, seguido de lo que necesita que se haga y cualquier detalle que haya proporcionado." |

Usa `Work Order` en lugar de `Quote` si las llamadas deben pasar directamente a trabajos programados.

### Añade un cliente nuevo

| Campo                      | Valor                                                                                                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nombre**                 | `create_servicem8_client`                                                                                                                                                |
| **Descripción**            | "Añade a quien llama como cliente nuevo cuando diga que no nos ha utilizado antes."                                                                                      |
| **Método**                 | POST                                                                                                                                                                     |
| **URL**                    | `https://api.servicem8.com/api_1.0/company.json`                                                                                                                         |
| **Cabeceras de solicitud** | `X-Api-Key`: tu clave de API                                                                                                                                             |
| **Parámetros del cuerpo**  | `name` (cadena, obligatorio): "El nombre completo de quien llama o el nombre de su empresa."  `address` (cadena): "La dirección del cliente, incluido el código postal." |

Selecciona **Activar** en cada herramienta y, después, [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) solicitando un presupuesto. El nuevo presupuesto aparecerá en ServiceM8.

## Limitaciones

* ServiceM8 responde a ambas herramientas únicamente con `OK`. El ID del nuevo registro está en una cabecera de respuesta que tu recepcionista no puede leer, por lo que no puede vincular el trabajo al cliente. Tu equipo los vincula en ServiceM8.
* ServiceM8 guarda los números de teléfono y los correos electrónicos en los contactos de un cliente, un registro independiente que la herramienta de clientes no puede crear. En su lugar, la descripción del trabajo incluye el número de quien llama.
* Buscar un cliente existente requiere un parámetro `$filter`, y los nombres de parámetros de las herramientas de webhook no pueden contener `$`, por lo que tu recepcionista no puede buscar a quienes llaman.

Para crear clientes y trabajos vinculados, usa las acciones **Crear cliente** y **Crear trabajo** de ServiceM8 a través de [Zapier](/docs/es/reception-ai/integrations/zapier).

## Solución de problemas

| Problema                      | Qué comprobar                                                                                                     |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 401 de ServiceM8              | La cabecera debe llamarse `X-Api-Key` y contener una clave vigente.                                               |
| 400 relacionado con el estado | `status` debe ser exactamente `Quote`, `Work Order`, `Unsuccessful` o `Completed`.                                |
| El trabajo no tiene dirección | Haz que la descripción indique a tu recepcionista que debe pedir la dirección completa antes de crear el trabajo. |
| 429 de ServiceM8              | Has alcanzado el límite de solicitudes de ServiceM8. Espera un minuto e inténtalo de nuevo.                       |