Documentación

Inicio rápido de EasyTgAPI: claves, instancias, mensajes y webhooks.

Inicio rápido

  1. Crea una cuenta y genera una clave API en el panel.
  2. Crea una instancia: cuenta Personal o bot de Telegram.
  3. Autoriza la instancia: QR/teléfono para Personal o token de BotFather para bots.
  4. Envía el primer mensaje mediante el REST API.

Referencia del API

Recursos principales:

MétodoEndpointDescripción
GET/api/v1/instancesListar instancias
POST/api/v1/instancesCrear instancia
GET/api/v1/instances/{id}Detalle de instancia
DELETE/api/v1/instances/{id}Eliminar instancia
POST/api/v1/instances/{id}/messagesEnviar mensaje
POST/api/v1/instances/{id}/messages/batchEnvío masivo
POST/api/v1/instances/{id}/messages/mediaEnviar multimedia
GET/api/v1/instances/{id}/chatsListar chats
GET/api/v1/instances/{id}/chats/{chat_id}/historyHistorial del chat
GET/api/v1/instances/{id}/contactsListar contactos
POST/api/v1/instances/{id}/groupsCrear grupo
POST/api/v1/webhooksCrear webhook
GET/api/v1/webhooksListar webhooks
DELETE/api/v1/webhooks/{id}Eliminar webhook

Parámetros de mensaje

ParámetroTipoObligatorioDescripción
chat_idintegerSíID del chat
textstringSíTexto del mensaje

Códigos de error

CódigoDescripción
200Éxito
400Petición incorrecta (revisa los parámetros)
401No autorizado (clave API inválida o ausente)
403Acceso denegado (permisos insuficientes)
404Instancia o recurso no encontrado
429Límite de peticiones excedido
500Error interno del servidor

Límites de peticiones

El límite por defecto es 120 peticiones por minuto. Un plan puede fijar otro límite. Al superarlo se responde 429.

Autenticación

Envía la clave en X-Api-Key o Authorization: Bearer. También existe compatibilidad con clave en la URL.

Webhooks

Los eventos se entregan a tu URL con firma HMAC, reintentos y registro de entregas. Una instancia puede enviar eventos a varios sistemas.

Soporte

Para preguntas de integración, contáctanos en Telegram: @easytgapi.