Links curtos para SaaS: integre o URLW no seu produto via API

Os produtos SaaS modernos geram diariamente URLs para partilhar: convites de equipa, partilhas de documentos, links de transferência, páginas de estado... Integrar um encurtador de URL diretamente no seu SaaS melhora a experiência do utilizador e dá-lhe uma visibilidade preciosa sobre os comportamentos de partilha. A API URLW torna esta integração rápida e fiável.

Porquê os SaaS beneficiam dos links curtos

A integração de um encurtador de URL num SaaS responde a vários casos de uso concretos:

• Links de convite: "Convide um colega" gera um link curto personalizado com o nome do convidante e um token de convite — legível, partilhável por SMS ou email
• Partilha de conteúdo: os seus utilizadores partilham relatórios, dashboards ou documentos. Um link curto go.o-seu-saas.com/relatorio-xyz é muito mais profissional do que o URL interno da sua app
• Transferências e exportações: os links de transferência temporários são frequentemente longos e complexos. Um link curto com expiração é mais tranquilizador para o utilizador
• Notificações e emails transacionais: os links nos seus emails de notificação (confirmação, reset de password, etc.) podem beneficiar de um domínio coerente com a sua marca
• Analytics sobre as partilhas: meça quantos links gerados pelos seus utilizadores são efetivamente clicados — uma métrica de envolvimento preciosa

Integrar a API URLW no seu SaaS

Eis um exemplo de integração para gerar automaticamente um link curto numa partilha de relatório:

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer A_SUA_CHAVE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.o-seu-saas.com/relatorios/rpt_a1b2c3?token=eyJhbGc...",
"slug": "relatorio-junho-equipa-acme",
"domain": "share.o-seu-saas.com",
"expires_at": "2025-07-31T23:59:59Z",
"metadata": {
  "user_id": "usr_456",
  "report_id": "rpt_a1b2c3",
  "workspace": "acme-corp"
}
}'

O campo metadata permite-lhe armazenar identificadores internos que lhe permitirão relacionar cada clique URLW com um utilizador e um objeto específico na sua base de dados.

Webhooks URLW para notificações em tempo real

Em vez de fazer polling à API URLW para detetar novos cliques, configure webhooks para receber uma notificação HTTP em tempo real a cada evento:

• Evento link.clicked: recebido a cada clique num link. Contém o ID do link, a data/hora, o país e o tipo de dispositivo.
• Evento link.expired: notifica quando um link atinge a sua data de expiração ou o número máximo de cliques.
• Evento link.created: útil para sincronizar os links criados via a interface URLW (por um operador) com a sua base de dados.

Configuração do webhook no URLW:

curl -X POST https://urlw.fr/api/v1/webhooks \
-H "Authorization: Bearer A_SUA_CHAVE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.o-seu-saas.com/webhooks/urlw",
"events": ["link.clicked", "link.expired"],
"secret": "o_seu_segredo_webhook_para_verificar_a_assinatura"
}'

Boas práticas de integração SaaS

• Utilize um domínio dedicado para as suas partilhas: share.o-seu-saas.com ou go.o-seu-saas.com reforça a sua identidade de marca a cada partilha
• Crie os links de forma assíncrona: nunca bloqueie a sua UI enquanto aguarda a resposta da API URLW. Crie o link em background e devolva-o ao utilizador assim que estiver disponível
• Gira as expirações do lado do negócio: defina durações de validade coerentes com a sua lógica aplicacional (ex.: link de convite válido por 7 dias)
• Armazene o ID URLW na sua base de dados: conserve o ID do link URLW com o objeto associado para poder interrogar as estatísticas ou eliminar o link em caso de necessidade
• Teste a resiliência: o que acontece se a API URLW estiver temporariamente indisponível? A sua app deve fazer graceful fallback para o URL completo

Consulte a documentação completa da API URLW e os planos tarifários para SaaS. Crie a sua conta para iniciar a integração.