Abre num novo separador

API e integrações

Uma só API para email, SMS e certificação.

API REST documentada em OpenAPI 3.0, webhooks assinados, relay SMTP, SMPP 3.4 e conectores para os principais CRM e ERP.

API REST

Com uma só integração, usa todos os produtos.

Email marketing, SMS transacional e email registado, com autenticação por API Key, respostas JSON consistentes e um ambiente de testes com os mesmos endpoints de produção.

  • Documentação interativa OpenAPI 3.0, com Swagger
  • Autenticação por API Key com rotação automática
  • Sandbox completo, sem envios reais nem custos
  • Limites de pedidos indicados nos cabeçalhos de cada resposta
  • Versões da API compatíveis com as anteriores
API REST do DUO

Webhooks

Receba cada evento no seu sistema, em tempo real.

Email entregue, email aberto, SMS entregue, certificado emitido: cada evento chega ao seu endpoint, com nova tentativa automática em caso de falha.

Notificações instantâneas

Envio, entrega, abertura, clique, exclusão (opt-out) e falha, para email e SMS, com filtros por tipo de evento e por produto.

Novas tentativas

Até 3 novas tentativas automáticas em caso de falha, com intervalo crescente, e histórico consultável na plataforma.

Assinatura HMAC-SHA256

Cada webhook traz o cabeçalho X-DUO-Signature para verificar a autenticidade. Os SDKs incluem um helper para a validação.

Integrações

Integre com o que já usa.

Conectores nativos para os principais CRM, ERP e plataformas de comércio eletrónico, sem programação. Relay SMTP para qualquer aplicação.

Integrações típicas dos nossos clientes: CRM (Salesforce, HubSpot, Microsoft Dynamics), ERP (SAP, Oracle, Primavera), ITSM (ServiceNow, Jira), lojas online (Shopify, WooCommerce, PrestaShop) e sistemas de gestão documental. Para automatizações sem código, Zapier e n8n.

Capacidade

Pensada para volume.

Motor de envio escalável, com limites por plano e aquecimento de IPs para domínios novos.

500.000 emails por hora

Capacidade de envio escalável, com mensagens até 10 MB e anexos múltiplos.

100.000 SMS por hora

GSM-7 e Unicode, até 1.000 caracteres com segmentação automática, SMPP 3.4 até 1.000 SMS por segundo.

Reenvio automático

Reenvios configuráveis por tipo de erro, número de tentativas e intervalo, para falhas temporárias de entrega.

Arquivo no seu servidor

Os certificados e os PDFs assinados podem ser copiados automaticamente para o seu sistema de arquivo pela API ou por webhook.

Perguntas frequentes

API e integrações

O que costumam perguntar-nos antes de começar.

Sim. Um sandbox completo com os mesmos endpoints de produção, sem envios reais nem custos. A API Key de sandbox é gerada na criação da conta.

Por API Key, no cabeçalho Authorization: Bearer. Pode criar várias API Keys com permissões diferentes (só email, só SMS ou acesso total) e substituí-las sem interromper o serviço.

Dependem do plano. Os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset estão presentes em todas as respostas. Para volumes muito elevados de SMS, o SMPP 3.4 suporta até 1.000 SMS por segundo.

Cada webhook inclui o cabeçalho X-DUO-Signature com uma assinatura HMAC-SHA256 do payload, feita com o seu webhook secret. Valide sempre a assinatura antes de processar o evento.

Sim. Qualquer aplicação que fale SMTP envia pelo DUO com credenciais próprias, e cada mensagem fica com registo de envio, entrega e abertura.

Sim, SMPP 3.4 para integrações de alto volume com sistemas legados e plataformas de telecomunicações. Fale com a equipa para ativar.

Quer integrar o DUO nos seus sistemas?

Consulte a documentação em docs.duo.pt ou fale com a equipa técnica.