Autenticación y tokens
Cómo se envía el token, permisos, caducidad y buenas prácticas.
Cada petición lleva tu token en la cabecera Authorization:
text
Authorization: Bearer ack_live_...Permisos
| Permiso | Qué permite |
|---|---|
| contacts:read | Ver contactos y las opciones del CRM. |
| contacts:write | Lo anterior y, además, crear y actualizar contactos. |
«Token actual y saldo» y «Listar clientes» funcionan con cualquier token.
Limitar a un cliente
Si el token va a estar en una herramienta de un cliente, limítalo a ese cliente al crearlo. Así, aunque alguien lo copie, no llega a los datos de tus otros clientes.
Caducidad
Puedes elegir 30 días, 90 días, 1 año, una fecha concreta o sin caducidad. Un token sin caducidad funciona hasta que lo revoques.
Buenas prácticas
- Crea un token para cada herramienta o uso. Si tienes que revocar uno, los demás siguen funcionando.
- Guárdalo en las credenciales de la herramienta o en un gestor de contraseñas, nunca en el código ni en un documento compartido.
- Si crees que se ha filtrado, revócalo en Ajustes › API: deja de funcionar al momento.
- Cada vez que se crea un token en tu cuenta te llega un email de aviso.
URL base: https://agentclic.com/api/public/pro/v1