Pular para o conteúdo

Integrar com Lovable

  • Guardar a chave da iPORTO como secret do projeto, longe do navegador
  • Pedir ao Lovable a função de backend que envia — com o texto pronto para colar no chat
  • Testar o envio e conferir no histórico
  • Onde ficam os e-mails de login (cadastro, recuperação de senha)

No Lovable você não escreve a função: descreve o que precisa no chat, e ele cria, publica e mantém a função de backend (edge function). Por isso este guia gira em torno do pedido — é ele que define se a chave fica protegida e quem pode receber os seus e-mails.

  • Um projeto no Lovable com o backend ativo — Lovable Cloud ou um Supabase próprio
  • Uma chave de API — ver Chaves de API
  • Um domínio e ao menos uma conta de envio nele, no painel do SMTP

Crie uma chave só para este app, com um nome que diga onde ela está — por exemplo, Lovable — site. Copie o Token e deixe à mão para o passo 2.


Cole no chat do projeto, trocando o remetente e o destinatário pelos seus:

Crie uma página de contato com os campos Nome, E-mail e Mensagem.
Ao enviar, chame uma edge function chamada send-contact-email que:
- leia a chave da API do secret IPORTO_API_KEY, só no backend, nunca no frontend;
- faça POST para https://api.iporto.com.br/api/external/v1/messages com os cabeçalhos
Authorization: Bearer <chave>, Content-Type: application/json e Accept: application/json;
- envie o corpo JSON:
from: "Sua Empresa <[email protected]>"
to: ["[email protected]"] (fixo no código, nunca vindo do formulário)
reply_to: [o e-mail digitado pelo visitante]
subject: "Contato pelo site: <nome>"
html: nome, e-mail e mensagem, com o HTML escapado;
- trate como sucesso só a resposta 202 e devolva o message.tracking_code;
- em qualquer outro status, registre no log o status e o corpo da resposta e devolva erro.
Mostre "Mensagem enviada" ou "Não foi possível enviar" para o visitante.

Quando o Lovable pedir a chave, a caixa Add secret aparece no chat: cole o token e clique em Submit. Se preferir cadastrar antes, o caminho é More → Settings → Secrets → Add secret, com o nome IPORTO_API_KEY. É nessa mesma tela que a chave aparece depois, na lista de secrets.

O que cada linha do pedido garante:

Linha Por quê
A chave só no backend Chave no código do navegador fica visível para qualquer visitante — e ela dá acesso à sua conta
to fixo no código Se o destinatário viesse do formulário, qualquer pessoa usaria o seu app para enviar e-mail em nome do seu domínio, com o seu crédito
reply_to com o e-mail do visitante O Responder do seu programa de e-mail vai direto para quem escreveu
HTML escapado O que o visitante digita aparece como texto, e não vira HTML dentro do seu e-mail
Sucesso só no 202 202 é “aceita, e sai em seguida pela fila” — ver Erros

  1. No Preview, preencha o formulário com um e-mail seu e clique em enviar.
  2. A tela mostra Mensagem enviada.
  3. Abra o painel do SMTP e confira o envio em Histórico de envio.
  4. No e-mail recebido, clique em Responder: o destinatário é o e-mail digitado no formulário.

Confirmação de pedido, aviso de agendamento, boas-vindas: o pedido é o mesmo, mudando o gatilho e de onde vem o destinatário. Exemplos:

Quando um pedido for criado, use a edge function de envio da iPORTO para mandar a confirmação
ao e-mail do cliente gravado no pedido.
Quando um agendamento for confirmado, envie pela API da iPORTO um e-mail para o cliente do
agendamento e uma cópia para [email protected].

Cadastro, confirmação de e-mail e recuperação de senha não passam por esta função: quem envia é o sistema de login do backend.

  • Lovable Cloud: os e-mails de login saem pelo próprio Lovable, e não há onde configurar SMTP.
  • Supabase próprio: configure o SMTP da iPORTO no Supabase — veja Configurar SMTP no Supabase.

O formulário só diz Não foi possível enviar. O histórico do painel do SMTP separa os casos: se o envio não aparece lá, a API recusou o pedido antes de enviar.

Sintoma Causa provável O que fazer
Não foi possível enviar, e nada aparece no histórico A chave foi revogada, venceu ou foi colada pela metade — o caso mais comum. Ou o remetente não é de um domínio cadastrado, ou falta crédito Em Chaves de API, confira se a chave está ativa e na validade; se não, crie outra e troque o valor em More → Settings → Secrets (o valor não pode ser lido de volta: substitua). Confira também se o from é de um domínio cadastrado no painel do SMTP e o saldo no portal do cliente
Depois de trocar a chave, o Preview envia e o app publicado não A troca de secret vale na hora no Preview, mas só chega ao app publicado depois de publicar Publique o app de novo
Responder vai para o seu próprio endereço A função não envia o reply_to Peça ao Lovable para incluir o reply_to com o e-mail do visitante
Aparecem no histórico e-mails que ninguém do seu time enviou A função aceita destinatário vindo do navegador Peça ao Lovable para fixar o destinatário no código ou buscá-lo no banco

Os códigos de recusa da API estão em Erros.


Checklist:

  • A chave está em Secrets, e não no código nem no chat
  • O formulário mostra Mensagem enviada, e o envio aparece no histórico
  • Responder vai para o e-mail do visitante
  • Com a chave errada, o formulário mostra Não foi possível enviar, e nada entra no histórico
  • Nenhuma função aceita destinatário vindo do navegador

Catálogo completo de campos e códigos: Referência.