Bot Telegram para empresas: casos de uso, costos y una configuración PHP segura

Cuando los propietarios escuchan " Telegram bot", a menudo se imaginan un juguete de consumo. En la práctica, un bot es una pieza de software muy pequeña que conecta sus sistemas a una aplicación de chat que su equipo ya tiene en sus teléfonos. Puede indicarle el momento en que llega un pedido grande, pedirle a un gerente que apruebe un reembolso con un solo toque o responder preguntas comunes de los clientes. Los construimos como parte de nuestro trabajo de integración y así es como lo pensamos.

Dónde encaja Telegram para una empresa estadounidense

Sea realista acerca de su audiencia. En Estados Unidos, los clientes utilizan principalmente SMS, iMessage, WhatsApp, correo electrónico y chat web, y los equipos utilizan Slack o Microsoft Teams. Telegram tiene cientos de millones de usuarios, concentrados en Europa, Asia, Medio Oriente y América Latina. Eso le da dos roles claros:

• Operaciones internas. Es simple, rápido en dispositivos móviles y tiene una API de bot gratuita y bien documentada. Muchos equipos pequeños lo utilizan para alertas y aprobaciones porque la configuración lleva horas, no semanas.
• Clientes y comunidades internacionales. Si vende o brinda soporte a clientes en mercados donde Telegram es el valor predeterminado, un bot los encontrará donde estén. Las comunidades de productos, los canales de anuncios y los grupos de soporte son ejemplos comunes.

Si sus clientes son en su mayoría consumidores estadounidenses, comience con chat web o SMS para ellos y mantenga Telegram para su equipo. La misma lógica de automatización funciona para ambos.

Casos de uso que se amortizan rápidamente

• Alertas de pago e ingresos: "Nuevo pedido, $1240, cliente X" en un chat de equipo, además de avisos de reembolso y pago fallido. Conéctelo a sus webhooks de pago, como se describe en nuestra guía de webhooks Stripe.
• Alertas de error y tiempo de actividad: un mensaje cuando falla una copia de seguridad, una verificación de estado se vuelve roja o los errores aumentan. Consulte nuestra guía de respaldo y monitoreo para saber qué mirar.
• Aprobaciones con un solo toque: reembolso por encima de un límite, solicitud de descuento, contenido listo para publicar. El administrador toca Aprobar o Rechazar en el chat y su sistema actúa en consecuencia.
• Notificaciones de nuevos clientes potenciales: llega un envío de formulario al chat de ventas con los detalles y un botón para reclamarlo. Un primer contacto más rápido suele mejorar la conversión.
• Resumen diario: breve resumen matutino de ventas, altas, entradas e incidencias.
• Clasificación de soporte y preguntas frecuentes: un bot responde preguntas comunes y pasa el resto a un humano. Si desea respuestas de IA a partir de sus propios documentos, lea nuestra guía de chatbot de IA para conocer costos, retorno de la inversión y salvaguardas.

lo que cuesta

La Telegram Bot API no cobra por mensaje para un uso normal. Los costos reales son:

• Desarrollo: un bot de alerta simple requiere unas pocas horas de trabajo, un flujo de trabajo de aprobación o un bot de soporte lleva días y un bot con integración de IA y CRM lleva más tiempo.
• Hosting: un servidor pequeño es suficiente. Un bot está mayoritariamente inactivo.
• Servicios de terceros: uso del modelo de IA, un CRM, un proveedor de SMS como respaldo. Estos dependen del volumen.
• Mantenimiento: seguimiento, actualizaciones y cambios del Bot API. Pequeño, pero no cero.

Para justificarlo, calcule el tiempo ahorrado: minutos por alerta o aprobación multiplicados por el volumen, más el valor de una respuesta más rápida. Muchos equipos ven la recuperación en el primer mes porque las alternativas son revisar los paneles manualmente o perder respuestas lentas.

Configuración: de BotFather a un webhook que funcione

1. Crea el robot. En Telegram, habla con BotFather, crea un bot y copia el token. El token es una contraseña: guárdalo como un secreto en tu servidor, nunca en código o en Git.
2. Cree un chat de equipo o un grupo, agregue el bot y busque el ID del chat en la primera actualización que recibe el bot.
3. Elige un modo. Las encuestas largas son las más fáciles de desarrollar. Para producción, utilice un webhook: Telegram llama a su URL HTTPS para cada actualización.
4. Registre el webhook con un token secreto para que pueda rechazar a cualquier otra persona que encuentre la URL:

curl -sS "https://api.telegram.org/bot$TG_BOT_TOKEN/setWebhook" \
  -d "url=https://example.com/telegram-webhook.php" \
  -d "secret_token=$TG_WEBHOOK_SECRET" \
  -d 'allowed_updates=["message","callback_query"]' \
  -d "drop_pending_updates=true"

Una implementación PHP pequeña y segura

Primero, un ayudante para llamar a la API con un tiempo de espera y un reintento cuando Telegram dice "reducir la velocidad" (HTTP 429):

<?php
function tg(string $method, array $params, int $tries = 3): array {
    $url = 'https://api.telegram.org/bot' . getenv('TG_BOT_TOKEN') . '/' . $method;
    for ($i = 1; $i <= $tries; $i++) {
        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => json_encode($params),
            CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 10,
        ]);
        $raw  = curl_exec($ch);
        $code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        curl_close($ch);
        $res = is_string($raw) ? (json_decode($raw, true) ?: []) : [];
        if ($code === 429) { sleep((int)($res['parameters']['retry_after'] ?? 1)); continue; }
        if ($code >= 500 || $raw === false) { sleep($i); continue; }
        return $res;
    }
    return ['ok' => false];
}

Luego una alerta con botones de aprobación, por ejemplo cuando se solicita un reembolso por encima de su límite:

tg('sendMessage', [
    'chat_id'    => getenv('TG_OPS_CHAT_ID'),
    'parse_mode' => 'HTML',
    'text'       => 'Refund request <b>#' . $refundId . '</b>: $' . number_format($amount, 2) . "\nCustomer: " . htmlspecialchars($customerName),
    'reply_markup' => ['inline_keyboard' => [[
        ['text' => 'Approve', 'callback_data' => 'refund:ok:' . $refundId],
        ['text' => 'Reject',  'callback_data' => 'refund:no:' . $refundId],
    ]]],
]);

Y el receptor del webhook, que verifica el secreto, ignora los chats desconocidos, evita procesar la misma actualización dos veces y responde rápidamente:

<?php
// telegram-webhook.php
if (!hash_equals((string)getenv('TG_WEBHOOK_SECRET'), $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '')) {
    http_response_code(403); exit;
}

$update = json_decode(file_get_contents('php://input'), true);
if (!is_array($update) || !isset($update['update_id'])) { http_response_code(400); exit; }

// idempotency: Telegram may re-deliver an update
if (!claim_update((int)$update['update_id'])) { http_response_code(200); exit; }   // e.g. INSERT IGNORE into a table

$chatId  = $update['message']['chat']['id'] ?? $update['callback_query']['message']['chat']['id'] ?? null;
$allowed = array_map('intval', explode(',', (string)getenv('TG_ALLOWED_CHATS')));
if (!in_array((int)$chatId, $allowed, true)) { http_response_code(200); exit; }     // ignore strangers

if (isset($update['callback_query'])) {
    [$what, $decision, $id] = explode(':', $update['callback_query']['data']) + [null, null, null];
    if ($what === 'refund' && ctype_digit((string)$id)) {
        handle_refund_decision((int)$id, $decision === 'ok', $update['callback_query']['from']['id']);
        tg('answerCallbackQuery', ['callback_query_id' => $update['callback_query']['id'], 'text' => 'Recorded']);
    }
}
http_response_code(200);

Observe los principios: autenticar al remitente, autorizar el chat, validar la carga útil y hacer que el controlador sea idempotente. Los mismos principios se aplican a los webhooks de pago. Verifique también quién presionó el botón, porque cualquier persona en un grupo puede tocarlo a menos que restrinja quién puede aprobarlo.

Normas de seguridad y cumplimiento

• Mantenga el token en secreto y gírelo a través de BotFather si alguna vez se filtra.
• No envíes datos sensibles en los chats: contraseñas, claves API, números de tarjetas o datos de salud. Los chats de bots habituales no están cifrados de extremo a extremo como la gente supone, así que trátelos como si fueran correos electrónicos.
• Restringir por chat y por usuario. Sólo se deben aceptar aprobaciones de personas nombradas.
• Obtenga consentimiento para enviar mensajes a los clientes y proporcione una manera fácil de detenerlos. Siga las reglas de privacidad que se aplican a sus clientes, como GDPR para usuarios en Europa, y describa el bot en su política de privacidad.
• Registrar acciones: quién aprobó qué y cuándo.
• Revisa los controles en nuestra lista de verificación de seguridad PHP, ya que el bot es un punto de entrada más a tus sistemas.

Fiabilidad: límites de velocidad y reintentos

Telegram limita la velocidad a la que un bot puede enviar: aproximadamente un mensaje por segundo para un solo chat, una velocidad más baja en grupos y unos treinta mensajes por segundo en total para transmisiones. Para algo más grande que un chat de equipo, coloque los mensajes en una cola y envíelos a un ritmo controlado. Maneje siempre la respuesta 429 y su valor retry_after, responda a los webhooks en uno o dos segundos y realice un trabajo lento en segundo plano, y supervise las fallas de entrega para que note un bot roto como lo haría con cualquier otro servicio.

Un plan de implementación sensato

1. Semana 1: bot de alertas de pagos y errores en un chat interno.
2. Semana 2: agregue notificaciones de clientes potenciales y un resumen diario.
3. Semana 3-4: agregue aprobaciones con botones y un registro de auditoría.
4. Más tarde: atención al cliente o respuestas de IA en las que su audiencia utiliza Telegram, medidas en función del tiempo de respuesta y el volumen de tickets.

¿Cómo podemos ayudar?

Diseñamos y construimos automatizaciones Telegram, chat web y mensajería para empresas, con las integraciones detrás: pagos, CRM, correo electrónico e IA. Lea acerca de nuestro servicio de integraciones o reserve una breve llamada y díganos qué proceso desea automatizar primero.