ServiceM8 | ElevenLabs Documentation

Con las herramientas de webhook 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 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.

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.