Até agora, quando você precisava importar assinantes parà sua conta da Mailrelay, se você precisasse fazê-lo via API, a única opção disponível era usar a função addSubscriber, embora seu uso fosse bastante simples, para grandes volumes de assinantes o processo poderia tornar-se um pouco mais complexo.
Assim sendo, nossa equipe técnica desenvolveu uma nova função para permitir a importação de grandes bases de dados de assinantes. Chama-se função import , que você poderá ver em detalhes na documentação API na opção import.
De qualquer forma, se você deseja aprender a utilizar esta opção, continue lendo, veremos um exemplo passo a passo. Para enviar e-mail marketing é preciso utilizar um mailing de assinantes
Uma forma de automatizar esse processo é através da API, por exemplose você tem uma loja online, um CRM, website, etc. Você pode exportar estes usuários para um arquivo CSV e depois importá-los usando a API.
Vamos ver os parâmetros desta função:
– ApiKey -> sua chave API, um parâmetro essencial. Para gerar essa chave, você deve acessar a sua conta da Mailrelay, em seguida, no menu Configurações -> Acesso API -> Gerar e você já tem a chave, para copiar e colar.
– FileContent -> O conteúdo do arquivo que você deseja importar.
– groups -> os IDs dos grupos nos quais você deseja importar os usuários.
– fields -> mapeamento entre campos com o arquivo e a Mailrelay, por padrão, o primeiro campo é o e-mail e o segundo é o nome do assinante.
– delimiter -> separador entre campos, por exemplo uma vírgula “,” geralmente encontrado em arquivos CSV.
– enclosure -> delimitador de campos, por exemplo, aspas duplas “”
Útil se os campos incluem o separador, por exemplo.
– headers -> Se o arquivo CSV inclui cabeçalhos defina como TRUE para que a primeira linha seja ignorada.
– ExistingEmails -> o que deverá ocorrer com e-mails existentes “skip” para ignorar ou “replace” para substituir. Por padrão o sistema utiliza “replace”.
Vamos ver um exemplo prático para ver como utilizar esta função, a primeira coisa que você irá precisar é de um arquivo CSV com os assinantes que você irá importar para a sua campanha de e-mail marketing. Por exemplo algo como este:
Como você pode ver os valores estão entre aspas duplas e separados por uma vírgula. Cada assinante em sua própria linha.
Vamos ver o código PHP necessário para a importação:
A primeira coisa que você deve fazer é definir a URL da sua conta da Mailrelay e a API.
Logo depois será preciso ler o conteúdo do arquivo de importação, é importante definir o caminho corretamente para que o arquivo possa ser lido.
Depois será preciso preparar a chamada da função com o conteúdo do arquivo incluído, e o grupo onde você deseja importar os assinantes.
Importante: Você deve usar a função base64_encode para preparar o conteúdo.
O resto do código é o mesmo utilizado nas outras funções da API, mas você pode ver todos os detalhes na descrição da função import.
Se tudo funcionar corretamente, o código irá retornar o ID do arquivo importado no caso do Exemplo 5:
Se você acessar seu painel da Mailrelay, no menu Importar –> arquivos importados, será possível ver os arquivos importados:
Basta clicar duas vezes sobre esta entrada e será possível ver todos os e-mails importados e o status da importação:
Assim, será possível verificar se as contas estão prontas para a sua campanha de e-mail marketing.
Você também pode ver esses assinantes na lista normal de assinantes. Como você pode ver o processo de importação é muito fácil com esta nova função.
Se você quiser ver esta função e outras complementares, você pode visitar nossa documentação da API:
– Import -> função que permite a importação de arquivos.
– getImports ->função que retorna uma lista de arquivos importados.
– getImportData -> retorna os resultados de uma importação em específico.
Esperamos que esta informação seja útil em seu e-mail marketing!
Se você está buscando por email marketing software, crie sua conta gratuita na Mailrelay, email marketing.