API
API de devyCRM: crear claves de acceso (API Keys) para conectar otros sistemas con tus contactos, tickets y tareas, y dónde está la documentación técnica.
La API permite que otro sistema —tu web, un formulario, una herramienta de automatización— lea o cargue datos en devyCRM: por ejemplo, crear un contacto cada vez que alguien completa un formulario de tu página.
Para usarla necesitás una API Key: una clave que identifica al sistema que se conecta. La documentación técnica para quien programa la integración está en Cuenta → API Keys, debajo de tus claves.
Crear una API Key#
Abrí el formulario#
En Cuenta → API Keys, tocá Nueva API Key. Arriba te dice contra qué empresa va a consultar la clave.
Completá los datos#
- Nombre: para reconocerla, por ejemplo Formulario de la web.
- Permisos:
- Solo lectura: consulta contactos, tickets, tareas y su historial. No modifica nada.
- Lectura y escritura: además crea y actualiza contactos, tickets y tareas.
- Asistente de IA: tildalo sólo si la clave es para conectar un asistente de IA.
- Expiración: cuándo deja de funcionar sola, o Sin expiración.
Guardala#
Tocá Crear API Key y copiá la clave. Pasásela a quien hace la integración por un medio seguro.
Una API Key nueva: nombre, permisos y vencimiento.
Una API Key da acceso a los datos de tu empresa. Dale a cada sistema su propia clave, con el menor permiso que necesite, y no la publiques en páginas web ni la mandes por chats abiertos.
Administrar las claves#
La lista muestra tus claves con sus permisos, su estado y la fecha de su último uso. En cada una podés:
- Ver la clave completa,
- Desactivar y volver a Activar,
- Revocar: deja de funcionar al instante y no se puede reactivar.
Cada usuario ve las claves que creó.
Para quien programa la integración#
En Cuenta → API Keys, debajo de tus claves, está la referencia completa: la dirección de la API, cómo enviar la clave, los datos que se pueden consultar y cargar, ejemplos y los códigos de error.
Consideraciones importantes#
- Cada clave consulta una sola empresa: la que estabas viendo cuando la creaste.
- Cada clave puede hacer hasta 1.000 consultas por hora.
- Usar la API no consume créditos.