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 diversas:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
- Você oferecerá mais opções aos seus usuários, algo que sempre será positivo
- Mailrelay é uma ferramenta líder em email marketing, com centenas de milhares de usuários, você pode aproveitar essa visibilidade
- Certamente, alguns desses usuários irão usar seu sistema
[/su_list]
Esta integração é, de fato, um processo muito fácil, graças à API da Mailrelay.
No entanto, para facilitar ainda mais o seu trabalho, hoje vamos ver um tutorial que esclarecerá todas as duvidas que você possa ter sobre o processo de integração da Mailrelay com seu sistema.
Vamos começar!
Quais funções da API da Mailrelay vamos precisar durante o processo de integração?
Neste artigo, vamos ver um exemplo de uma integração básica, isto é, como sincronizar os usuários do seu CRM, APP ou plugin com a Mailrelay, para que o usuário final tenha os emails disponíveis na sua conta e possa enviar-lhes newsletters.
Integrar a Mailrelay dessa maneira é muito fácil.
Além disso, há opções mais claras, como o envio de campanhas de email a partir da sua própria APP, CRM, etc. Mas isso já requer desenvolvimento adicional, e embora o processo seja o mesmo, aumentaria um pouco a extensão deste artigo.
De qualquer forma, se você acha que seria algo de interesse, você pode deixar um comentário e vamos tentar preparar um outro post no futuro sobre isto.comentário.
Agora, para a integração que mencionamos, vamos precisar dessas funções da API:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
[/su_list]
Nada mais, com essas funções podemos trabalhar, e veremos como.
► Qual é o processo que você precisará seguir para integrar os usuários com a Mailrelay?
Muito fácil, passo a passo, o que faremos é o seguinte:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
- Verificar se o contato que você deseja adicionar já existe na Mailrelay
- Se não existir, será adicionado como um novo contato
- E, se existir, será atualizado, se necessário
- Opcionalmente será possível excluí-lo ou cancelá-lo, se necessário
[/su_list]
Vamos, então, ver o processo passo a passo.
1) Verificar se o assinante já existe
A primeira coisa é verificar se o contato já existe, porque se não existir, ele poderá ser adicionado, uma vez que não é possível ter e-mails 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 é algo como isto:
É o código básico para verificar se um contato já existe, a consulta será feita usando seu e-mail.
Se o contato existir, o sistema retornará uma array com todas as informações do assinante, como nome, email, grupos nos quais está registrado, etc.
E também, o ID do assinante:
Array
(
[0] => stdClass Object
(
[id] => 2
[name] =>
…
E no caso de o contato não existir?
Nesse caso, a função retornará uma array vazia.
Array
(
)
Ao estar vazia, será possível saber que este e-mail não existe no sistema e poderá adicioná-lo.
Até agora, integrar a Mailrelay com qualquer software parece muito simples, verdade? Bem, não se preocupe, não será complicado.
2) Adicionar um novo assinante
Caso o assinante não exista diretamente, podemos adicioná-lo, embora com certeza você se perguntará o que acontece se tentarmos adicionar um assinante que já existe? Bem, nada de grave, o sistema simplesmente irá avisar que não é possível fazê-lo:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
- stdClass Object ( [status] => 0 [error] => email: El email ya existe )
[/su_list]
E, portanto, não irá adicioná-lo.
Neste caso, para adicionar um assinante, usaremos a função addSubscriber Com um código semelhante a este:
Os parâmetros básicos e obrigatórios são:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
- Nome
- E o grupo
[/su_list]
Importante: o contato já estará ativo e não precisará ser confirmado por e-mail, porque é uma importação de um sistema de CRM, ecommerce, etc. E por isso o contato já deveria ter sido validado antes de ser cadastrado na Mailrelay.
Se necessário, o contato pode ser inativado e pode ser ativado através de um email de confirmação, por exemplo, mas, por padrão, entende-se que o uso da API é apenas uma migração de dados validados anteriormente.
O que retornaria essa chamada?
Se a chamada for feita de forma positiva, o que ela retornaria seria algo como:
object(stdClass)#1 (2) {
[“status”]=>
int(1)
[“data”]=>
int(9)
}
Devemos prestar atenção ao fato de que ele irá retornar o ID do assinante (no exemplo seria 9).
Bem, até agora foram feitos dois processos, verificar se o assinante existe, e se não existe, adicioná-lo. O próximo passo será atualizar um assinante que já existe.
3) Atualizar um assinante existente
Este é um caso usual, depois de passar pelo primeiro passo, atualizar o assinante, usando a função updateSubscriber:
Se a função for bem sucedida, ela retornará:
bool (true)
Este código também é muito simples, mas há alguns pontos a ter em conta:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
- Você precisará do ID do assinante, isso pode ser obtido no passo 1 com getSubscribers
- Será preciso informar todos os grupos nos quais o assinante será inscrito
[/su_list]
Este último ponto é importante, então vou enfatizá-lo.
A atualização exige que todos os valores do assinante sejam informados. Por exemplo, se o assinante já pertence ao grupo 1 e no array groups você indicar o valor 3, o assinante pertencerá apenas ao grupo 3.
Se quisermos que o assinante esteja no grupo 1 e 3, será preciso indicar ambos os valores no array.
O mesmo acontece com os campos personalizados (customFields), se não forem indicados, os campos personalizados ficarão vazios. Será preciso indicar todos os dados do assinante.
Não é um problema.
Porque no passo 1, com getSubscribers todos os dados do assinante já foram obtidos.
4) unsubscribe e deleteSubscriber
Essas duas funções, unsubscribe e deleteSubscriber são muito simples, basta informar o email do assinante.
Qual é a diferença?
O cancelamento, unsubscribe, permite que em um futuro o assinante possa se inscrever novamente, enquanto que se for excluído, não poderá ser adicionado novamente.
Essa é a diferença.
Existem mais funções na API da Mailrelay
Para preparar os emails, obter estatísticas, importar base de dados, etc.
No entanto, neste breve tutorial queria apresentar apenas as opções que permitem integrar a Mailrelay com vários tipos de software, como APPs, plugins popups, 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
Os motivos para integrar a Mailrelay são muitos, por um lado, a Mailrelay é uma das principais ferramentas de email marketing. Dessa forma, um grande número de usuários está usando nosso software, o que torna o processo de integração mais lucrativo.
A Mailrelay também é um programa usado por grandes empresas, blogueiros e inúmeras pequenas empresas e PME, com a maior conta gratuita sem restrições:
Portanto, a integração também pode ajudar a obter visibilidade para a empresa integradora.
Além disso, integrar a Mailrelay é muito fácil graças à API para desenvolvedores, e é algo que várias empresas já fizeram, como:
[su_list icon=”icon: asterisk” icon_color=”#008af7″]
- Thrive Leads
- Privy
- MyThemeShop
- Optingun
- Etc.
[/su_list]
Eles já oferecem funcionalidades extras aos seus usuários.
