Por que usar
Algumas equipes já pagam um provedor de e-mail e não querem dois sistemas de envio na aplicação. BYOK liga esse provedor ao workspace: você continua chamando a API Notifique (/v1/...), e a plataforma decide quem entrega, sua conta externa ou fallback interno.
Analogia: você usa o mesmo portão do prédio (API Notifique), mas a carteirinha da entrega pode ser da sua operadora.
Quando usar
Como funciona na prática
- Cadastre o provedor externo no workspace (ordem e ativação por canal).
- No envio, Notifique tenta primeiro o caminho externo (suas credenciais).
- Se falhar → fallback para provedores internos (conforme configuração).
- Telemetria registra
EXTERNALvsINTERNAL, resposta sanitizada e ID externo.
Cobrança
- Todo envio enfileirado na Notifique (BYOK ou interno) consome 1 crédito de e-mail (ou o preço pré-pago vigente, ~R$ 0,05).
- Você continua pagando o provedor externo (Resend/SES) pela entrega na sua conta.
- Failover interno não gera cobrança extra no mesmo envio (o débito já ocorreu no enqueue).
Segurança
- Credenciais criptografadas; após salvar, API não devolve segredo em texto claro.
- Atualizar = rotacionar (substituir), não “ler de volta”.
Até duas integrações externas por canal (limite pode evoluir, confira o produto).