templateria/zenmail-php

Zenmail PHP API Client

dev-master 2019-07-23 19:03 UTC

README

Zenmail é a ferramenta de envio de email marketing criada pela Templateria. Esta biblioteca PHP é um cliente de sua API que permite a automação de qualquer recurso disponível no painel web.

O próprio painel do Zenmail consome sua API - essa é a nossa maneira de garantir uma API completa e fácil de usar.

Instalação

Usando Composer:

composer require templateria/zenmail-php

Autenticação

Solicite um token de acesso ao suporte enviando um email para suporte@zenmail.com.br.

Introdução

Todas as requisições à API passam por uma instância de Zenmail\Client:

$zenmail = new Zenmail\Client([
    'token'      => 'seu token aqui'
    'account_id' => 9999
])

Através de interfaces fluentes, você acessa todos os recursos disponíveis na API:

$contact = $zenmail->contacts->get('pedro@templateria.com'); // obtém um contato pelo email
$contact = $zenmail->contacts->get(58978456);                // ou então diretamente pelo ID

Roadmap

Esta biblioteca encontra-se em estágio inicial de desenvolvimento. Estão disponíveis as seguintes operações:

Contatos [x] criar contatos [x] listar contatos [x] buscar contatos [x] remover contatos [x] atualizar contatos

Gerenciamento de Contatos

Criar um Contato

$zenmail->contacts->create([
    'email'   => 'pedro@templateria.com',
    'details' => ['nome' => 'Pedro']
]);

Obter um Contato

$contact = $zenmail->contacts->get('pedro@templateria.com'); // obtém um contato pelo email
$contact = $zenmail->contacts->get(58978456);                // ou então diretamente pelo ID

Listar Contatos (com busca por email)

// retorna todos os contatos do domínio templateria.com
$zenmail->contacts->find(['email' => '@templateria.com']);

Atualizar um Contato

$zenmail->contacts->update($contact->id, [
    'details' => [
        'nome'      => 'Pedro',
        'sobrenome' => 'Padron',
        'empresa'   => 'Templateria'
    ]
]);

Remover um Contato

$zenmail->contacts->delete($contact->id);

Campanhas

Obter uma Campanha

$zenmail->campaigns->get(12345);

Listar Campanhas

foreach ($zenmail->campaigns->all() as $campaign) {
    echo 'Campanha #' . $campaign->id . ': ' . $campaign->subject;
}
$page = 1;

do {
    $campaigns = $zenmail->campaigns->find(['page' => $page]);
    $lastPage  = $campaigns->getPaginationData()->last_page;
    foreach ($campaigns as $campaign) {
        echo 'Campanha #' . $campaign->id . ': ' . $campaign->subject . "\n";
    }
    $page++;
} while ($page <= $lastPage);

Criar uma Campanha

$campaign = $zenmail->campaigns->create([
    'recipients' => 'lists',
    'list_ids'   => [329104],
    'subject'    => 'Novidades do Zenmail',
    'from_name'  => 'Zenmail',
    'from_email' => 'suporte@zenmail.com.br',
    'html'       => $html,
]);

Enviando uma Campanha

$zenmail->campaigns->send($campaign->id);

Editando uma Campanha

$campaign = $zenmail->campaigns->update([
    'recipients' => 'all'
]);

Remover uma Campanha

$zenmail->campaigns->delete($campaign->id);

Suporte

Acesse nossa documentação para saber mais sobre o Zenmail e envie um email para suporte@zenmail.com.br caso tenha alguma dúvida.

Segurança

Para questões de segurança como vulnerabilidades encontradas ou outros assuntos, envie um email para suporte@zenmail.com.br.

Changelog

Detalhes sobre cada versão desta biblioteca estão disponíveis no arquivo CHANGELOG.md.

Licença

MIT License. Copyright 2019 Templateria Ltda. Por favor, veja o Arquivo de Licença para mais informações.