Hosting: Supabase Edge Functions

Esta guía te explica cómo puedes alojar tus bots de grammY en Supabase.

Ten en cuenta que necesitas tener una cuenta de GitHub antes de poder utilizar Supabase Edge Functions. Además, Supabase Edge Functions se basa en Deno Deploy, así que al igual que nuestra guía de Deno Deploy, esta guía es sólo para usuarios de Deno de grammY.

Supabase Edge Functions es ideal para la mayoría de los bots simples, y debes tener en cuenta que no todas las características de Deno están disponibles para las aplicaciones que se ejecutan en Supabase Edge Functions. Por ejemplo, no hay sistema de archivos en Supabase Edge Functions. Es igual que las otras plataformas sin servidor, pero dedicado a las aplicaciones de Deno.

El resultado de este tutorial se puede ver en nuestro repositorio de bots de ejemplo.

Configuración

Para desplegar una función de borde de Supabase, necesitarás crear una cuenta de Supabase, instalar su CLI, y crear un proyecto de Supabase. Primero debes seguir su documentación para configurar las cosas.

Crea una nueva Función Supabase ejecutando este comando:

supabase functions new telegram-bot

Una vez que hayas creado un proyecto de Supabase Function, puedes escribir tu bot.

Preparando tu código

Recuerda que necesitas ejecutar tu bot en webhhoks, por lo que debes usar webhookCallback y no llamar a bot.start() en tu código.

Puedes utilizar este breve ejemplo de bot como punto de partida.

import { Bot, webhookCallback } from "https://deno.land/x/grammy@v1.30.0/mod.ts";

const token = Deno.env.get("BOT_TOKEN");
if (!token) throw new Error("Falta BOT_TOKEN.");

const bot = new Bot(token);

bot.command("start", (ctx) => ctx.reply("¡Bienvenido! En marcha");
bot.command("ping", (ctx) => ctx.reply(`¡Pong! ${new Date()}`));

const handleUpdate = webhookCallback(bot, "std/http");

Deno.serve(async (req) => {
  try {
    const url = new URL(req.url);
    if (url.searchParams.get("secret") !== bot.token) {
      return new Response("not allowed", { status: 405 });
    }
    return await handleUpdate(req);
  } catch (err) {
    console.error(err);
  }
  return new Response();
});

Despliegue

Ahora puedes desplegar tu bot en Supabase. Ten en cuenta que tendrás que deshabilitar la autorización JWT porque Telegram utiliza una forma diferente de asegurarse de que las peticiones provienen de Telegram. Puedes desplegar la función usando este comando.

supabase functions deploy --no-verify-jwt telegram-bot

A continuación, tienes que dar tu token de bot a Supabase para que tu código tenga acceso a él como variable de entorno.

# Reemplaza 123:aBcDeF-gh con tu token de bot real.
supabase secrets set BOT_TOKEN=123:aBcDeF-gh

Tu función Supabase ya está funcionando. Todo lo que queda por hacer es decirle a Telegram dónde enviar las actualizaciones. Puedes hacerlo llamando a setWebhook. Por ejemplo, abre una nueva pestaña en tu navegador y visita esta URL:

https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://<PROJECT_REFERENCE_ID>.supabase.co/functions/v1/telegram-bot?secret=<BOT_TOKEN>

Sustituye <BOT_TOKEN> por tu token de bot real. Además, sustituye la segunda aparición de <BOT_TOKEN> por tu token de bot real. Sustituye <PROJECT_REFERENCE_ID> con el ID de referencia de tu proyecto Supabase.

Ahora deberías ver esto en la ventana de tu navegador.

{ "ok": true, "result": true, "description": "Webhook was set" }

Ya está. Tu bot ya está funcionando. Dirígete a Telegram y observa cómo responde a los mensajes.