Qué hace
- contacts:write: crear contactos y leads.
- messages:write: añadir mensajes y notas a las conversaciones.
- conversations:read: consultar conversaciones.
- webhooks:write: registrar disparadores (REST hooks para Zapier y Make).
Qué necesitas
- Un espacio de trabajo en el que seas propietario o administrador.
- Un desarrollador, o una herramienta como Zapier o Make que pueda hacer peticiones HTTP.
Crear una clave
Paso 1: Abre Claves API
Ve a "Integraciones" y pulsa "Configurar" en la tarjeta "Claves API (acciones)".
Paso 2: Ponle nombre y elige los permisos
Escribe para qué es la clave (por ejemplo, Zapier) y marca solo los permisos que necesitas. Pulsa "Crear clave".
Paso 3: Guarda la clave
La clave (empieza por twk_) se muestra una sola vez. Cópiala en tu gestor de contraseñas o en tu herramienta y pulsa "He guardado la clave".
Reglas y ajustes
- Da a cada herramienta su propia clave, así puedes revocar una sin afectar a las demás.
- "Revocar" hace que una clave deje de funcionar al instante.
- "Acciones disponibles (REST API)" en el asistente enumera los endpoints (contactos, conversaciones, mensajes y notas); la referencia completa está en twilper.com/integrations/api.
- Como máximo 20 claves activas y 120 peticiones por minuto por espacio de trabajo.
Pruebas
- En "Prueba rápida" el asistente muestra un comando curl listo para usar: GET https://api.twilper.com/api/v1/me con la cabecera Authorization: Bearer twk_…
- Una respuesta 200 significa que la clave funciona.
Problemas frecuentes
- 401: la clave es incorrecta o está revocada.
- 403: la clave no tiene permiso para esta acción. Crea una clave nueva con el permiso correcto.
- Clave perdida: no se puede volver a mostrar. Revócala y crea una nueva.
Conviene saber
- Nunca pongas claves en el código fuente de tu web: cualquiera puede leerlo.