Integrar com Lovable
O que este guia cobre
Seção intitulada “O que este guia cobre”- 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.
Pré-requisitos
Seção intitulada “Pré-requisitos”- 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
Passo 1: A chave (3 min)
Seção intitulada “Passo 1: A chave (3 min)”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.
Passo 2: Pedir a função (5 min)
Seção intitulada “Passo 2: Pedir a função (5 min)”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 |
Passo 3: Testar (3 min)
Seção intitulada “Passo 3: Testar (3 min)”- No Preview, preencha o formulário com um e-mail seu e clique em enviar.
- A tela mostra Mensagem enviada.
- Abra o painel do SMTP e confira o envio em Histórico de envio.
- No e-mail recebido, clique em Responder: o destinatário é o e-mail digitado no formulário.
Passo 4: Os outros e-mails do app (opcional)
Seção intitulada “Passo 4: Os outros e-mails do app (opcional)”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çãoao e-mail do cliente gravado no pedido.Quando um agendamento for confirmado, envie pela API da iPORTO um e-mail para o cliente doagendamento e uma cópia para [email protected].E-mails de login
Seção intitulada “E-mails de login”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.
Se der errado
Seção intitulada “Se der errado”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.
