Este módulo inclui todos os serviços necessários para a criação de Peças e/ou Embarques.

Criar Parte

Permite gerar uma nova Newsletter (Parte) no sistema.

Petição

URL:

*platformdomain deve ser substituído pelo URL da instância

Serviço de internet:

Parâmetros de Solicitação

Solicitar Resposta -> Resultados

Objeto com a seguinte estrutura (JSON) ->

Lista de Códigos de Resposta

Exemplo de PHP

require_once('lib/nusoap.php');
date_default_timezone_set('UTC');
$proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : '';
$proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : '';
$proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : '';
$proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : '';
$useCURL = isset($_POST['usecurl']) ? $_POST['usecurl'] : '0';
$client = new nusoap_client('http://domain.icommarketing.com/Newsletters.asmx?WSDL','wsdl','','','','');
$err = $client->getError();
if ($err) {
echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
exit();
}
$client->setUseCurl($useCURL);
$html = 'HTML';
$html = utf8_decode($html);
$param = Array(
"ApiKey"=>"API_KEY",
"UserName"=>"UserName",
"Campaign"=>"Campaign Name",
"NewsletterName"=>"Newsletter Name",
"Content"=>$html,
"PlainText"=>"test"
);
$result = $client->call('CreateHTML',$param,",",false,true);
// Check for a fault
if ($client->fault) {
echo '<h2>Fault</h2><pre>';
print_r($result);
echo '</pre>';
} else {
// Check for errors
$err = $client->getError();
if ($err) {
// Display the error
echo '<h2>Error</h2><pre>' . $err . '</pre>';
} else {
echo '<h2>Result</h2><pre>';
$auxresponse = json_decode($client->responseData);
echo '<pre>StatusCode' . $auxresponse->{'StatusCode'} . '</pre>';
echo '<pre>Message' . $auxresponse->{'Message'} . '</pre>';
echo '<pre>MessageDetail' . $auxresponse->{'MessageDetail'} . '</pre>';
echo '<pre>Data' . $auxresponse->{'Data'} . '</pre>'; }

}```

# Criar Remessa

Permite acionar uma nova entrega a partir da instância, detalhando o conteúdo a ser enviado e o público ao qual será endereçado.

### Petição

###### URL
| http://dominioplataforma.icommarketing.com/Deliveries.asmx?WSDL
*platformdomain deve ser substituído pelo URL da instância

###### Serviço de internet
| CriarConfiguração

### Parâmetros de Solicitação

| - **ApiKey**: Chave correspondente à instância (Obtenha no módulo de configuração da instância)
| - **UserName**: Nome do usuário de acesso à plataforma
| - **Campanha**: Nome da campanha na qual gerar a peça
| - **NewsletterName**: Nome da peça a gerar
| - **PlainText**: Texto simples da peça
| - **Conteúdo**: conteúdo HTML da peça
| - **FromMail**: Endereço de e-mail do remetente (deve existir na lista de endereços da plataforma)
| - **FromName**: Nome do remetente
| - **ReplyMail**: Endereço de Email de Resposta (deve existir na lista de endereços da plataforma)
| - **Assunto**: Assunto do e-mail
| - **Pré-cabeçalho**: Pré-cabeçalho do e-mail (informações adicionais ao Assunto que alguns programas de e-mail permitem)
| - **Perfis**: lista separada por vírgulas dos PROFILE_KEYs a serem associados ao embarque (obtenha os PROFILE_KEYs na tela PROFILES da plataforma).
| - **StartDate**: Data e Hora do Agendamento do Embarque. O formato deve ser AAAA-MM-DDTHH24:MI:SS.
| - **ViralMarketing**: Propriedade para determinar se você deseja incluir o LINK para que o destinatário possa encaminhar a Newsletter para um amigo. Valores possíveis: verdadeiro ou falso.
| - **Redes Sociais**: Propriedade para determinar QUAIS LINKS serão incluídos para compartilhar nas redes sociais. Este campo deve ser uma string de IDs separados por vírgulas, conforme a seguinte referência:
| * Identificação 1: Facebook
| * Identificação 2: Twitter
| * ID 3: LinkedIN
| * ID 4: Google+
| * ID 5: Pinterest
| **Nota**: Caso não deseje incorporar nenhum ícone para compartilhar nas redes sociais, este campo deve ficar VAZIO.
| - **Teste**: Propriedade para determinar se a remessa é de Teste ou Real. Valores possíveis: verdadeiro ou falso.
| - **SendGoogleAnalyticsData**: Propriedade para determinar se o envio inclui automaticamente os parâmetros de identificação da campanha para o Google Analytics. Valores possíveis: verdadeiro ou falso.

###### Solicitar Resposta -> Resultados

**Objeto com a seguinte estrutura (JSON) ->**
||| **StatusCode**: Código do resultado da operação
||| **Mensagem**: Texto do resultado da operação
||| **MessageDetail**: Detalhes da mensagem de erro quando ela ocorre
||| **Dados**: informações adicionais

### Lista de Códigos de Resposta

||| **(1) Configuração criada**: A configuração de envio foi criada e aprovada com sucesso.
||| **(501) Modelo não encontrado**: O modelo HTML não foi encontrado na instância.
||| **(502) User Not Found**: O UserName enviado não foi encontrado entre os usuários da instância.
||| **(503) Campanha não encontrada**: A campanha enviada não existe.
||| **(504) A campanha não é válida para este usuário**: O usuário enviado não tem acesso à campanha solicitada.
||| **(510) Profile(s) Not Found**: Qualquer um dos PROFILE_KEYs enviados não existe.
||| **(511) Perfil(es) selecionado(s) incompatível(is) com o modelo selecionado**: Os perfis enviados não são compatíveis com a parte enviada. A remessa será abortada.
||| **(550) General Error**: Ocorreu um erro ao gerar a peça, veja os campos Message e MessageDetail para mais informações.


### Exemplo de PHP

```php
require_once('lib/nusoap.php');
date_default_timezone_set('UTC');
$proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : '';
$proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : '';
$proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : '';
$proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : '';
$useCURL = isset($_POST['usecurl']) ? $_POST['usecurl'] : '0';
$client = new nusoap_client('http://domain.icommarketing.com/Deliveries.asmx?WSDL','wsdl','','','','');
$err = $client->getError();
if ($err) {
echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
exit();
}
$client->setUseCurl($useCURL);
$html = 'HTML';
$html = utf8_decode($html);
$param = Array(
"ApiKey"=>"API_KEY",
"UserName"=>"UserName",
"Campaign"=>"Campaign Name",
"NewsletterName"=>"Newsletter Name",
"Content"=>$html,
"PlainText"=>"test",
"FromMail"=>"newsletter@dominionews.com",
"FromName"=>"FromName",
"Subject"=>"Subject",
"ReplyMail"=>" newsletter-reply@dominionews.com ",
"Profiles"=>"PROFILE_KEY1, PROFILE_KEY1",
"StartDate"=>"2014-06-06T17:30:00.000",
"ViralMarketing"=>"true",
"SocialNetworks"=>"1,2,3,4,5",
"Testing"=>"false",
"PreHeader"=>"PreHeader",
"SendGoogleAnalyticsData"=>"true"
);
$result = $client->call('CreateConfiguration',$param,",",false,true);
// Check for a fault
if ($client->fault) {
echo '<h2>Fault</h2><pre>';
print_r($result);
echo '</pre>';
} else {
// Check for errors
$err = $client->getError();
if ($err) {
// Display the error
echo '<h2>Error</h2><pre>' . $err . '</pre>';
} else {
echo '<h2>Result</h2><pre>';
$auxresponse = json_decode($client->responseData);
echo '<pre>StatusCode' . $auxresponse->{'StatusCode'} . '</pre>';
echo '<pre>Message' . $auxresponse->{'Message'} . '</pre>';
echo '<pre>MessageDetail' . $auxresponse->{'MessageDetail'} . '</pre>';
echo '<pre>Data' . $auxresponse->{'Data'} . '</pre>'; }

}```

# Criar envio com notícias pré-existentes
Permite acionar uma nova remessa a partir da instância, utilizando uma peça criada anteriormente.

### Petição

###### URL

| http://dominioplataforma.icommarketing.com/Deliveries.asmx?WSDL

*platformdomain deve ser substituído pelo URL da instância

###### Serviço de internet

| CreateConfigurationWithExistingNews

### Parâmetros de Solicitação

| - **ApiKey**: Chave correspondente à instância (Obtenha no módulo de configuração da instância)

| - **UserName**: Nome do usuário de acesso à plataforma

| - **Campanha**: Nome da campanha na qual gerar a peça

| - **NewsletterName**: Nome da peça a gerar

| - **FromMail**: Endereço de e-mail do remetente (deve existir na lista de endereços da plataforma)

| - **FromName**: Nome do remetente

| - **ReplyMail**: Endereço de Email de Resposta (deve existir na lista de endereços da plataforma)

| - **Subject**: Assunto do e-mail

| - **PreHeader**: Pré-cabeçalho do e-mail (informações adicionais ao Assunto que alguns programas de e-mail permitem)

| - **Profiles**: lista separada por vírgulas dos PROFILE_KEYs a serem associados ao embarque (obtenha os PROFILE_KEYs na tela PROFILES da plataforma).

| - **StartDate**: Data e Hora do Agendamento do Embarque. O formato deve ser AAAA-MM-DDTHH24:MI:SS.

| - **ViralMarketing**: Propriedade para determinar se você deseja incluir o LINK para que o destinatário possa encaminhar a Newsletter para um amigo. Valores possíveis: verdadeiro ou falso.

| - **SocialNetworks**: Propriedade para determinar QUAIS LINKS serão incluídos para compartilhar nas redes sociais. Este campo deve ser uma sequência de IDs separados

| por vírgulas, conforme a seguinte referência:

| * ID 1: Facebook

| * ID 2: Twitter

| * ID 3: LinkedIN

| * ID 4: Google +

| * ID 5: Pinterest

| - **Nota**: Caso não deseje incorporar nenhum ícone para compartilhar nas redes sociais, este campo deve ficar VAZIO.

| - **Teste**: Propriedade para determinar se a remessa é de Teste ou Real. Valores possíveis: verdadeiro ou falso.

| - **SendGoogleAnalyticsData**: Propriedade para determinar se o envio inclui automaticamente os parâmetros de identificação da campanha para o Google

| Análise. Valores possíveis: verdadeiro ou falso.

###### Solicitar Resposta -> Resultados


**Objeto com a seguinte estrutura (JSON) ->**

||| **StatusCode**: Código do resultado da operação

||| **Mensagem**: Texto do resultado da operação

||| **MessageDetail**: Detalhes da mensagem de erro quando ela ocorre

||| **Dados**: informações adicionais

### Lista de códigos de resposta

||| **(1) Configuração criada**: A configuração de envio foi criada e aprovada com sucesso.

||| **(502) User Not Found**: O UserName enviado não foi encontrado entre os usuários da instância.

||| **(503) Campanha não encontrada**: A campanha enviada não existe.

||| **(504) A campanha não é válida para este usuário**: O usuário enviado não tem acesso à campanha solicitada.

||| **(505) NewsletterName não foi encontrado**: A newsletter solicitada para associar à entrega não foi encontrada.

||| **(510) Profile(s) Not Found**: Qualquer um dos PROFILE_KEYs enviados não existe.

||| **(550) General Error**: Ocorreu um erro ao gerar a peça, veja os campos Message e MessageDetail para mais informações.

### Exemplo de PHP

```php
require_once('lib/nusoap.php');
date_default_timezone_set('UTC');
$proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : '';
$proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : '';
$proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : '';
$proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : '';
$useCURL = isset($_POST['usecurl']) ? $_POST['usecurl'] : '0';
$client = new nusoap_client('http://domain.icommarketing.com/Deliveries.asmx?WSDL','wsdl','','','','');
$err = $client->getError();
if ($err) {
echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
exit();
}
$client->setUseCurl($useCURL);
$html = 'HTML';
$html = utf8_decode($html);
$param = Array(
"ApiKey"=>"API_KEY",
"UserName"=>"UserName",
"Campaign"=>"Campaign Name",
"NewsletterName"=>"Newsletter Name",
"FromMail"=>"newsletter@dominionews.com",
"FromName"=>"FromName",
"Subject"=>"Subject",
"ReplyMail"=>" newsletter-reply@dominionews.com ",
"Profiles"=>"PROFILE_KEY1, PROFILE_KEY1",
"StartDate"=>"2014-06-06T17:30:00.000",
"ViralMarketing"=>"true",
"SocialNetworks"=>"1,2,3,4,5",
"Testing"=>"false",
"PreHeader"=>"PreHeader",
"SendGoogleAnalyticsData"=>"true"
);
$result = $client->call('CreateConfigurationWithExistingNews',$param,",",false,true);
// Check for a fault
if ($client->fault) {
echo '<h2>Fault</h2><pre>';
print_r($result);
echo '</pre>';
} else {
// Check for errors
$err = $client->getError();
if ($err) {
// Display the error
echo '<h2>Error</h2><pre>' . $err . '</pre>';
} else {
echo '<h2>Result</h2><pre>';
$auxresponse = json_decode($client->responseData);
echo '<pre>StatusCode' . $auxresponse->{'StatusCode'} . '</pre>';
echo '<pre>Message' . $auxresponse->{'Message'} . '</pre>';
echo '<pre>MessageDetail' . $auxresponse->{'MessageDetail'} . '</pre>';
echo '<pre>Data' . $auxresponse->{'Data'} . '</pre>'; }

}```

Atualizado em: 02/02/2024