Configurações

Anexo

Como importar contatos, criar uma segmentação por importação e enviar email com um anexo, via AP

Através de requisições via API você pode realizar diversas ações como de filtragem, importação e envio, da mesma forma que da interface gráfica.


A documentação oficial da API está disponível no endereço: https://support.dinamize.com/apidoc/


Inicialmente, você deverá gerar um token de aplicação para autenticar-se no sistema.

Para concluir essa etapa, pode seguir esse guia: https://help.dinamize.com/article/4000128088-como-gerar-token-de-autenticacao-com-o-postman


Para saber o client_code de sua conta, no Mail2Easy Pro, deve acessar o menu Ajuda.



E para saber o client_code do MKT2Easy, deve colocar o cursor no nome da sua conta, onde fica abaixo do nome do seu usuário, no topo direito da tela. Consegue visualizar do Mail2Easy Pro assim também.



Após a autenticação será gerado o Token.


Como importar contatos


Para realizar a importação de contatos dentro do sistema é necessário possuir um contact-list_code.

O contact-list_code será utilizado para executar as requisições.


Como consultar os contact-list_code das listas


Para identificar o número da lista, você pode realizar a ação de Listar, para o sistema apresentar as listas existentes, seguindo este tutorial.


https://mail2easypro.com/apidoc/#api-4ContactListGroup-ContactListSearch


Segue um exemplo desta ação via Postman da chamada.



E da resposta:



O code é o contact-list_code da lista.


Agora para realizar a importação, primeiramente deve verificar o número de cada coluna do seu arquivo, para linkar com os números dos campos a serem importados.



Lembrando que sempre começa a contagem por 0.


A ferramenta vem com os campos padrões E-mail, Nome e Marcador, outros campos devem ser criados primeiramente.


Aqui segue o passo a passo de criação de campos via API.


E os tipos de campos que a ferramenta possui.


Para o campo Arquivo, ele deve ser criado do tipo Texto Simples.


https://mail2easypro.com/apidoc/#api-6ContactImportGroup-ContactImportAdd


Um exemplo com a importação via Postman deste arquivo.


  • No file é selecionado o arquivo no seu computador.

  • Command é import.

  • E é preenchido os parâmetros:


    • Contact-list_code é o código da lista.

    • Separador é normalmente utilizado quando o arquivo é TXT ou CSV.

    • Header é para informar se o arquivo tem cabeçalho ou não.

    • Position é o número da coluna do arquivo.

    • Field é o código do campo no sistema.

    • Rule é a Regra para sobrescrever dados.


Vai receber a seguinte resposta.



Com os dados importados, agora precisamos criar uma segmentação para o envio.


Criando uma segmentação de contatos

Para criar uma segmentação pelo arquivo importado, deve seguir estes passos.


https://mail2easypro.com/apidoc/#api-92FilterGroup-FilterAdd


Com o código da importação que realizou anteriormente, podemos realizar este procedimento conforme o exemplo via Postman.

  • Contact-list_code é o código da lista.

  • Title é o nome do filtro.

  • Type é a regra a ser utilizada E ou Ou.

  • Rule_list é a regra que está utilizando no momento, dentro dela coloquei estes parametrôs:


    • Event é a ação da importação IMPORT..

    • Action é o código da importação.



E recebo a seguinte resposta.



E pronto o filtro está criando com o código 2.


Agora precisamos criar a mensagem a ser enviada.

Criando a mensagem via API

https://mail2easypro.com/apidoc/#api-94MessageGroup-MessageAdd


No exemplo via Postman, coloquei o título da minha mensagem e o um texto do HTML.



E é gerado o código da mensagem.



Agora com os códigos da lista, da segmentação e da mensagem, podemos realizar os envios com o anexo.

Realizando o envio com o anexo


https://mail2easypro.com/apidoc/#api-95ActionGroup-ActionAdd


Agora que tem os dados, deve criar um envio, colocando as informações de envio em Anexo, conforme o exemplo do envio via Postman.



Para o envio de anexo, precisa destas informações:


  • Title é o título do envio

  • Contact-list_code é o número da lista de contatos

  • Subjetc é o assunto que os contatos vão receber

  • Sender_name é o nome de remetente.

  • Sender_e-mail é o e-mail de remetente.

  • Reply_to é o e-mail de resposta.

  • Campaing-code é o código da campanha criada.

  • Filter_code é o código da segmentação criada.

  • Message_code é o código da mensagem criada.

  • Message_type é o tipo da mensagem, envio de URL ou HTML.

  • Send_speed é a velocidade do envio.

  • Send_now é se o envio será disparado agora ou agendado.

  • Optout_progressMode opção de descadastro, este com confirmação.

  • Attachment_dir_code é o código da integração.

  • Attachment_dir_path é o caminho onde está o arquivo dentro da integração.

  • Attachment_file_list é onde fica o nome do arquivo, extensão e o label, que é como será mostrado aos contatos que recebem o envio.


E pronto, o envio com o Anexo foi realizado.