Skip to main content
La clave API es su tarjeta de acceso: cada alcance abre una puerta. En producción, conceda solo lo que su integración necesita.

​
En breve

  • Los alcances telegram:* cubren instancias, envío, lectura y edición.
  • instanceIds restringe qué conexiones puede utilizar la clave.
  • Guía general: Claves API. Conexión: Inicio rápido.

​
Cómo enviar la clave

Alternativa: x-api-key: sk_live_xxxxx.
Alcances vacíos al crear = acceso ADMIN (todo). En producción, restrinja siempre.

​
Combinaciones listas

Bot básico

telegram:instances:create, telegram:instances:list, telegram:send

Enviar y consultar

telegram:send, telegram:read

Con cancelación

telegram:send, telegram:cancel

Flujo completo

telegram:send, telegram:read, telegram:cancel, telegram:update, telegram:delete

​
Alcances disponibles

Listar conexiones, ver detalles y QR (modo USER).
Crear bot con token o iniciar cuenta USER (QR o sesión).
Eliminar conexión.
Enviar texto, medios vía URL HTTPS y ubicación (modo bot).
Historial de enviados, lista de chats e inbound.
Cancelar mensaje en cola o programado.
Editar texto enviado.
Eliminar mensaje en el chat.

​
Restringir por conexión (instanceIds)

Además del alcance (el qué), instanceIds define dónde:

​
Errores comunes

Catálogo completo: Respuestas de error.

​
Próximos pasos