IBM emessage Versão 8 Release 6 19 de fevereiro de Transactional Administration Guide

Transcrição

1 IBM emessage Versão 8 Release 6 19 de fevereiro de 2014 Transactional Administration Guide

2 Nota Antes de usar essas informações e o produto que elas suportam, leia as informações em Avisos na página 43. Esta edição se aplica à versão 8, liberação 6, modificação 0 do IBM emessage e a todas as liberações e modificações subsequentes até que seja indicado de outra forma em novas edições. Copyright IBM Corporation 1999, 2014.

3 Índice Capítulo 1. Sobre o emessage e transacional Usando o emessage para enviar transacional. 1 Como o transacional funciona no emessage 2 Envio de Correio Transacional e Envio de Correio Padrão Comparados Design de mensagens para transacional.. 5 Informações de Destinatários para Transacional Supressão de global e transacional.. 7 Anexos no transacional O que Divulgadores de Fazem para Transacional Sobre como Ativar Envios de Correio para Transacional Sobre como Responder a Erros Relacionados a Transacional o que os desenvolvedores de aplicativos fazem para transacional Capítulo 2. Integração ao serviço de transacional do emessage Identificação de eventos de transação Acesso a dados do destinatário Conexão com o emessage TMS Endereços do emessage TMS WSDL para transacional do emessage.. 15 Sobre como fornecer credenciais de autenticação para transacional Anexos em solicitações de transacional Construção da solicitação de transacional.. 18 mailingcode audienceid Campos Códigos de Células additionaloptions Anexos Rastreando Campos localidade username Senha Capítulo 3. A API do emessage Transactional Mailing Service NameValuePair Resposta AdvisoryMessage Mensagens de Erro para Transacional Apêndice A. Amostra de programa cliente de transação de primeira geração Apêndice B. Amostra de cliente de segunda geração Apêndice C. Sobre imagens transacionais dinâmicas Utilizando imagens transacionais dinâmicas em mensagens de transacionais Definindo um rótulo da imagem para imagens transacionais dinâmicas Como especificar imagens transacionais dinâmicas na solicitação de transacional.. 39 Antes de entrar em contato com o suporte técnico do IBM Avisos Marcas Registradas Considerações de Política de Privacidade e Termos de Uso Copyright IBM Corp. 1999, 2014 iii

4 iv IBM emessage: Transactional Administration Guide

5 Capítulo 1. Sobre o emessage e transacional Um transacional é um único enviado em resposta a uma transação pré-determinada específica detectada em seus sistemas de negócios. A IBM fornece o emessage Transactional Mailing Service (TMS) como um serviço da web hospedado para processar s transacionais. Os comerciantes por trabalham com os desenvolvedores de aplicativos para integrar sistemas de gerenciamento de transações corporativas com o emessage TMS. O envio de transacional permite que responder automaticamente às atividades específicas ou relacionadas ao cliente com uma mensagem personalizada. s transacionais tendem a ter taxas de abertura mais altas do que outros tipos de s de marketing. Os destinatários da mensagem mais provavelmente abrirão um relacionado que eles reconheçam ou que esperam ao invés de abrir um não solicitado. É possível utilizar qualquer evento que possa detectar em seus sistemas de negócios para solicitar um transacional. Por exemplo, é possível enviar um transacional quando um indivíduo assina sua newsletter mensal ou solicita informações em resposta a uma campanha de marketing por . Os tópicos a seguir fornecem uma visão geral do emessage TMS e das funções exercidas pelos comerciantes por e desenvolvedores de aplicativos ao usar transacional. v Usando o emessage para enviar transacional v O que Divulgadores de Fazem para Transacional na página 8 v o que os desenvolvedores de aplicativos fazem para transacional na página 10 Usando o emessage para enviar transacional Implementar transacional requer a colaboração entre comerciantes por e desenvolvedores de aplicativos. Todas as partes devem ter um entendimento geral dos sistemas e do fluxo de trabalho necessários. Todos os envolvidos devem estar familiarizados com as várias funções que cada contribuidor desempenha na implementação de transacional. Usar o emessage para enviar transacional envolve as seguintes atividades e sistemas. Identificar transações que requerem uma resposta de automatizada A equipe de marketing por determina os tipos de transações que requerem uma resposta de automatizada. O transacional é baseado no conteúdo da mensagem e nas informações do destinatário referenciados em uma correspondência padrão do emessage. É possível ativar qualquer correspondência padrão para transacional. Para obter detalhes, consulte Sobre como Ativar Envios de Correio para Transacional na página 9. Copyright IBM Corp. 1999,

6 emessage Transactional Mailing Service O IBM hospeda o emessage Transactional Mailing Service (TMS) como um serviço da web para processar automaticamente solicitações de transacional. Desenvolva sistemas para monitorar transações e solicitar transacional Os desenvolvedores de aplicativos devem criar um aplicativo cliente que receba notificações de transação a partir de sistemas de negócios corporativos e envie as solicitações de serviço da web utilizando SOAP para o emessage TMS. As mensagens de transacionais enviadas usando o emessage podem incluir anexos. As solicitações devem fornecer dados de personalização e conteúdo do anexo. Como o transacional funciona no emessage Divulgadores de usam a Campaign e o emessage para configurar mensagens e ativar envios de correio para transacional. Os desenvolvedores de aplicativos criam um cliente de transacional e o integra a outros sistemas de negócios. A tabela a seguir descreve os sistemas do IBM EMM e do IBM EMM Hosted Services instalados localmente operam juntos para enviar transacional. 2 IBM emessage: Transactional Administration Guide

7 Elemento A IBM Campaign B C D E F O Campaign fornece interfaces para editar , configurar correspondências e ativar correspondências para transacional. Correspondência do emessage A configuração de correspondência referencia um documento de que fornece conteúdo da mensagem, incluindo campos de personalização que servem como marcadores para dados do destinatário. Seus sistemas de negócios e bancos de dados corporativos Vários sistemas e bancos de dados de negócios podem fornecer os dados de personalização e informações do anexo necessários por um transacional. Seus sistemas de monitoramento de transação Os aplicativos transacionais corporativos monitoram sistemas de negócios para detectar os tipos de transações que acionam um transacional. É possível usar quase todas as atividades de negócios como um acionador para um transacional. Os administradores do sistema configuram os sistemas de monitoramento para detectarem as transações especificadas e fornecerem informações de personalização de . Cliente de transacional local Aplicativo cliente que envia solicitações de serviço da web para o emessage Transactional Mailing Service (TMS). O IBM fornece um WSDL para uso como um guia de desenvolvimento para criar o cliente. O cliente reside em sua rede local. Ele não faz parte do emessage TMS. emessage Transactional Mailing Service (TMS) Um serviço da web que reside no IBM EMM Hosted Services. O serviço recebe e processa solicitações de transacional do cliente de transacional local. Atividade Relacionada 1 A equipe de marketing por ativa uma correspondência (B) para transacional. Qualquer correspondência padrão pode ser ativada para transacional. A configuração de correspondência contém o código de correspondência que o emessage usa para identificar o . O código de correspondência é necessário para solicitações de transacional. Os comerciantes por devem comunicar o código de correspondência para os desenvolvedores de aplicativos que criarem o cliente de transacional local (E). 2 Uma transação ocorre em seus sistemas de negócios (C). A transação é considerada uma transação de evento Os comerciantes por e desenvolvedores de aplicativos são consultados antecipadamente para identificar os dados de personalização e anexos necessários para responder a um evento de transação. O sistema de monitoramento da transação (D) faz o seguinte. v Detecta o evento de transação v v Reconhece que o tipo de evento foi designado como um tipo que requer uma resposta de Fornece os dados de personalização e o conteúdo do anexo necessários para o cliente de transacional (E) 3 O cliente do TMS fornece credenciais de acesso para o IBM EMM Hosted Services em uma solicitação SOAP sobre HTTPS para o emessage TMS (F). A solicitação especifica o código de correspondência do emessage e fornece os valores de todos os campos de personalização contidos no . A solicitação também inclui anexos, conforme necessário. 4 O emessage TMS revisa a solicitação de serviço da web. Se a solicitação fornecer todas as informações necessárias, o emessage TMS encaminhará a solicitação, incluindo anexos, para a infraestrutura de correspondência do emessage (G) para transmissão. Se o TMS encontrar um problema, ele retornará uma mensagem de erro para o aplicativo cliente local descrevendo o problema. Capítulo 1. Sobre o emessage e transacional 3

8 Elemento G emessageinfraestrutura de correspondência Os componentes e servidores do emessage mantidos no datacenter do IBM que montam e transmitem as mensagens de transacional utilizando SMTP. Atividade Relacionada 5 O emessage transmite e rastreia um personalizado único endereçado ao destinatário identificado na solicitação de . A instalação local do Campaign recupera dados de contato e de resposta e os armazena nas tabelas de sistema do emessage. Envio de Correio Transacional e Envio de Correio Padrão Comparados O emessage constrói e envia s transacionais de forma diferente do que personalizado padrão. Durante uma execução de envio de correio padrão, o sistema processa volumes grandes potencialmente de s personalizados individualmente. No entanto, para transacional, o emessage executa as mesmas operações de personalização para diversas solicitações de serviço da web, mas cada solicitação processa somente um por vez. É possível ativar qualquer envio de correio padrão do emessage para transacional. A maioria dos recursos de envio de correio disponíveis para envios de correio padrão permanece disponível quando o envio de correio é ativado para transacional. Elementos de conteúdo disponíveis no padrão, como campos de personalização, imagens, fragmentos de HTML e hiperlinks também estão disponíveis no transacional. No entanto, existem algumas diferenças nos recursos de envio de correio disponíveis no padrão e no transacional. A tabela a seguir compara recursos-chave disponíveis em padrão e transacional. Envio de correio Envio de correio Recurso padrão transacional Transmitir versões HTML, HTML e texto e somente texto. X X Tabela de Lista de Saída (OLT) para especificar dados de personalização X A OLT contém todos os dados de destinatários usados para personalizar . Não usado. Pode ser utilizado para teste. Campos de Personalização da OLT X X Campos de Personalização Integrados X X Campos de personalização de constante (constantes) X X Conteúdo condicional X X Script avançado para X X Visualização da mensagem X X Visualização não disponível para anexos. Os resultados do envio de correio aparecem nos relatórios de X X desempenho padrão do emessage Rastrear links em s X X Rastreamento de ID do Público como um atributo de contato X X 4 IBM emessage: Transactional Administration Guide

9 Recurso Envio de correio padrão Envio de correio transacional Usar campos de personalização para rastreamento de contato X X Parâmetros adicionais da URL para rastreamento de link X X Supressão de Global X Relatório Monitoramento de Capacidade de Entrega X Anexos do X Design de mensagens para transacional Cada de correio que você ativar para transacional deve referenciar um documento do emessage. Qualquer documento do emessage criado para uso em uma correspondência padrão também pode ser enviado como um transacional. O documento do emessage define o conteúdo da mensagem de , incluindo texto, imagens, links e conteúdo condicional. O documento de também contém campos de personalização que funcionam como marcadores para dados específicos para o destinatário de , incluindo endereços de . Como parte da solicitação de transacional, o cliente de transacional local fornece o código de correspondência exclusivo que identifica a correspondência. O emessage usa esse código para determinar qual documento de ele deve utilizar para criar o transacional. A solicitação de transacional também deverá fornecer os valores necessários para preencher os campos de personalização no documento do emessage que a correspondência referencia. Se todos os valores de personalização necessários não estiverem presentes na solicitação, o emessage não processará o transacional e o sistema retornará um erro. Os comerciantes por e desenvolvedores de aplicativos devem revisar cada design de mensagem antecipadamente para assegurar que a solicitação de forneça todas as informações necessárias. Se o design do documento alterar, por exemplo, para alterar as informações de personalização na mensagem, o design da solicitação de transacional deverá ser atualizado para refletir a mudança. Sobre a identificação do remetente do transacional O documento de utilizado em um transacional deve conter um endereço De que é exibido para o destinatário. Se especificar o endereço De usando um campo de personalização, o domínio de do endereço deverá corresponder ao domínio de registrado com o IBM para sua conta do emessage. Informações de Destinatários para Transacional Para personalizar transacional, deve-se fornecer informações do destinatário na solicitação de serviço da web que é enviada para o Transactional Mailing Service (TMS). Diferente de outras formas de de marketing personalizado que é possível enviar por meio do IBM EMM Hosted Services, s transacionais não recuperam informações de destinatário de uma Tabela de lista de saída (OLT). Os comerciantes por e designers de aplicativo devem assegurar que o cliente de transacional local possa fornecer valores para preencher todos os campos de personalização que são utilizados no transacional. Cada solicitação de Capítulo 1. Sobre o emessage e transacional 5

10 serviço da web fornece informações de endereço e de personalização que são específicas para o destinatário da mensagem. É possível ativar um padrão existente de correio para enviar mensagens como transacional. No entanto, não é necessário fazer referência a uma OLT para utilizar uma correspondência padrão para enviar transacional. As informações do destinatário necessárias para o transacional estão contidas na solicitação de serviço da web. Conceitos relacionados: Capítulo 2, Integração ao serviço de transacional do emessage, na página 13 Construção da solicitação de transacional na página 18 O que Divulgadores de Fazem para Transacional na página 8 Campos de personalização usados em um transacional O cliente de transacional local identifica cada campo de personalização como um par nome-valor separado na solicitação de serviço da web que ele envia para o serviço de correspondência transacional hospedado. O aplicativo cliente deve especificar o nome de cada campo de personalização que estiver contido na mensagem de . O cliente também deve acessar os sistemas e bancos de dados de negócios que fornecem os valores de personalização necessários. A correspondência que você ativa para transacional deve referenciar um documento de . O documento fornece a estrutura e o conteúdo do transacional. O documento também inclui os nomes dos campos de personalização que são incluídos na mensagem. Os campos de personalização são incluídos no documento como marcadores que aceitam informações específicas sobre o destinatário de quando o serviço de correio é montado e transmite a mensagem. A guia de envio de correio de resumo fornece um campo rotulado como Lista de campos completa para esta correspondência para identificar os campos de personalização que estão incluídos no documento de que é referenciado pela correspondência. A solicitação de serviço da web deve conter informações para cada um dos campos na lista. Os nomes dos campos de personalização na solicitação de serviço da web devem corresponder exatamente aos nomes que aparecem no documento. A solicitação de serviço da web deve também fornecer os dados necessários para concluir a mensagem, incluindo os valores de cada campo de personalização que é incluído na mensagem. A equipe de marketing por deve consultar os desenvolvedores de aplicativos para identificar e localizar todas as informações que o cliente de transacional deve fornecer. O serviço de correspondência transacional avalia cada solicitação de serviço da web para determinar se a solicitação fornece todos os pares nome-valor que são necessários para o transacional. A solicitação falha se os nomes, valores ou tipos de dados dos campos de personalização não corresponderem aos requisitos do . Conceitos relacionados: O que Divulgadores de Fazem para Transacional na página 8 6 IBM emessage: Transactional Administration Guide

11 Campos de personalização para rastreamento de link ou de contato adicional no transacional Se solicitar que o IBM execute um rastreamento de link ou de contato adicional, cada solicitação de transacional deverá incluir o nome e o valor dos campos de personalização que são usados para rastreamento adicional. A solicitação de serviço da web para transacional deve incluir parâmetros que especifiquem o nome e o valor dos campos de personalização de rastreamento. A equipe de marketing por deve fornecer aos desenvolvedores de aplicativos as informações a seguir. v Nomes dos campos de personalização de rastreamento v Valores e tipos de dados esperados dos campos de personalização v Restrições de formato ou comprimento O emessage não valida a exclusividade dos campos especificados para rastreamento adicional. Para distinguir os dados de rastreamento adicionais para transacional dos dados que são coletados para padrão, estabeleça procedimentos internos ou convenções de nomenclatura para assegurar nomes de campos de personalização exclusivos. Evite especificar o mesmo nome de campo de personalização para rastreamento de link ou de contato em envios de correio padrão e envios de correio transacionais. Supressão de global e transacional O IBM emessage não aplica supressões de global a solicitações de transacional. Para evitar a violação de leis referentes à entrega de indesejado, como CAN-SPAM, você deve deixar seus sistemas transacionais cientes de endereços de que não devem recebem . Evitar a transmissão de transacional para endereços incorretos ou que cancelaram assinatura também pode evitar problemas de capacidade de entrega causados por destinatários que marcam o transacional como indesejado. Anexos no transacional O emessage TMS suporta anexar arquivos a s transacionais. Ao anexar arquivos ao transacional, é possível fornecer ao destinatário do informações personalizadas adicionais. Por exemplo, é possível enviar um transacional para confirmar uma compra de ingressos para um concerto e usar anexos para fornecer um ingresso para impressão e um mapa dos assentos. Não é possível especificar anexos para envios de correio padrão. Ao ativar um envio de correio para transacional, você deve especificar quantos anexos deseja enviar com o . O emessage impõe limites para o tamanho de anexos individuais e para o tamanho total de todos os anexos. A solicitação de transacional que é enviada ao emessage TMS deve conter o conteúdo do documento e informações sobre cada documento anexo. A equipe de marketing por deve trabalhar com os desenvolvedores de aplicativos para fornecer as informações a seguir sobre cada anexo. v O nome do arquivo do anexo v O tipo de conteúdo MIME do arquivo v Conteúdo do arquivo Capítulo 1. Sobre o emessage e transacional 7

12 O método que é utilizado para incluir anexos depende da linguagem de programação e das ferramentas de desenvolvimento que os desenvolvedores de aplicativos utilizam. Para obter informações adicionais sobre como fornecer conteúdo anexo, consulte Anexos em solicitações de transacional na página 17. Conceitos relacionados: Anexos em solicitações de transacional na página 17 Como especificar imagens transacionais dinâmicas na solicitação de transacional na página 39 Varrendo anexos em busca de vírus O Serviço de Envio de Correio Transacional do emessage não varre anexos para vírus de computador ou outros tipos de malware. Você é responsável por assegurar que nenhum dos arquivos que você anexar a transacional contenha código malicioso. O que Divulgadores de Fazem para Transacional Usar oemessage para enviar transacional requer preparação e coordenação avançada entre a equipe de marketing por e os desenvolvedores de aplicativos responsáveis por seus sistemas transacionais corporativos. A tabela a seguir lista atividades típicas que um divulgador de executa para preparar um envio de correio para transacional. Atividade Identificar o tipo de transação que irá iniciar uma solicitação de transacional. Compor e publicar o documento do emessage que você deseja usar para o envio de correio transacional. Configurar totalmente a correspondência que planeja ativar para transacional. na configuração, indicar se o transacional inclui anexos. Identificar todos os campos de personalização usados no documento. A guia de envio de correio inclui uma lista de campos de personalização usados no documento. Fornecer os nomes e definições dos campos de personalização aos desenvolvedores de aplicativos. Fornecer aos desenvolvedores de aplicativos o código do envio de correio que você deseja ativar para transacional. Descrição Confirmar com a equipe de desenvolvimento de aplicativo se os sistemas de transações podem detectar o evento de transação que deve acionar o . Compor um documento do emessage para transacional da mesma maneira que o faria com qualquer outro documento do emessage. Fazer referência ao documento criado para o transacional. Se estiver incluindo anexos, especificar o número de anexos. Os desenvolvedores de aplicativos precisam configurar o aplicativo cliente de transacional para fornecer informações de personalização. Cada solicitação de serviço da web de solicitação de transacional deve especificar os nomes e os valores dos campos de personalização como pares nome-valor e especificar o tipo de dados necessário. Desenvolvedores requerem essas informações para identificar o envio de correio para o emessage TMS. 8 IBM emessage: Transactional Administration Guide

13 Atividade Descrição Determinar se o transacional inclui arquivos anexados. Se imagens transacionais dinâmicas forem usadas, incluir marcadores para os anexos no documento de que define o transacional. Ativar o envio de correio para transacional usando links na guia de envio de correio. Confirmar se desenvolvedores concluíram a configuração do cliente de transacional local antes de ativar o envio de correio para transacional. Consultar com desenvolvedores de aplicativos com relação ao número e tamanho dos arquivos anexados. Concordar sobre os rótulos a serem usados para identificar imagens transacionais dinâmicas. O emessage TMS começa a aceitar solicitações de imediatamente após a ativação do envio de correio para transacional. Conceitos relacionados: Informações de Destinatários para Transacional na página 5 Campos de personalização usados em um transacional na página 6 Sobre como Ativar Envios de Correio para Transacional s transacionais são baseados em envios de correio padrão que foram ativados para transacional. Você ativa um envio de correio para transacional no Campaign, na guia de envio de correio de resumo. Consulte a página Envios de Correio do emessage para ver quais envios de correio estão ativados para transacional. É possível ativar qualquer envio de correio do emessage para transacional. A solicitação de transacional falha se você não tiver atualizado a configuração de envio de correio para ativar o envio de correio para transacional. No entanto, mesmo após ativar um envio de correio para enviar mensagens individuais como transacional, é possível executar o mesmo envio de correio como um envio de correio padrão para executar uma campanha por envio de correio que envolva um grande volume de mensagens. Cada solicitação de transacional deve incluir código de envio de correio que identifique o envio de correio. Ao ativar um envio de correio para transacional, observe o código do envio de correio e forneça o mesmo aos desenvolvedores de aplicativos responsáveis por configurar o cliente de transacional local. Se estiver anexando arquivos aos s transacionais, a configuração de envio de correio deve especificar o número de anexos. Cada transacional recebe o número de anexos especificado. O número de anexos inserido na configuração de envio de correio deve corresponder ao número configurado na solicitação de serviço da web enviada ao emessage TMS. os arquivos anexados são enviados somente com transacional. O emessage não suporta enviar anexos quando um envio de correio padrão é executado, mesmo se o envio de correio também estiver ativado para transacional. É possível desativar o envio de correio para transacional a qualquer momento. Por exemplo, você deve desativar um envio de correio para Capítulo 1. Sobre o emessage e transacional 9

14 transacional para alterar a configuração do envio de correio. O emessage TMS não aceita solicitações de transacional enquanto o envio de correio estiver desativado para transacional. Como uma melhor prática, antes de ativar um envio de correio para transacional, teste o envio de correio integralmente e visualize o documento do emessage com as referências do envio de correio. Certifique-se de que o envio de correio e a mensagem atendam suas expectativas e objetivos de negócios. Sobre como Editar Envios de Correio Ativados para Transacional Para editar um envio de correio ativado para transacional, você deve desativar o envio de correio para transacional antes de iniciar. Após concluir a edição do envio de correio, você deve ativar novamente o envio de correio para transacional. Durante esse processo, o emessage TMS não responde a solicitações transacionais para o envio de correio desativado. Os sistemas locais que monitoram eventos de transações devem ser projetados para armazenar temporariamente as solicitações de mensagens até o envio de correio ser ativado novamente para transacional. Sobre como Responder a Erros Relacionados a Transacional Às vezes um transacional não é transmitido conforme esperado. A falha pode ser devido a problemas com a configuração da mensagem ou problemas temporários com recursos de envio de correio. Se o emessage TMS determinar que existe um problema, o serviço da web retorna um código de erro consultivo ao cliente de transacional local. O cliente de transacional local é responsável por manipulação de erros. Desenvolvedores de aplicativos devem projetar o cliente para reconhecer as mensagens de erro que o emessage TMS possa retornar. Para obter uma lista de códigos de erro no emessage TMS, consulte Mensagens de Erro para Transacional na página 25. Todas as partes devem ser preparadas para responderem a problemas de não previstos. Se os problemas forem relacionados à configuração do envio de correio ou ao design da mensagem, desenvolvedores de aplicativos podem convocar a equipe de marketing por para resolver o problema. o que os desenvolvedores de aplicativos fazem para transacional Os desenvolvedores de aplicativos criam o cliente de transacional local que envia solicitações de transacional ao IBM emessage Transactional Mailing Service (TMS). O aplicativo cliente de transacional local processa cada mensagem de transacional fazendo uma solicitação SOAP ao emessage TMS por meio de uma conexão HTTPS. O IBM fornece um WSDL para permitir que os desenvolvedores projetem a solicitação de serviço da web. Para obter mais informações sobre o WSDL, consulte WSDL para transacional do emessage na página 15. Criar o aplicativo cliente de transacional local requer coordenação entre a equipe de desenvolvimento de aplicativo responsável por sistemas de transações 10 IBM emessage: Transactional Administration Guide

15 corporativas e a equipe de marketing por . Os comerciantes por fornecem informações sobre as mensagens de transacional e anexos que devem ser enviados como transacional. A tabela a seguir lista as atividades que os desenvolvedores de aplicativos devem executar. Atividade Descrição Construir os sistemas de monitoramento transacionais necessários para detectar os tipos de eventos da transação que acionam o transacional. Codificar ou configurar um aplicativo cliente de transacional local para se conectar ao emessage TMS e enviar solicitações de serviço da web em resposta a eventos de transação especificados. O cliente deve ser capaz de fornecer credenciais de acesso para sua conta de hospedada. Estruturar as solicitações de serviço da web para fornecer informações de personalização como pares nome-valor. A solicitação deve também especificar o tipo de dados para cada campo de personalização. Consultar a equipe de marketing por para determinar se o envio de anexos de é um requisito. Coordenar com a equipe de marketing por para identificar as origens para a personalização necessária pelas mensagens e anexos de transacional. Projetar e codificar a manipulação de erros. Consulta a equipe de marketing por para determinar quais atividades de cliente ou de negócios são qualificadas como eventos de transação adequados. Revisar os exemplos de WSDL e do cliente de transacional de amostra fornecidos pelo IBM para obter orientação. O IBM fornece um WSDL atualizado como um modelo para um cliente de transacional que possa processar os anexos de . Versões anteriores do WSDL não suportam o uso de anexos. O cliente de transacional deve ser capaz de se conectar ao sistemas e bancos de dados de negócios que fornecem valores de personalização na solicitação de transacional. Codifique o cliente para manipular erros relatados pelo emessage TMS. Inclua recursos para notificar administradores se o cliente não puder se conectar ou se as solicitações de serviço da web falharem. Coordenar com a equipe de marketing por para testar a integração do cliente de transacional local com o emessage TMS. Para obter informações sobre códigos de erro retornados pelo emessage TMS, consulte AdvisoryMessage na página 24. Os comerciantes por precisam ativar correspondências para teste de transacional e especificar endereços de de teste. Os desenvolvedores de aplicativos precisam criar maneiras para simular os eventos transacionais de destino e fornecer informações esperadas de transação e de personalização para o cliente de transacional local. Capítulo 1. Sobre o emessage e transacional 11

16 12 IBM emessage: Transactional Administration Guide

17 Capítulo 2. Integração ao serviço de transacional do emessage O emessage Transactional Mailing System (TMS) é um serviço da web hospedado como parte do IBM EMM Hosted Services. Os desenvolvedores de aplicativos devem trabalhar com comerciantes por em sua organização para criar os aplicativos cliente necessários para integrar seus sistemas transacionais corporativos com o emessage TMS. Esses aplicativos cliente iniciam cada mensagem de transacional fazendo uma solicitação SOAP ao para o emessage TMS por meio de uma conexão HTTPS. Os aplicativos clientes que enviam a solicitação de transacional devem ser capazes de executar as seguintes ações. v Identificar transações que acionam o transacional. v v v v v Conectar-se aos bancos de dados de marketing que contêm dados utilizados para personalizar o Iniciar a solicitação de transacional como uma solicitação SOAP Fornecer credenciais para acessar o emessage TMS sobre uma conexão segura Fornecer as informações de mensagem, incluindo o conteúdo do anexo Identificar mensagens de erro retornadas pelo emessage TMS Todas as ações necessárias para transacional devem ocorrer sem intervenção manual. O IBM fornece um WSDL para auxiliar os desenvolvedores que projetar as chamadas de serviço da web automatizadas para o emessage TMS. Para obter mais informações sobre o WSDL, consulte WSDL para transacional do emessage na página 15. Conceitos relacionados: Informações de Destinatários para Transacional na página 5 Identificação de eventos de transação Os desenvolvedores de aplicativos devem projetar o cliente de transacional local para interagir com sistemas de monitoramento de transação utilizados por sua organização. O cliente deve usar as notificações de transação como entrada e distinguir o tipo de evento de transação que o sistema de gerenciamento de transação está relatando. Um evento de transação pode ser qualquer ação que seus sistemas de gerenciamento de transações podem detectar. Por exemplo, um evento de transação pode ser uma compra, uma solicitação de serviço por parte do cliente, uma solicitação de informações ou uma mudança no status da conta do cliente. Geralmente, sua organização de marketing determina os tipos de eventos transacionais que garantem uma solicitação de transacional e o conteúdo da mensagem enviada em resposta. Cada evento transacional requer uma solicitação de transacional separada para o emessage TMS. Copyright IBM Corp. 1999,

18 Acesso a dados do destinatário Para personalizar s transacionais, o cliente de transacional local deve acessar sistemas e bancos de dados de negócios que podem fornecer dados específicos dos destinatários usados no transacional. Os desenvolvedores de aplicativos devem colaborar com a equipe de marketing por para identificar os campos de personalização usados no referenciado pelas correspondências ativadas para transacional. A guia de envio de correio de resumo do emessage fornece um link para uma lista dos campos de personalização usados no . Os campos de personalização são marcadores de informações específicas para o destinatário do . Esta informação é fornecida pelos sistemas de negócios e bancos de dados gerenciados por sua organização. O cliente de transacional local deve ser capaz de acessar esses sistemas e recuperar dados utilizados como valores de campo de personalização. Conceitos relacionados: Construção da solicitação de transacional na página 18 Capítulo 3, A API do emessage Transactional Mailing Service, na página 23 Conexão com o emessage TMS Deve-se projetar o cliente de transacional local para conectar-se automaticamente ao datacenter do IBM designado à sua conta de hospedada. O cliente deve ser capaz de fornecer as credenciais de autenticação apropriadas como parte da solicitação de serviço da web. Para obter informações sobre qual datacenter especificar, consulte Endereços do emessage TMS. Para obter informações sobre como fornecer as credenciais de autenticação, consulte Sobre como fornecer credenciais de autenticação para transacional na página 16. Endereços do emessage TMS O IBM estabeleceu os domínios de reservados para o processamento de s transacionais. Deve-se configurar seus aplicativos de transacional para solicitar acesso ao IBM EMM Hosted Services usando o domínio correto. O domínio usado depende de qual datacenter do IBM processa sua solicitação. Para processar transacional por meio do datacenter do IBM da América do Norte, configure uma conexão com tms-em-us.unicaondemand.com. Para processar transacional por meio do datacenter do IBM do Reino Unido, configure uma conexão com o tms-em-eu.unicaondemand.com. Se não souber qual datacenter o IBM usa para processar seu transacional, entre em contato com o suporte técnico. Para obter informações de contato, consulte Antes de entrar em contato com o suporte técnico do IBM na página IBM emessage: Transactional Administration Guide

19 WSDL para transacional do emessage O IBM fornece duas versões do WSDL para construir aplicativos que acessam o emessage TMS. A escolha do WSDL depende se planeja utilizar anexos de e de como o aplicativo cliente fornece credenciais de acesso. O WSDL de primeira geração não suporta a utilização de anexos com transacional. Ele requer que você modifique o cabeçalho SOAP para fornecer credenciais para acessar o IBM EMM Hosted Services. Para obter detalhes sobre a geração do WSDL, consulte WSDL de primeira geração. Use o WSDL de segunda geração se planejar anexar documentos ao transacional ou enviar credenciais de acesso como parâmetros na solicitação de serviço da web. Para obter detalhes sobre o WSDL de segunda geração, consulte WSDL de segunda geração. WSDL de primeira geração O WSDL de primeira geração descreve como construir uma interface para o emessage TMS. Ele não descreve como fornecer anexos, mas descreve um método para acessar o IBM EMM Hosted Services que requer a modificação do cabeçalho SOAP. O WSDL de primeira geração está disponível em sua instalação local do emessage no diretório examples/tmsclient/conf. O IBM fornece um exemplo de como criar o cliente de transacional local que é baseado no WSDL de primeira geração. Tarefas relacionadas: Incluindo credenciais de acesso no cabeçalho SOAP na página 16 Referências relacionadas: Apêndice A, Amostra de programa cliente de transação de primeira geração, na página 29 WSDL de segunda geração O WSDL de segunda geração descreve como construir uma interface para o emessage TMS, que suporta anexos de . Este WSDL também descreve como especificar as credenciais de acesso como parâmetros na solicitação de serviço da web ao invés de modificar o cabeçalho SOAP. O WSDL de segunda geração está disponível para download a partir do datacenter do IBM que o IBM instruiu você a utilizar para conexão com o emessage TMS. Construir a URL de download da seguinte forma: <URL para se conectar a seu TMS designado>/emessageds/services/tms?wsdl O IBM fornece um exemplo de como criar o cliente de transacional local baseado no WSDL de segunda geração. Para visualizar o exemplo, consulte Apêndice B, Amostra de cliente de segunda geração, na página 33 Nota: Se já tiver construído um cliente de transacional com base no WSDL de primeira geração, deve-se recompilar o código se alterar para um design de cliente baseado no WSDL de segunda geração. Capítulo 2. Integração ao serviço de transacional do emessage 15

20 Sobre como fornecer credenciais de autenticação para transacional O cliente de transacional local deve ser capaz de fornecer as credenciais de autenticação necessárias para se conectar ao emessage TMS automaticamente. Ao solicitar transacional, os aplicativos transacionais devem fornecer credenciais de autenticação para acessar o IBM EMM Hosted Services. É possível fornecer as credenciais de acesso ao modificar o cabeçalho SOAP ou fornecê-las como parâmetros na solicitação de serviço da web SOAP. O nome do usuário e a senha que o cliente deve fornecer na solicitação SOAP são o nome do usuário e a senha designados para sua conta do emessage. Se não souber essas credenciais, entre em contato com as pessoas em sua organização que sejam responsáveis por manter sua conta ou entre em contato com o suporte técnico do IBM. Para obter informações de contato, consulte Antes de entrar em contato com o suporte técnico do IBM na página 41. Para obter mais informações sobre contas de hospedadas e como estabelecer conexão com o IBM EMM Hosted Services, consulte o Guia de Inicialização e do Administrador do IBM emessage. Incluindo credenciais de acesso no cabeçalho SOAP O emessage TMS requer um nome de usuário e senha na solicitação de serviço da web. A modificação do cabeçalho SOAP na solicitação de serviços da web para incluir credenciais de acesso para o IBM EMM Hosted Services é um método para acessar o emessage TMS. Não será possível utilizar este método se planejar utilizar anexos com mensagens de transacional. Antes de Iniciar Antes de iniciar, obtenha o nome do usuário e a senha que foram criados n sua conta de hospedada do IBM emessage. Sobre Esta Tarefa O nome de usuário e a senha que forem incluídos no cabeçalho SOAP devem ser o nome de usuário e a senha criados para a conta de hospedada do IBM emessage, conforme mostrado abaixo. Os seguintes exemplos de códigos são baseados em uma biblioteca Axis2 SOAP. String username = "<user name for your Unica emessage account>"; String password = "<password for your Unica emessage account>"; Procedimento Modifique os cabeçalhos de seu aplicativo cliente da seguinte forma: ServiceClient serviceclient = stub._getserviceclient(); serviceclient.addstringheader(new QName (" "username", "ns2"), username); serviceclient.addstringheader(new QName (" "password", "ns2"), password); 16 IBM emessage: Transactional Administration Guide