Saltar a la navegación

Twenty

Reconoce a quienes llaman y añade nuevos leads a Twenty CRM mediante su servidor MCP.

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 integrado de Twenty, que funciona tanto con Twenty Cloud como con Twenty autohospedado. También puedes crear herramientas de webhook 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

1

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.

2

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.

3

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.

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.

4

Añade el servidor MCP

En Reception.ai, ve a Integraciones, selecciona Añadir integración y elige Servidor MCP.

CampoValor
NombreTwenty
Tipo de servidorHTTP transmisible
URL del servidorLa dirección de tu espacio de trabajo seguida de /mcp, como se indica a continuación
Token secretoTu clave de API
Dónde se ejecuta TwentyURL del servidor
Twenty CloudLa URL de tu espacio de trabajo, por ejemplo https://mycompany.twenty.com/mcp
AutohospedadoLa 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.

5

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.

6

Añade un procedimiento

Añade un procedimiento 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.

7

Pruébalo

Prueba tu recepcionista 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

ProblemaQué comprobar
No aparece ninguna herramientaUsa 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 permisosEl rol de la clave no puede leer ni crear personas. Edita el rol en Configuración → Miembros → Roles.
No se encuentran llamantes conocidosGuarda los números de teléfono con su prefijo internacional y en un único formato.
El motivo de llamada está vacíoSelecciona Actualizar herramientas después de añadir el campo Call reason y, a continuación, selecciona Actualizar en la herramienta modificada.
Has cambiado la claveEdita la integración y usa Rotar token secreto (opcional). La clave guardada no volverá a mostrarse.