Correções e Ajustes

• Alterado os métodos editionCreate e editionUpdate para que os links da edição iniciados em "%" (percentual) não sejam mapeados, para correta interpretação das "tags" de customização do sistema (exemplos: %SHOWEDITION%, %CANCEL%, %ABUSE%, %REFERFRIENDS%), durante o envio da campanha.

Novos recursos

• Adicionado o método contactBatchCreate, similiar ao método contactBatchSubscribe, que permite cadastrar mais de um contato por requisição junto à API do emailmanager, porém, informando os dados de cada contato a partir de um array associativo, serializado em PHP ou JSON, onde a "chave" é o campo desejado (name, email, gender, phone, extra1, etc...) e o conteúdo é o valor a ser cadastrado junto ao campo desejado. Para que o cadastro ocorra corretamente, o campo "email" é obrigatório em todos os registros, bem como o parâmetro "group_id", que informa o grupo onde os contato serão cadastrados e/ou afiliados.

Correções e Ajustes

• Alterado o método authentLogin para que seja possível efetuar a autenticação na API utilizando como "username", tanto "login" quanto "e-mail", para recuperar a ApiKey para requisição dos demais métodos.

Novos recursos

• Alterados métodos de listagem e pesquisa de campanhas e edições - campaigns, editions - para listar também as edições do tipo "Auto-Resposta", "Teste A/B" e "RSS por E-mail", bem como seus relatórios de interações pelos métodos reportEditions e reports.

Correções e Ajustes

• Corrigidos parâmetros do método editions na documentação da API, substituindo os parâmetros inexistentes ("date_begin", "date_end") pelos parâmetros corretos ("date_creation", "date_modified", "date_send"), permitindo filtragem e ordenação do resultado pelos mesmos.

Novos recursos

• Adicionado o método reportAbuses, similar ao método reportEditionAbuses, que retorna uma listagem de denúncias de "abuso" e de "spam" já registradas no sistema, permitindo filtro por "contato" e "edição", facilitando a recuperação por todas as denúncias do sistema.


• Adicionado o método reportEditionUnsubscribes, similar ao método reportUnsubscribes, que retorna uma listagem de "descadastros" e "cancelamentos" já registradas no sistema, permitindo filtro por "contato" e "edição", facilitando a recuperação por todos os descadastrados e cancelamentos do sistema.

Correções e Ajustes

• Corrigido método reportEditionStats, que não estava agrupando os registros de envio por edição, referente aos envios recorrentes das edições do tipo "Auto-Resposta", "Teste A/B" e "RSS por E-mail" na contabilização dos dados de envio, não refletindo a quantidade real dos períodos.


• Corrigidos os métodos reportEditionGeoCountry e reportEditionGeoRegion, que não estava agrupando os registros de envio por edição, referente aos envios recorrentes das edições do tipo "Auto-Resposta", "Teste A/B" e "RSS por E-mail" na contabilização dos dados de envio, não refletindo a quantidade real dos períodos.


• Removido método reportContactAbuses e parâmetros "account_id", "marketing_id" e "comment" do método reportEditionAbuses, pois não são mais registrados estes valores em conjunto com as denúncia, conservando o e-mail, para que a referência esteja sempre presente, mesmo após a exclusão do contato.

Correções e Ajustes

• Corrigido método reportGroupStats, que não estava considerando os novas situações dos contatos como "soft bounces" e "hard bounces", gerando inconsistência na contagem de registros dos grupos.


• Corrigido método reportStats, que não estava agrupando os registros de envio por data, referente aos envios recorrentes das edições do tipo "Auto-Resposta", "Teste A/B" e "RSS por E-mail" na contabilização dos dados de envio, não refletindo a quantidade real dos períodos.


• Removido parâmetro "group_id" dos métodos reportSents, reportViews, reportClicks, reportBounces e reportUnsubscribes das consultas e do retorno de dados, pois a mesma não é mais relacionada com os registros de interação dos contatos.


• Removido parâmetro "group_id" dos métodos reportContactSents, reportContactViews, reportContactClicks, reportContactSoftBounces, reportContactHardBounces e reportContactUnsubscribes das consultas e do retorno de dados, pois a mesma não é mais relacionada com os registros de interação dos contatos.


• Removido parâmetro "group_id" dos métodos reportEditionSents, reportEditionViews, reportEditionClicks, reportEditionSoftBounces, reportEditionHardBounces e reportEditionAbuses das consultas e do retorno de dados, pois a mesma não é mais relacionada com os registros de interação dos contatos nas edições.


• Removido método "reportContactGroupStats" dos métodos de relatório dos contatos, pois recebe os mesmo parâmetros e retorna os mesmos dados do método reportGroupStats, corrigido na última publicação da API.

Novos recursos

• Adicionado o parâmetro "email" ao métodos contacts, permitindo assim, que seja efetuada a consulta de um ou mais registros de contatos a partir de uma expressão sobre o campo "email", retornados em uma listagem. Ex: "helpdesk@%", "%@emailmanager.com" ou "helpdesk@emailmanager.com".

Correções e Ajustes

• Corrigidos métodos campaigns, campaignCount, campaignCreate, campaignUpdate e campaignDelete, que estavam manipulando a listagem de campanhas de todos os outros tipos de envio não presentes na API do emailmanager e referenciando incorretamente o parâmetro "parent_id", gerando algumas inconsistências.


• Corrigidos métodos editions, editionCount, editionContent, editionCreate, editionUpdate, editionCancel, editionSchedule, editionSendNow, editionPause, editionResume e editionClone que estavam manipulando a listagem de edições de todos os outros tipos de envio não presentes na API do emailmanager e referenciando incorretamente o parâmetro "campaign_id", gerando algumas inconsistências.


• Corrigido método editionFolderUpdate, alterando o nome do parâmetro "group_id" para "folder_id" na documentação da API e efetuando a correta atualização dos dados do registro na base do cliente.


• Removido método editionTemplates (depreciado) e que não retornava os templates relacionados às últimas atualizações envolvendo as novas técnicas de anti-spam e desempenho efetuadas junto ao sistema.


• Corrigida exibição e cadastro das datas de controle dos registros manipulados pela API do emailmanager - date_creation e date_modified - para GMT-0, nas áreas de "Campanhas", "Edições", "Grupos" e "Contatos", para correta exibição destas datas no sistema, formatadas de acordo com o "timezone" definido.

Novos recursos

• Adicionado o método contactStatus aos Métodos de "Contatos", que retorna uma listagem com as possíveis "situações" que o contato pode possuir junto ao sistema e que é retornado como código nos métodos de listagem de contatos e informações do contato.

Correções e Ajustes

• Corrigido método groupContacts, relacionado à listagem com o código dos contatos afiliados em determinado grupo, que não estava sendo executado corretamente devido à otimização efetuada na tabela de afiliações, para agilizar o processo de consulta dos dados.

Correções e Ajustes

• Corrigidos métodos relacionados ao cadastro, atualização e afiliação dos contatos - contactCreate, contactUpdate, contactSubscribe, contactBatchSubscribe - para a nova estrutura do banco de dados, otimizada para que o cadastro e afiliação dos contatos ocorra em um intervalo de tempo menor.

Correções e Ajustes

• Adicionado o parâmetro "name" aos métodos editionAccountCreate e editionAccountUpdate, para cadastro e atualização do campo referente à identificação da conta de envio no sistema. Também foi corrigida a descrição do campo "label", referente ao nome do remetente, para exibição nos e-mails enviados.
  
  OBS: Caso o parâmetro "name" não seja informado, será definido o mesmo valor definido no campo "label".


• Adicionados nas descrições dos parâmetros referentes à data e hora (datetime) a informação referente ao fuso horário a ser considerado (sempre como "GMT-0"). Também foi adicionado às descrições dos parâmetros "content_html" e "content_txt", que os mesmos devem ser passados formatados com "URL Encode", para que o conteúdo não fique incompleto ao ser cadastrado no sistema, gerando problemas na exibição do mesmo.

Novos recursos

• Adicionado o método contactBatchSubscribe aos Métodos de "Contatos", que permite o cadastro e a afiliação de mais de um registro em uma única requisição.
  
  Caso um ou mais e-mails informados não existam na base do cliente, eles serão cadastrados e afiliados ao grupo informado pelo parâmetro "group_id", caso já exista, será apenas afiliado ao grupo.
  
  O método retorna como resultado, uma lista com os e-mails informados e seus respectivos IDs de cadastro, indicando que o cadastro e/ou afiliação dos mesmos ocorreu com sucesso.
  
  Caso ocorra um erro durante o processamento de um ou mais contatos durante o processo de cadastro ou afiliação, estes serão retornados com o e-mail e o valor "false" ao invés do registro de cadastro.

Novos recursos

• Adicionados os metadados (campos personalizados) do cadastro de contato do sistema para manipulação e retorno pela API (campos Extras e campos de Identificação).
  
  
  Os métodos atualizados, com a adição do retorno e manipulação dos novos campos, são os seguintes:
  - contacts
  - contactInfo
  - contactCreate
  - contactUpdate

Correções e Ajustes

• Padronizado retorno de alguns valores padrões referente ao cadastro dos contatos, como "vazio" para "0", no caso de retorno do tipo "inteiro".
  
  
  Os métodos e campos atualizados são os seguintes:
  - contacts - campo: rating
  - contactInfo - campo: rating
  - groups - campo: rating
  - reportGroupStats - campo: rating


• Corrigidos métodos "contactSubscribe", "contactUnsubscribe" e "contactUpdate" relacionados à área de Contatos para que não sejam efetuadas subscrições duplicadas em um grupo e para que sejam redefinidas as afiliações ao alterar o registro do contato, caso informado o parâmetro "groups_id" com as novas afiliações.

Novos recursos

• Disponibilizada versão 1.0 Beta da API para acesso e uso geral pelos usuários do sistema emailmanager.