> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty Tu recepcionista puede reconocer a quienes llaman y ya están en Twenty, y añadir a nuevos llamantes como personas con su nombre, número de teléfono y el motivo de su llamada, para que tu equipo de ventas pueda hacer seguimiento. Reception se conecta al [servidor MCP](/docs/es/reception-ai/integrations/mcp-server) integrado de Twenty, que funciona tanto con Twenty Cloud como con Twenty autohospedado. También puedes crear [herramientas de webhook](/docs/es/reception-ai/integrations/webhooks) para la API REST de Twenty, pero el servidor MCP requiere menos configuración: ofrece a tu recepcionista herramientas listas para buscar y añadir personas, ya adaptadas a los campos de tu espacio de trabajo, incluido el campo de motivo de llamada que se indica a continuación. ## Configuración ### Añade un campo para el motivo de la llamada Las personas en Twenty no tienen un campo de notas propio. Para guardar en su registro el motivo de la llamada, ve a **Configuración** → **Modelo de datos**, abre **Personas** y añade un campo de **Texto** llamado `Call reason`. Solo los administradores del espacio de trabajo pueden modificar el modelo de datos. ### Crea un rol para Reception.ai Ve a **Configuración** → **Miembros** → **Roles** y crea un rol que solo pueda leer y crear personas. En el siguiente paso le asignarás la clave de API. ### Crea una clave de API Ve a **Configuración** → **Desarrolladores** → **API** y selecciona **+ Crear clave**. Ponle un nombre, por ejemplo, `Reception.ai`, y cópiala de inmediato: Twenty solo la muestra una vez. Después, abre el rol que creaste, ve a la pestaña **Asignación** y asígnale la clave. > **Warning** > > La clave de API puede leer y modificar todo lo que permita su rol. No la incluyas en documentos compartidos y > elimínala en Twenty si se filtra. ### Añade el servidor MCP En Reception.ai, ve a **Integraciones**, selecciona **Añadir integración** y elige **Servidor MCP**. | Campo | Valor | | -------------------- | -------------------------------------------------------------------------------------- | | **Nombre** | Twenty | | **Tipo de servidor** | HTTP transmisible | | **URL del servidor** | La dirección de tu espacio de trabajo seguida de `/mcp`, como se indica a continuación | | **Token secreto** | Tu clave de API | | Dónde se ejecuta Twenty | URL del servidor | | ----------------------- | ------------------------------------------------------------------------------- | | Twenty Cloud | La URL de tu espacio de trabajo, por ejemplo `https://mycompany.twenty.com/mcp` | | Autohospedado | La URL pública de tu instancia, por ejemplo `https://crm.example.com/mcp` | Puedes copiar la dirección exacta desde **Configuración** → **IA** → **MCP** en Twenty. No añadas `?mode=meta` a la URL: ese modo proporciona a tu recepcionista una única herramienta que puede ejecutar cualquier acción. Selecciona **Activar**. Reception.ai envía la clave como token bearer y muestra las herramientas de Twenty. ### Asigna herramientas Twenty muestra una herramienta para cada acción de cada objeto. Abre la pestaña **Herramientas** y asigna solo estas al **Cliente** (recepcionista): * `find_many_people`: busca al llamante por número de teléfono. * `create_one_person`: añade a un nuevo llamante con su nombre, número de teléfono y motivo de llamada. Deja sin asignar las herramientas de actualización y eliminación, así como las herramientas para otros objetos. ### Añade un procedimiento Añade un [procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) para nuevos leads: primero busca al llamante por número de teléfono, crea una persona solo cuando no se encuentre ninguna coincidencia y rellena siempre el nombre, apellidos, número de teléfono y motivo de llamada. Añade una regla para que tu recepcionista nunca lea registros del CRM a quienes llaman. ### Pruébalo [Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) llamando desde un número guardado en una persona de Twenty y, después, como un nuevo llamante que quiere un presupuesto. La nueva persona aparecerá en **Personas** con el motivo de llamada rellenado. ## Limitaciones * Twenty guarda el prefijo internacional por separado del resto del número. Es posible que no se encuentren llamantes guardados sin prefijo internacional o con otro formato, por lo que un llamante recurrente puede añadirse dos veces. * Con esta configuración, tu recepcionista no crea notas, tareas ni oportunidades. Tu equipo gestiona las nuevas personas desde la lista **Personas**, por ejemplo, con una vista filtrada por **Motivo de la llamada**. * Las instancias autohospedadas necesitan una versión de Twenty que incluya el servidor MCP, y la URL pública debe ser accesible desde internet mediante HTTPS. * La API de Twenty permite 100 solicitudes por minuto. Los espacios de trabajo con mucha actividad y otras integraciones pueden alcanzar el límite. ## Solución de problemas | Problema | Qué comprobar | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | No aparece ninguna herramienta | Usa el tipo de servidor **HTTP transmisible** y comprueba que la URL termine en `/mcp`. En instalaciones autohospedadas, el ajuste `SERVER_URL` debe ser tu URL pública. | | Una herramienta devuelve un error de permisos | El rol de la clave no puede leer ni crear personas. Edita el rol en **Configuración** → **Miembros** → **Roles**. | | No se encuentran llamantes conocidos | Guarda los números de teléfono con su prefijo internacional y en un único formato. | | El motivo de llamada está vacío | Selecciona **Actualizar herramientas** después de añadir el campo `Call reason` y, a continuación, selecciona **Actualizar** en la herramienta modificada. | | Has cambiado la clave | Edita la integración y usa **Rotar token secreto (opcional)**. La clave guardada no volverá a mostrarse. |