Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
O que são modelos de notificação?
A monetização fornece um conjunto de modelos que definem o texto de amostra para vários tipos de notificações de eventos. É possível personalizar qualquer um desses modelos para:
- Notifique todos os desenvolvedores sobre eventos como novos produtos, novas versões dos Termos e Condições ou novos planos de tarifas.
- Notificar os desenvolvedores afetados sobre eventos, como um plano de tarifas revisado.
- Notifique um provedor de API sobre eventos relacionados ao desenvolvedor, como o registro de uma conta ou a inscrição em um plano de tarifas.
- Notificar todos os administradores da empresa sobre um evento específico.
Se preferir, crie um webhook que defina um gerenciador de callback HTTP e configure a condição que aciona o webhook, conforme descrito em Configurar notificações usando webhooks.
Como explorar a página "Notificações"
Acesse a página "Notificações", conforme descrito abaixo.
Edge
Para acessar a página "Notificações" pela interface do Edge:
- Faça login em apigee.com/edge.
- Selecione Publicar > Monetização > Notificações na barra de navegação à esquerda.
A página Notificações é exibida.
Como destacado na figura, a página Notificações permite que você:
- Abrir e fechar os detalhes da notificação
- Editar os detalhes da notificação e salvar todas as edições
- Ativar ou desativar uma notificação
Borda clássica (nuvem privada)
Para acessar a página "Notificações" usando a interface clássica do Edge:
- Faça login em
http://ms-ip:9000
, em que ms-ip é o endereço IP ou o nome DNS do nó do servidor de gerenciamento. Selecione Administrador > Notificações na barra de navegação superior.
Na página "Notificações", você pode:
Como editar notificações
Para editar uma notificação usando a interface:
- Acesse a página "Notificações".
- Clique em ao lado da notificação que você quer editar para expandir os detalhes.
- Edite os campos Assunto, Corpo e Destinatário (se disponíveis), conforme necessário.
Para ver informações sobre variáveis que podem ser especificadas em um modelo de notificação, consulte Como usar variáveis em modelos de notificação.
Consulte as seções a seguir para mais informações sobre como editar notificações em cada categoria:
- Para ativar uma notificação, marque a caixa de seleção ao lado dela.
- Repita as etapas de 2 a 4 para editar outras notificações.
- Clique em Salvar para registrar todas as mudanças.
Uma mensagem será exibida para confirmar que as notificações foram salvas. Isso pode levar alguns minutos.
Como editar notificações para notificar todos os desenvolvedores
As notificações sobre os tipos de eventos selecionados na seção Notificar todos os desenvolvedores são enviadas a todos os desenvolvedores.
As notificações são programadas para serem executadas no final do dia. Depois que as notificações forem enviadas, as caixas de seleção de eventos serão desmarcadas automaticamente. Selecione-os novamente para programar notificações para os tipos de eventos associados.
A tabela a seguir lista as notificações com base nos tipos de evento na seção "Notificar todos os desenvolvedores". Para mais informações, consulte Como editar notificações usando a IU.
Tipo de evento | Gatilho | Observações |
---|---|---|
Novo pacote | Novo pacote de API disponível |
Adicione o nome de cada pacote novo (e os produtos contidos em cada um deles) ao corpo do modelo de e-mail como parte da atualização. Também é possível adicionar um link para o portal do desenvolvedor ou qualquer outro site com mais informações sobre a notificação. |
Novo produto | Novo produto de API disponível |
Adicione o nome de cada produto novo ao corpo do modelo de e-mail como parte da atualização. Também é possível adicionar um link para o portal do desenvolvedor ou qualquer outro site que forneça mais informações sobre a notificação. |
Novos mercados/cobertura | Novos produtos de API estão disponíveis em mercados geográficos específicos |
Adicione o nome de cada novo mercado e os produtos pertinentes ao corpo do modelo de e-mail como parte da atualização. Também é possível adicionar um link para o portal do desenvolvedor ou qualquer outro site com mais informações sobre a notificação. |
Como editar notificações para notificar os desenvolvedores afetados
As notificações sobre os tipos de eventos selecionados na seção Notificar desenvolvedores afetados são enviadas somente para os desenvolvedores afetados por esses tipos de eventos. Por exemplo, se você selecionar o evento do plano de tarifa revisado, uma notificação será enviada somente para os desenvolvedores que aceitaram o plano.
A tabela a seguir lista as notificações com base nos tipos de evento na seção "Notificar desenvolvedores afetados". Para mais informações, consulte Como editar notificações usando a IU.
Tipo de evento | Gatilho | Observações |
---|---|---|
Termos e Condições não aceitos ou expirados | Um novo conjunto de Termos e Condições foi publicado, e o desenvolvedor ainda não os aceitou |
A notificação é enviada 30, 7 e 1 dia antes de os novos Termos e Condições entrarem em vigor. |
Novo plano de tarifa | Novos planos de tarifas foram publicados |
Se o plano de tarifa for:
|
Plano de tarifa revisado | A versão mais recente de um plano de tarifas comprado está disponível |
Somente os desenvolvedores que compraram a versão atual serão notificados. A notificação permite que os desenvolvedores analisem a nova versão e encerrem ou mudem de planos se não quiserem aceitar as novas tarifas. |
Plano de tarifas expirado | O plano de tarifa expirou sem um plano de tarifação de acompanhamento |
Essa notificação é enviada quando você define inicialmente o plano de tarifa para expirar. Outras notificações são enviadas 30, 7 e 1 dia antes da data de validade. Somente os desenvolvedores que compraram o plano de tarifa expirado vão ser notificados. |
Plano de tarifas renovado | A assinatura do plano de tarifa foi renovada. |
Informe o desenvolvedor que as taxas aplicáveis serão cobradas. |
O limite de taxa foi excedido | O limite do plano de tarifa foi excedido |
Informe o desenvolvedor que as taxas aplicáveis serão cobradas. |
Plano de tarifa Freemium esgotado | Os períodos de uso sem custo financeiro, medidos por contagem de transações ou dias, se esgotaram |
O período de uso sem custo financeiro é definido pelo seu plano de tarifação freemium. |
Documento de faturamento publicado |
Os documentos de faturamento (como faturas) do desenvolvedor estão disponíveis. |
|
O desenvolvedor se inscreve no novo plano de tarifas | O desenvolvedor se inscreve em um novo plano de preços. |
Como editar notificações para notificar provedores de API
As notificações dos tipos de eventos selecionados na seção Notificar o provedor da API são enviadas ao provedor da API que você especificar.
A tabela a seguir lista as notificações com base nos tipos de evento na seção "Notificar o provedor da API". Para mais informações, consulte Como editar notificações usando a IU.
Tipo de evento | Gatilho |
---|---|
Inscrições de novo desenvolvedor |
O desenvolvedor se registrou para uma conta. |
O desenvolvedor adiciona um app |
O desenvolvedor criou um novo app. |
Inscrição do desenvolvedor para o novo plano de tarifas |
O desenvolvedor se inscreveu em um plano de tarifa. |
O desenvolvedor muda os detalhes financeiros |
O desenvolvedor mudou detalhes financeiros, como o nome ou endereço da empresa. |
Como ativar ou desativar uma notificação
Para ativar ou desativar uma notificação usando a interface:
- Acesse a página "Notificações".
- Ative ou desative uma notificação marcando ou desmarcando, respectivamente, a caixa de seleção ao lado.
- Clique em Salvar para registrar todas as mudanças.
Isso pode levar alguns minutos. Uma mensagem será exibida para confirmar que as notificações foram salvas.
Como configurar notificações com modelos usando a API
Configure notificações usando a API, conforme descrito nas seções a seguir.
Como gerenciar modelos de notificação usando a API
Gerencie modelos de notificação usando a API, conforme descrito nas seguintes seções:
- Como visualizar todos os modelos de notificação usando a API
- Como ver um modelo de notificação usando a API
- Como editar um modelo de notificação usando a API
Como visualizar todos os modelos de notificação usando a API
Você pode listar todos os modelos de notificação disponibilizados pela monetização enviando uma solicitação GET
para /mint/organizations/{org_name}/notification-email-templates
. Exemplo:
curl -H "Accept:application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/notification-email-templates" \ -u email:password
Por exemplo, veja a seguir um modelo de evento que notifica os desenvolvedores sobre a disponibilidade de um novo produto de API:
{ "createdDate" : 1376975394984, "htmlImage" : "<p>Dear ${developer.legalName} , ${developer.name} <br /> Introducing _________. For more details visit us at _________________</p>", "id" : "4d81ea64-d005-4010-b0a7-6ec8a5c3954b", "name" : "DEFAULT_NEW_PRODUCT_TEMPLATE", "orgId" : "myorg", "source" : "Mail Man Test", "subject" : "Notification of new product", "updatedDate" : 1376975394984 }
Como visualizar um modelo de notificação usando a API
Veja um modelo de notificação emitindo uma solicitação GET para
/mint/organizations/{org_name}/notification-email-templates/{template_id}
,
em que {template_id}
é o ID do modelo. Exemplo:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-email-templates/4d81ea64-d005-4010-b0a7-6ec8a5c3954b" \ -H "Accept:application/json" \ -u email:password
Os itens nos modelos que começam com $ são variáveis. Para mais informações, consulte Como usar variáveis em modelos de notificação. Suponha que as variáveis na notificação sejam avaliadas para os seguintes valores:
${developer.legalName}.XYZ company
${developer.name}.DEV1
${QUOTA_TYPE}.Transactions
${PERCENT}.90%
${QUOTA_UNIT}.Calls
${QUOTA_LIMIT}.100
${ratePlan.monetizationPackage.products.name}.X
${EXPIRY_DATE}.2016-09-30
A mensagem de notificação fornecida pelo modelo seria:
"Dear XYZ company, DEV1 You have exceeded Transactions of 90% calls of 100 calls for X product. Your API calls will be blocked till 2016-09-30"
Como editar um modelo de notificação usando a API
Edite um modelo de notificação emitindo uma solicitação PUT para /nint/organizations/{org_name}/notification-email-templates/{template_id}
.
Forneça o conteúdo alterado do modelo no corpo da solicitação.
Ao personalizar a mensagem em um modelo de notificação, é possível incluir uma ou mais variáveis. Para mais informações, consulte Como usar variáveis em modelos de notificação.
Por exemplo, a solicitação a seguir edita o conteúdo de uma nova notificação de produto de API:
curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-email-templates/4d81ea64-d005-4010-b0a7-6ec8a5c3954b " \ -H "Content-Type: application/json" \ -d '{ "id" : "4d81ea64-d005-4010-b0a7-6ec8a5c3954b", "htmlImage" : "<p>Exciting news, we have added a new product :${Product.name}. See details in <a href="${Product.url}">New Products</a> </p>", "name" : "NewProductNotification", "organization": { "id": "{org_name}" }, "source" : "Mail Man Test ", "subject" : "New Product Available: ${Product.name}" }' \ -u email:password
Como gerenciar condições e ações de notificação usando a API
Gerencie condições e ações de notificação usando a API, conforme descrito nas seções a seguir.
- Como criar uma condição e ação de notificação usando a API
- Como visualizar uma condição e ação de notificação usando a API
- Como editar uma condição e ação de notificação usando a API
- Como excluir uma condição e ação de notificação usando a API
Como criar uma condição e ação de notificação usando a API
Crie uma condição e ação de notificação que resultem em uma notificação automática emitindo
uma solicitação POST para /mint/organizations/{org_name}/notification-conditions
.
Ao fazer a solicitação, especifique no corpo a condição que resulta na notificação e as ações a serem realizadas quando a condição for alcançada (como enviar um e-mail de notificação).
Para definir os detalhes da condição de notificação, especifique um ou mais valores de atributo. Consulte Propriedades de configuração para condições de notificação para ver uma lista de atributos. Nas notificações de eventos, a condição pode ser acionada quando um novo produto é publicado.
Ao definir o actions
, faça referência ao modelo de notificação aplicável. Consulte
Propriedades de configuração para ações de notificação para uma lista de ações.
Por exemplo, a solicitação a seguir especifica que, quando o atributo for
NEW_PRODUCT
e o valor do atributo PUBLISHED
for
true
, envie a notificação no modelo com o ID
01191bf9-5fdd-45bf-8130-3f024694e63
(esse é
DEFAULT_NEW_PRODUCT_TEMPLATE
).
curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions" \ -H "Content-Type:application/json" -d '{ "notificationCondition": [ { "attribute": "NEW_PRODUCT" }, { "attribute": "PUBLISHED", "value": "true" } ], "actions": [{ "actionAttribute": "DEV_ID", "value": "ANY", "templateId": "01191bf9-5fdd-45bf-8130-3f024694e63" }] }' \ -u email:password
Como visualizar uma condição e ação de notificação usando a API
Veja uma ação e condição de notificação enviando uma solicitação GET para organizations/{org_name}/notification-conditions/{condition_Id}
, em que {condition_Id}
é o ID da condição. O ID é retornado quando você cria a condição de notificação. Exemplo:
curl -X GET "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/notification-conditions/2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4" \ -H "Accept:application/json" \ -u email:password
Veja a seguir um exemplo de resposta:
{ "actions" : [ { "actionAttribute" : "DEV_ID", "id" : "141ba00c-d7bd-4fef-b339-9d58b83255f4", "templateId" : "766aba4f-0f7a-4555-b48e-d707c48b8f4c", "value" : "ANY" }, { "actionAttribute" : "ORG_EMAIL", "id" : "21486ce1-4290-4a55-b415-165af3e93c9d", "templateId" : "efa4ce63-7c08-4876-984b-6878ec435994", "value" : "DEFAULT_LIMIT_NOTIFICATION_EMAIL" } ], "notificationCondition" : [ { "attribute" : "Balance", "id" : "2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4", "organization" : { ... }, "value" : "< 0" } ] }
Como editar uma condição e ação de notificação usando a API
Edite uma ação e condição de notificação enviando uma solicitação POST para organizations/{org_name}/notification-conditions/{condition_Id}
, em que {condition_Id}
é o ID da condição. O ID é retornado quando você cria a condição de notificação. Ao emitir a solicitação, especifique no corpo da solicitação as mudanças que
você quer fazer na condição ou ação da notificação.
Exemplo:
$ curl -H "Content-Type:application/json" -X POST -d \ ' { "notificationCondition": [ { "attribute": "NEW_PRODUCT" }, { "attribute": "PUBLISHED", "value": "true" } ], "actions": [{ "actionAttribute": "DEV_ID", "value": "ANY", "templateId": "01191bf9-5fdd-45bf-8130-3f024694e63" }] }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions/2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4" \ -u email:password
Como excluir uma condição e ação de notificação usando a API
Exclua uma condição de notificação emitindo uma solicitação DELETE para organizations/{org_name}notification-conditions/{condition_Id}
. Exemplo:
curl -X DELETE "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions/2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4" \ -H "Accept:application/json" \ -u email:password
Propriedades de configuração para condições de notificação
As propriedades de configuração das condições de notificação a seguir estão disponíveis ao usar a API.
Nome | Descrição | Padrão | Obrigatório? |
---|---|---|---|
attribute |
Detalhes da condição da notificação. É possível especificar um ou mais atributos para refinar a condição de notificação. O valor pode ser um ou mais dos seguintes valores:
|
N/A | Sim |
value |
Valor do atributo. |
N/A | Não |
associatedCondition |
Referência a uma condição associada. |
N/A | Não |
Propriedades de configuração para ações de notificação
As propriedades de configuração a seguir estão disponíveis para ações de notificação ao usar a API.
Nome | Descrição | Padrão | Obrigatório? |
---|---|---|---|
actionAttribute |
Método usado para identificar o destinatário da notificação. O valor pode ser uma ou mais das seguintes opções:
|
N/A | Sim |
value |
Valor do atributo da ação. Se Se Se |
N/A | Sim |
templateID |
ID do modelo de notificação. Observação:essa opção não será válida se |
N/A | Sim |
postURL |
Gerenciador de callback para o webhook. Observação:essa opção será obrigatória se |
N/A | Sim |
Como usar variáveis em modelos de notificação
Ao editar a mensagem em um modelo de notificação, é possível incluir uma ou mais variáveis usando a Spring Expression Language (SpEL) para representar os valores retornados no objeto Transaction.
A tabela a seguir resume as variáveis do modelo de notificação mais usadas.
Variável | Descrição |
---|---|
${application.name} |
Nome de um aplicativo. |
${application.products.name} |
Nome de um produto incluído em um aplicativo. |
${BALANCE} |
Saldo de uma determinada cota. |
${developer.legalName} |
Nome da empresa de um desenvolvedor. |
${developer.name} |
Nome de um desenvolvedor. |
${EXPIRY_DATE} |
Data ou hora em que um limite expira ou é redefinido. |
${LONG_PERCENT} |
Porcentagem de um limite atingido pelo uso atual, sem o símbolo %. Por exemplo, 50 |
${PERCENT} |
Porcentagem de um limite atingido pelo uso atual, com o símbolo de %. Por exemplo, 50%. |
${products.displayName} |
Nome de exibição definido para um produto. |
${QUOTA_TYPE} |
Tipo de limite (volume de transações, limite de gasto ou exposição à taxa). |
${QUOTA_UNIT} |
Unidade básica para um limite: moeda (para um limite de gastos) ou chamadas (para um limite de transação). |
${QUOTA_LIMIT} |
Valor de um limite. |
${ratePlan.displayName} |
Nome de exibição definido para um plano de tarifas. |
${ratePlan.endDate} |
Data em que um provedor de API encerrou um plano de tarifa. |
${ratePlan.monetizationPackage.displayName} |
Nome de um pacote de API. |
${ratePlan.monetizationPackage.name} |
Nome de um pacote de monetização. |
${ratePlan.monetizationPackage.products.displayName} |
Nome de exibição definido para um produto de API. |
${ratePlan.monetizationPackage.products.name} |
Nome de um produto incluído em um pacote de monetização. |
${ratePlan.startDate} |
Data de criação do plano de tarifa. |
${USAGE} |
Uso atual (receita ou cobranças total ou volume). |
${USER} |
Nome de um usuário. |
Personalizar seu endereço de e-mail para resposta
Para monetização, um endereço padrão noreply@apigee.com está configurado para ser usado em notificações por e-mail enviadas a empresas e desenvolvedores. Entre em contato com o suporte da Apigee para configurar um nome e endereço de resposta personalizados para sua organização.