Integre seu provedor de serviços de e-mail (ESP) para enviar e-mails disparados aos seus usuários.
Pré-requisitos
Para integrar com a Dynamic Yield, seu ESP precisa:
- Oferecer uma API RESTful para enviar mensagens, seja usando um endpoint de “Enviar e-mail” ou um serviço de eventos baseado em API.
- Suportar um dos seguintes métodos de autenticação:
- No Auth (sem autenticação)
- Basic Auth (autenticação básica)
- OAuth2
- Suportar JSON como conteúdo.
Configurando a integração
Para configurar uma integração com seu ESP:
- Em Reconnect, acesse a guia de Integrations (Integrações) e clique em Create Channel Integration (Criar Integração de Canal).
- Selecione o canal Email e preencha as seguintes informações no assistente de integração.
1º passo: configurar
- Name (Nome): o nome da integração é incluído nas suas campanhas e respectivos relatórios.
- HTTP Post URL (URL de Postagem HTTP): o endpoint de mensagens do seu ESP.
- HTTP Header Parameters (Parâmetros de Cabeçalho HTTP) (opcionais): você pode inserir parâmetros de cabeçalho em um formato key:value. Clique no ícone de cadeado ao lado do campo para criptografar o valor. O valor é exibido de forma mascarada e é criptografado antes de ser salvo no nosso banco de dados.
-
Identifier Type (Tipo de Identificador): selecione o método de identificação exigido pelo seu ESP. O valor correspondente é incluído na mensagem JSON quando você usa a variável User Identifier (Identificador do Usuário).
Por exemplo, se você selecionar Plain Text Email (E-mail de Texto Simples) e inserir a variável User Identifier no conteúdo JSON de uma campanha, ele será substituído pelo endereço de e-mail simples do usuário que você forneceu como parte do processo de identificação.
Clique em Next (Próximo).
2º passo: autenticar
Selecione o método de autenticação exigido pelo seu ESP:
- No Auth: nenhuma autorização é exigida, portanto, não há parâmetros adicionais para configurar.
- Basic Auth: insira um nome de usuário e senha válidos conforme fornecidos pelo seu ESP.
-
OAuth2: insira uma URL de token, a ID do cliente e o segredo do cliente, conforme fornecidos pelo seu ESP.
-
- Você pode alterar os nomes das chaves da ID e do segredo do cliente na seção de parâmetros de cabeçalho das informações do token.
- Por padrão, o valor do segredo do cliente é criptografado, para fins de segurança.
-
Quando você clica em Next, o sistema verifica as credenciais que você informou comparadas à URL de token. Se elas forem inválidas, é exibido um erro.
3º passo: testar
Para testar sua integração, envie uma chamada de API de teste ao seu ESP:
- Request Headers (Solicitar Cabeçalhos): exibe os parâmetros que você inseriu nos passos anteriores.
-
JSON Payload (Conteúdo do JSON):
- Insira o corpo da mensagem em formato JSON, como seu ESP espera recebê-la.
- Clique em Test (Testar). Uma chamada de API é enviada ao endpoint de mensagens do ESP que você definiu anteriormente.
- Request Response (Solicitar Resposta): essa é a resposta do servidor do seu ESP.
Se tudo estiver funcionando como esperado, clique em Save (Salvar). A integração é exibida na guia de Integrations.