Autenticación

Cómo crear tu clave de API sk_live_ y usarla para autenticar tus llamadas a la API de Atendy.

Autenticación (API)

La API de Atendy te permite lanzar llamadas salientes desde tus propias aplicaciones o desde herramientas de automatización como n8n. Para que Atendy sepa quién eres y a qué cuenta cargar las llamadas, cada petición debe ir firmada con una clave de API. En esta página verás cómo crear esa clave y cómo enviarla en tus peticiones.

La API pública está disponible en el plan Escala. Con un plan inferior no podrás ni crear la clave ni usar la API: ambas cosas responden con un error de plan insuficiente.

Crear tu clave de API

Las claves de API se crean y se gestionan desde la sección Llamadas salientes del panel. Cada clave empieza por sk_live_ y va asociada a tu cuenta: todas las llamadas que lances con ella se facturan a quien es dueño de la clave.

Entra en tu panel de Atendy y abre la sección Llamadas salientes.
Busca el apartado de claves de API y pulsa el botón para crear una clave nueva.
Ponle un nombre que te ayude a reconocerla más tarde (por ejemplo, el nombre de la aplicación o del flujo de n8n que la va a usar).
Copia la clave completa que aparece en pantalla y guárdala en un lugar seguro.
Cierra el aviso. A partir de ahí la clave ya está activa y lista para usarse.

La clave completa solo se muestra una vez, en el momento de crearla. Por seguridad, Atendy no vuelve a enseñarla nunca. Cópiala y guárdala en un gestor de contraseñas o en las variables secretas de tu aplicación. Si la pierdes, tendrás que revocarla y crear una nueva. No la compartas ni la publiques: cualquiera que tenga tu clave puede lanzar llamadas en tu nombre y a tu cuenta.

Cómo autenticar tus peticiones

Para autenticarte, envía tu clave en la cabecera HTTP x-api-key de cada petición. No hace falta ningún otro paso de inicio de sesión ni token adicional. Si la cabecera falta o la clave no es válida, la petición se rechaza.

curl -X POST https://atendy.es/api/v1/calls \
  -H "x-api-key: sk_live_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "00000000-0000-0000-0000-000000000000",
    "to": "+34600000000",
    "vars": { "nombre": "Ana" }
  }'

Si la autenticación es correcta y tu plan lo permite, la API responde con un código 200 y los datos de la llamada que acaba de iniciarse.

Errores de autenticación

Código	Significado	Qué hacer
401	Clave inválida o cabecera x-api-key ausente.	Revisa que envías la cabecera x-api-key y que la clave está completa y no se ha revocado.
403	Plan insuficiente para usar la API pública.	La API requiere el plan Escala. Actualiza tu plan para poder lanzar llamadas por API.
429	Se ha superado el límite de ritmo de peticiones.	Espera unos segundos y reintenta, o reduce la frecuencia con la que lanzas llamadas.

Puedes crear varias claves con nombres distintos, una por cada aplicación o integración. Así, si alguna se ve comprometida, la revocas sin afectar al resto.