¿Qué puedo hacer con la API CRM de Telegram?
+
Listar y buscar chats de Telegram, leer el historial de mensajes, gestionar contactos y campos personalizados, crear y actualizar tickets con prioridad y asignado, disparar difusiones a segmentos etiquetados, agregar y quitar etiquetas, y actualizar valores de campos personalizados. Cada endpoint tiene alcance de espacio de trabajo y se registra en auditoría.
¿Qué permisos están disponibles?
+
workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Elige el mínimo que necesite tu integración - el mínimo privilegio limita el daño en caso de que una clave se filtre. Los mismos permisos se aplican a la API, el servidor MCP y la integración de Make.com.
Ejemplos concretos - ¿qué construyen los equipos reales?
+
Un equipo de trading sincroniza cada chat de Telegram en BigQuery cada hora para que los analistas puedan combinarlo con datos on-chain. Un equipo de soporte SaaS tiene un cron job que extrae los tickets sin resolver del día anterior y los envía a un resumen de Slack. Un equipo de crecimiento envía una difusión de Telegram desde un webhook cada vez que llega un evento de actualización de Stripe. Un equipo de operaciones construyó un panel de Retool que muestra el tiempo de respuesta por representante, el throughput de tickets y la distribución de etapas del pipeline - todo impulsado por la API de Entergram.
¿Cómo creo y gestiono claves API?
+
Ve a la pestaña de Desarrolladores en tu espacio de trabajo de Entergram. Haz clic en 'Crear clave', selecciona los permisos que necesitas, opcionalmente establece un TTL más corto y una lista de IP permitidas, y copia la clave. La clave sin procesar solo se muestra una vez - guárdala de forma segura. Las claves se hashean unidireccionalmente en reposo. Revoca cualquier clave inmediatamente desde la misma pestaña.
¿Cómo roto una clave filtrada?
+
Pestaña de Desarrolladores → encuentra la clave por su prefijo → Revocar (inmediato). Luego crea una nueva clave con los mismos permisos y lista de IP permitidas, despliégala en tu integración y verifica la información de último uso de la clave antigua para confirmar que no hay más tráfico.
¿Puede la API ver los datos de otro espacio de trabajo?
+
No. Cada llamada a la API tiene alcance del espacio de trabajo que emitió la clave. Una clave del espacio de trabajo A literalmente no puede leer el espacio de trabajo B - el alcance se aplica en el servidor en cada consulta.
¿Qué errores HTTP podría ver?
+
401 = la clave está vencida, revocada o es incorrecta para el espacio de trabajo. 403 = la clave carece del permiso necesario, o la solicitud provino de una IP fuera de la lista permitida. 429 = has alcanzado un límite de tasa; espera y reintenta con el encabezado Retry-After.
¿Cuál es la diferencia entre la API y el servidor MCP?
+
Ambos acceden a los mismos datos del espacio de trabajo con los mismos permisos. La API es para tu código - cron jobs, webhooks, herramientas internas, pipelines de sincronización. El servidor MCP es para agentes de IA - Claude, ChatGPT, Cursor - que descubren y llaman herramientas automáticamente a través del Model Context Protocol. Usa la API cuando el código es el consumidor; usa el servidor MCP cuando lo es la IA.
¿La API soporta webhooks?
+
Los webhooks de salida están en la hoja de ruta. Hoy, el patrón es basado en extracción: llama a la API de forma programada o en respuesta a tus propios eventos. Para automatizaciones basadas en push ahora mismo, la app de Entergram para Make.com tiene disparadores de eventos del espacio de trabajo; consulta la lista actual dentro de Make antes de diseñar en torno a uno.
