Envie email transacional com Resend e Functions

Construa um endpoint Hono em Azion Functions que chama a API do Resend, armazene a API key como variável de ambiente e faça o deploy com Azion CLI.

Última atualização

Ver como Markdown Configurar agente

Neste tutorial, você vai construir um endpoint HTTP em Azion Functions que envia um email transacional pelo Resend. Você vai criar o projeto a partir de um template, escrever o handler, armazenar a API key, fazer o deploy do projeto e enviar uma mensagem real.

O projeto finalizado está no repositório edge-functions-examples.

Pré-requisitos

1. Crie o projeto a partir do template Hono

Para autorizar a CLI e criar o projeto:

Autentique Azion CLI

Execute o comando de login:

azion login

Sem as flags de credencial, a CLI abre um fluxo pelo navegador. Ela armazena as credenciais localmente, e todo comando seguinte é autorizado na sua conta.

Inicialize o projeto

Execute o comando de inicialização no diretório que guarda seus projetos:

azion init

O comando abre uma jornada interativa.

Nomeie o projeto

Digite um nome, ou pressione enter para aceitar a sugestão:

? Your applications name: (black-thor)
Selecione o preset Hono

A CLI lista os presets que ela suporta:

Shell
01? Choose a preset: [Use arrows to move, type to filter]
02 Angular
03 Astro
04 Docusaurus
05 Eleventy
06 Emscripten
07 Gatsby
08 Hexo
09> Hono
10 Hugo
11 Javascript
12 ...
Selecione o template Hono Boilerplate
Recuse o servidor local e o deploy

A CLI oferece um servidor de desenvolvimento local e um deploy. Responda N para os dois, porque o handler ainda não está escrito:

Shell
01Do you want to start a local development server? (y/N)
02Do you want to deploy your project? (y/N)
Instale as dependências do projeto

Vá para o diretório do projeto e instale as dependências dele:

Shell
01cd <your-project-name>
02npm install

O diretório do projeto contém o template Hono e as dependências dele.

2. Escreva o handler que chama a API do Resend

O handler responde a uma requisição GET no path raiz, envia a mensagem para a API do Resend e retorna a resposta da API em JSON. O campo entry do azion.config.js indica o arquivo de entrada do projeto. Abra esse arquivo e substitua o conteúdo dele por:

TypeScript
01import { Hono } from "hono";
02
03const app = new Hono();
04
05const RESEND_API_KEY = Azion.env.get("RESEND_API_KEY")!;
06const EMAIL_TO = "<your-email-address>";
07
08app.get("/", async (c) => {
09 const res = await fetch("https://api.resend.com/emails", {
10 method: "POST",
11 headers: {
12 "Content-Type": "application/json",
13 Authorization: `Bearer ${RESEND_API_KEY}`,
14 },
15 body: JSON.stringify({
16 from: "onboarding@resend.dev",
17 to: EMAIL_TO,
18 subject: "hello world",
19 html: "<strong>it works!</strong>",
20 }),
21 });
22
23 const data = await res.json();
24
25 return c.json(data);
26});
27
28export default app;

Defina EMAIL_TO com o endereço que recebe a mensagem. O campo html carrega o corpo da mensagem como uma string HTML, então um template literal substitui os valores que mudam por destinatário.

A última linha exporta a aplicação como um handler ES Modules, o padrão que Azion recomenda em vez do padrão legado Service Worker. Para os dois padrões e a migração entre eles, consulte Migre padrões de handler em Functions.

3. Armazene a API key do Resend como variável de ambiente

O handler lê RESEND_API_KEY em tempo de execução, então a chave fica fora dos arquivos do projeto e fora do controle de versão. Para criar a variável na sua conta:

azion create variables --key "RESEND_API_KEY" --value "[TOKEN VALUE]" --secret true

Uma variável cuja chave contém password, pwd, secret, key, hash, encrypted, passcode, auth ou token é enviada como secret por padrão. A flag --secret true repete esse padrão aqui. Dê à API key do Resend o menor conjunto de permissões que a chamada de envio exige.

Para substituir o valor depois, execute azion update variables e faça um novo deploy do projeto. Uma alteração em uma variável não chega a uma função que já está rodando.

A conta guarda a variável, e o handler a lê pela chave após o deploy.

4. Faça o deploy do projeto

Para compilar o projeto e publicá-lo:

azion deploy

O deploy envia o código da função, configura a aplicação, define as regras de roteamento e aplica as variáveis de ambiente e os segredos. Ao final, ele retorna um domínio no formato https://xxxxxxx.map.azionedge.net. Azion abre o navegador na página do Azion Console que carrega os logs do deploy.

O endpoint responde no domínio retornado alguns minutos após a propagação.

5. Envie o primeiro email

Para executar o handler, requisite o path raiz do domínio que o deploy retornou:

curl https://<your-azion-domain>/

O corpo da resposta é o JSON que a API do Resend retorna para a requisição. A mensagem chega na caixa de entrada do endereço definido em EMAIL_TO, com o assunto hello world e o corpo it works!.

nota — Se a resposta trouxer um erro do Resend, confirme que RESEND_API_KEY existe na sua conta e que o projeto passou por deploy depois da criação da variável. Para uma função que não é executada, que para antes do fim ou que escreve um erro nos logs, consulte Solução de problemas de execução e logs de funções.

O endpoint agora envia um email transacional em toda requisição para o path raiz dele.

Próximos passos

Variáveis de ambienteOs três campos de uma variável, a interface que lê uma delas e os subcomandos da CLI que as gerenciam.Migre padrões de handler em FunctionsOs handlers ES Modules e Service Worker, seus parâmetros e como migrar uma função entre eles.Limites de FunctionsOs tetos de tempo de CPU, de tempo total e de sub-requisições dentro dos quais uma invocação roda.Boas práticas de FunctionsO que cada parte do handler faz e as decisões de design que mantêm uma invocação dentro dos seus limites.Deploy de aplicação Jamstack com HonoA jornada completa do azion init para um projeto Hono, incluindo o servidor de desenvolvimento local.API do ResendOs campos que o endpoint de emails do Resend aceita e o resto da API dele.