Mailee.me Help

1 A chave de acesso

O primeiro passo para usar a integração PHP é pegar sua chave de acesso a API do Mailee. Ele gera uma chave secreta para cada cliente. Tome muito cuidade com esta chave, ela é tão ou mais importante que a sua senha. Com ela, alguém mal intencionado poderá ter acesso aos seus clientes. Para pegar esta chave, vá em configuração, depois em integração e por fim em rest.

Integrar

REST

Com a chave em mãos, você pode criar os primeiros contatos via código. O primeiro passo é incluir a biblioteca e configurar a chave:


  require 'Mailee.php';
  define('MAILEE_CONFIG_SITE', 'YOUR KEY');

2 Contatos

2.1 Criando


  $contact = new MaileeContact(array(
    'name' => 'Harry Seldon', 
    'email' => 'seldon@terminus.com', 
    'internal_id' => 412905575
    ));
  $contact->save();

2.2 Buscando

Buscar todos:


  $table = new MaileeContact();
  $contacts = $table->find('all');
  echo count($contacts . "\n");
  foreach($contacts as $c){
    echo $c->email . "\n";
  }

Buscar o primeiro:


  $contact = new MaileeContact();
  print_r($contact->find('first'));

Buscar pelo id da sua aplicação (se você salvou o contato com ele):


  $contact = new MaileeContact();
  print_r($contact->find_by_internal_id('412905575'));

Buscar pelo id interno do Mailee:


  $contact = new MaileeContact();
  $contact->find('412905575');

Buscando pelo email:


  $contact = new MaileeContact();
  $contact->find('first', array('email' => 'joao@gmail.com'));

2.3 Adicionando a uma lista

Se você ainda não criou nenhuma lista, veja aqui antes.

Você pode adicionar o contato a uma lista informando a ID da lista.


  $contact->list_subscribe(array('list_id' => '22110'));

Ou você pode adicionar o contato a uma lista informando o nome da lista.


  $contact->list_subscribe(array('list' => 'Nome da Lista'));

2.4 Removendo de uma lista

Exatamente o mesmo se aplica a remoção de um contato da lista. As duas abordagens funcionam:


  $contact->list_unsubscribe(array('list_id' => '22110'));
  $contact->list_unsubscribe(array('list' => 'Nome da Lista'));

3 Listas

3.1 Criando

Para criar uma lista através da API, você pode fazer assim:


  $list = new MaileeList(array('name' => 'Active Users'));
  $list->save();

3.2 Buscando


  $list = new MaileeList();
  $list->find('all');

4 Mensagens

4.1 Criando a mensagem

Para enviar mensagens através da API, você pode fazer assim:


  $m = new MaileeMessage(array(
    'from_name' => 'João', 
    'from_email' => 'joao@mailee.me', 
    'title' => 'Teste PHP', 
    'subject' => 'Teste PHP', 
    'emails' => 'emaildojoao@gmail.com', 
    'html' => 'Teste'
    ));
  $m->save();

Lembre-se que é sempre necessário salvar a mensagem para poder seguir para as próximas ações.

4.2 Enviando testes

Ao enviar os testes é necessário especificar o id de cada um dos contatos que deve receber a mensagem.


  $m->test(array(1394,2839034,5242423));

4.3 Disparando a mensagem agora

Para iniciar o envio da mensagem o código abaixo deve ser utilizado:


  $m->ready();

4.4 Agendando o envio

Nesse caso é necessário especificar qual a data e a hora em que a mensagem deve ser enviada.


  $m->ready('after','2012-12-24','08');

Outras ações também são possíveis, dê uma olhada no código do arquivo Mailee.php.

O código desta integração ainda é beta. Se você for utilizá-lo não esqueça de compartilhar sua experiência ou mesmo suas contribuições conosco.

Integração com PHP

Capítulos