Como integrar a Mailrelay ao seu plugin, CRM ou APP? E ofereça mais opções para seus usuários.

Se você está desenvolvendo um CRM, APP, plugin ou outro tipo de plugin, integrar a Mailrelay pode ser uma opção muito interessante para destacar seu produto ou serviço.

As vantagens são muitas:

Essa integração é, na verdade, um processo muito fácil, graças à API Mailrelay.

Porém, para facilitar ainda mais o seu trabalho, hoje veremos um tutorial que esclarecerá todas as dúvidas que você possa ter no processo de integração da Mailrelay ao seu sistema.

Vamos começar!

Quais funções da API Mailrelay precisaremos durante o processo de integração?

Neste artigo, veremos um exemplo de integração básica, ou seja, como sincronizar os usuários do seu CRM, APP ou plugin com a Mailrelay, para que seus clientes tenham seus contatos disponíveis em sua conta e possam enviar newsletters.

Integrar a Mailrelay desta forma é muito fácil.

Além disso, existem opções avançadas, como o envio de campanhas de e-mail de seu APP, CRM, etc. Mas isso já requer mais desenvolvimento e, embora o processo seja o mesmo, aumentaria um pouco a extensão deste artigo.

De qualquer forma, se você acha que seria algo do seu interesse, pode deixar um comentário, e tentaremos preparar outro post futuramente sobre isso.

Agora, para a integração que mencionamos, precisaremos destas funções de API:

Nada mais, com essas funções podemos integrar o software, e veremos como fazê-lo.

► Qual é o processo que você precisa seguir para integrar os assinantes à Mailrelay?

É muito fácil, passo a passo, o que faremos é:

Vamos ver o processo passo a passo.

1) Verifique se o assinante já existe

A primeira coisa é verificar se o contato já existe, pois caso não exista pode ser adicionado, pois não é possível ter emails duplicados na Mailrelay.

Para verificar isso, usaremos getSubscribers.

Na descrição da API, você pode ver um exemplo do código que você pode usar, que é mais ou menos assim:

É o código básico para verificar se já existe um contato, a consulta será feita através do endereço de e-mail.

Se o contato existir, o sistema retornará um array com todas as informações do assinante, como nome, e-mail, grupos nos quais ele está registrado, etc.

E também, o ID do assinante:

Variedade
(
[0] => Objeto stdClass
(
[id] => 2
[nome] =>

…

E caso o contato não exista?

Nesse caso, a função retorna um array vazio.

Variedade
(
)

Como está vazio, você saberá que este e-mail não existe no sistema e poderá adicioná-lo.

Até agora, integrar a Mailrelay com qualquer software parece muito fácil, não é? Bem, não se preocupe, não será complicado.

2) Adicionar um novo assinante

Se o assinante não existir, podemos adicioná-lo, embora com certeza você se perguntará o que acontece se tentarmos adicionar um assinante que já existe? Bem, nada sério, o sistema simplesmente avisaria que isso não pode ser feito:

E, portanto, não iria adicioná-lo.

Nesse caso, para adicionar um assinante, usaremos a função addSubscriber Com um código semelhante ao seguinte:

Os parâmetros básicos e obrigatórios são:

Importante: O contato já estará ativo e não precisará ser confirmado por e-mail, pois está importando de um sistema de CRM, e-commerce, etc. E assim o contato já deve ter sido validado antes de ser cadastrado em nosso software.

Se necessário, o contato pode ser inativado e pode ser ativado através de um e-mail de confirmação, por exemplo, mas por padrão, entende-se que o uso da API é apenas para a migração de dados previamente validados.

O que retornaria esta ligação?

Se a chamada for feita positivamente, o que ela retornará seria algo como:

objeto (stdClass) # 1 (2) {
[“Status”] =>
int (1)
[“Dados”] =>
int (9)
}

Devemos atentar para o fato de que ele retornará o ID do assinante (no exemplo seria 9).

Bem, até agora, dois processos foram feitos, verificamos para ter certeza de que o assinante existe, e se ele não existe, nós o adicionamos. A próxima etapa é atualizar um assinante que já existe.

3) Atualizar um assinante existente

Este é um caso comum, após passar pela primeira etapa, podemos atualizar o assinante usando a função updateSubscriber:

Se a função funcionar, ela retorna:

bool (verdadeiro)

Este código também é direto, mas existem alguns pontos a serem considerados:

Este último ponto é essencial para que eu o enfatize.

Esta função exige que todos os dados do assinante sejam informados. Por exemplo, se o assinante já pertence ao grupo 1 e nos grupos da matriz você indica o valor 3, o assinante pertenceria apenas ao grupo 3.

Se você deseja que o assinante seja registrado para o grupo 1 e o grupo 3, você deve indicar ambos os valores na matriz.

O mesmo acontece com os campos personalizados (customFields), caso não sejam indicados, os campos personalizados ficarão vazios. Você terá que indicar todos os dados que deseja adicionar para o assinante.

Isso não é um problema.

Porque na etapa 1, com getSubscribers, todos os dados já foram obtidos.

4) cancele a inscrição e deleteSubscriber

Estas duas funções, unsubscribe e deleteSubscriber podem ser utilizadas sem problemas, bastando inserir o endereço de email do assinante.

Qual é a diferença?

Opt-out, unsubscribe, permite que o assinante se inscreva novamente no futuro, enquanto se for excluído, não pode ser adicionado novamente.

Essa é a diferença. Existem mais funções na API Mailrelay para criar um e-mail, obter estatísticas, importar um banco de dados, etc.

Porém, neste breve tutorial, gostaria de explicar apenas as funções que permitem integrar a Mailrelay a vários tipos de software, como APPs, plug-ins, CRMs, etc.

E em qualquer caso, o uso da API é muito simples e intuitivo, incluindo exemplos de uso em PHP para a maioria das funções.

Razões para integrar a Mailrelay em seu CRM, APP, plugin ou qualquer outro software.

As razões para integrar a Mailrelay são muitas, por um lado, a Mailrelay é uma das principais ferramentas de email marketing. Isso significa que um grande número de usuários está utilizando nosso software e o processo de integração será ainda mais lucrativo.

Mailrelay é também um software utilizado por grandes empresas, blogueiros e inúmeras pequenas empresas e PMEs, sendo a maior conta gratuita:

Portanto, a integração também pode ajudar a ganhar visibilidade.

Além disso, integrar a Mailrelay é muito fácil graças à API para desenvolvedores, e é algo que várias empresas já fizeram, como:

Eles já oferecem recursos extras para seus usuários.