Skip to main content
O BYOK permite que você conecte provedores externos usando credenciais da sua própria conta (por exemplo, API key), mantendo o envio centralizado pela API da Notifique.

​
Como funciona

  1. Você configura uma integração externa por canal no workspace.
  2. A Notifique tenta enviar primeiro pelo provedor externo configurado.
  3. Se a tentativa externa falhar, a Notifique pode acionar fallback automático para infraestrutura interna.
  4. O envio registra telemetria técnica: provedor utilizado, tipo (EXTERNAL ou INTERNAL), resposta do provedor (sanitizada) e identificador externo.

​
Benefícios

  • Mantém um único endpoint da sua aplicação (/v1/...) para operação.
  • Permite usar contratos e precificação do provedor externo.
  • Aumenta resiliência com fallback automático.
  • Preserva observabilidade e auditoria no mesmo fluxo.

​
Segurança

  • Credenciais externas são armazenadas criptografadas.
  • A chave/token não é retornada em plaintext após salvar.
  • Atualização de credencial ocorre por substituição (rotate), nunca por leitura do valor anterior.

​
Limites e ordem

  • Atualmente, cada workspace pode ter até 2 integrações externas por canal.
  • A ordem de execução dos provedores externos é configurável.
  • Após falha de externos, a plataforma tenta provedores internos da Notifique.

​
Cobrança (modelo atual)

  • Envio concluído no provedor externo: sem cobrança de disparo pela Notifique.
  • Envio concluído por fallback interno Notifique: cobrança normal conforme tabela.

​
Provedores suportados

Cada provedor suportado possui uma página própria com:
  • tipo de autenticação;
  • mapeamento de payload;
  • comportamento de tags/metadata;
  • exemplos de configuração.
Hoje incluem, entre outros: Rewrite Today (SMS) e Resend (e-mail). Consulte os documentos desta pasta para detalhes por provedor.

​
E-mail e domínios aprovados

Para e-mail, o workspace só dispara com endereços from cujo domínio corresponde a um domínio de e-mail aprovado na Notifique para aquela mensagem. Ter o domínio apenas no provedor externo (ex.: só na Resend) não autoriza o envio pela API da Notifique. Veja a página da Resend nesta seção para o fluxo completo (interseção na integração + regra no envio).