Introdução à AppFabric produtividade (versão prévia) para desenvolvedores de aplicativos - AWS AppFabric
Pré-requisitosEtapa 1. Crie um AppFabric para produtividade AppClientEtapa 2. Autentique e autorize sua aplicaçãoEtapa 3. Adicione a URL AppFabric do portal do usuário ao seu aplicativoEtapa 4. Use AppFabric para revelar informações e ações entre aplicativosEtapa 5. Solicitação AppFabric para verificar sua inscrição

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Introdução à AppFabric produtividade (versão prévia) para desenvolvedores de aplicativos

O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações.

Esta seção ajuda os desenvolvedores de aplicativos a integrarem seus aplicativos AWS AppFabric para fins de produtividade (pré-visualização). AWS AppFabric para produtividade, permite que os desenvolvedores criem experiências de aplicativos mais ricas para seus usuários, gerando informações e ações baseadas em IA a partir de e-mails, eventos do calendário, tarefas, mensagens e muito mais em vários aplicativos. Para obter uma lista dos aplicativos compatíveis, consulte Aplicativos AWS AppFabric compatíveis.

AppFabric para produtividade oferece aos desenvolvedores de aplicativos acesso para criar e experimentar em um ambiente seguro e controlado. Ao começar a usar AppFabric para fins de produtividade, você cria um AppClient e registra um único usuário de teste. Essa abordagem foi projetada para ajudá-lo a entender e testar o fluxo de autenticação e comunicação entre seu aplicativo AppFabric e. Depois de testar com um único usuário, você pode enviar sua inscrição AppFabric para verificação antes de expandir o acesso a outros usuários (consulteEtapa 5. Solicitação AppFabric para verificar sua inscrição). AppFabric verificará as informações do aplicativo antes de permitir uma ampla adoção para ajudar a proteger os desenvolvedores de aplicativos, os usuários finais e seus dados, abrindo caminho para expandir a adoção pelos usuários de forma responsável.

Tópicos

Pré-requisitos

Antes de começar, você precisa criar um Conta da AWS. Para ter mais informações, consulte Inscreva-se para um Conta da AWS. Você também precisa criar pelo menos um usuário com acesso à política do "appfabric:CreateAppClient" IAM listada abaixo, que permite que o usuário registre seu aplicativo com AppFabric. Para obter mais informações sobre a concessão de permissões AppFabric para os recursos de produtividade, consulteAppFabric exemplos de políticas de IAM para produtividade. Embora ter um usuário administrativo seja benéfico, isso não é obrigatório para a configuração inicial. Para ter mais informações, consulte Criar um usuário com acesso administrativo.

AppFabric para produtividade é somente no Leste dos EUA (Norte da Virgínia) durante a pré-visualização. Certifique-se de estar nessa região antes de iniciar as etapas abaixo.

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "appfabric:CreateAppClient"
            ],
            "Resource": ["arn:aws:appfabric:*:*:appclient/*"]
        }
    ],
    "Version": "2012-10-17"
}

Etapa 1. Crie um AppFabric para produtividade AppClient

Antes de começar a AppFabric buscar insights de produtividade em seu aplicativo, você precisa criar um AppFabric AppClient. An AppClient é essencialmente sua porta de entrada AppFabric para produtividade, funcionando como um cliente de aplicativo OAuth seguro, permitindo a comunicação segura entre seu aplicativo e. AppFabric Ao criar um AppClient, você receberá um AppClient ID, um identificador exclusivo crucial para garantir que ele AppFabric saiba que está funcionando com seu aplicativo e com o seu Conta da AWS.

AppFabric para produtividade oferece aos desenvolvedores de aplicativos acesso para criar e experimentar em um ambiente seguro e controlado. Ao começar a usar AppFabric para fins de produtividade, você cria um AppClient e registra um único usuário de teste. Essa abordagem foi projetada para ajudá-lo a entender e testar o fluxo de autenticação e comunicação entre seu aplicativo AppFabric e. Depois de testar com um único usuário, você pode enviar sua inscrição AppFabric para verificação antes de expandir o acesso a outros usuários (consulteEtapa 5. Solicitação AppFabric para verificar sua inscrição). AppFabric verificará as informações do aplicativo antes de permitir uma ampla adoção para ajudar a proteger os desenvolvedores de aplicativos, os usuários finais e seus dados, abrindo caminho para expandir a adoção pelos usuários de forma responsável.

Para criar um AppClient, use a operação de AWS AppFabric CreateAppClient API. Se precisar atualizar o AppClient after, você pode usar a operação da UpdateAppClient API para alterar somente os redirectURLs. Se você precisar alterar qualquer um dos outros parâmetros associados ao seu, AppClient como AppName ou description, exclua o AppClient e crie um novo. Para ter mais informações, consulte CreateAppClient.

Você pode registrar seu aplicativo com AWS serviços usando a CreateAppClient API usando várias linguagens de programação, incluindo Python, Node.js, Java, C#, Go e Rust. Para obter mais informações, consulte Solicitação de exemplos de assinaturas no Guia do usuário do IAM. Você precisa usar suas credenciais de assinatura de conta versão 4 para realizar essa operação de API. Para obter mais informações sobre a assinatura versão 4, consulte Solicitações de AWS API de assinatura no Guia do usuário do IAM.

Campos de solicitação

  • appName- O nome do aplicativo que será exibido aos usuários na página de consentimento do portal do AppFabric usuário. A página de consentimento solicita permissão aos usuários finais para exibir AppFabric insights dentro do seu aplicativo. Para obter detalhes sobre a página de consentimento, consulte Etapa 2. Forneça consentimento para que a aplicação exiba informações.

  • description: uma descrição da aplicação.

  • redirectUrls: o URI para o qual redirecionar os usuários finais após a autorização. É possível adicionar até 5 redirectUrls. Por exemplo, https://localhost:8080.

  • starterUserEmails: um endereço de email do usuário que terá acesso para receber as informações até que a aplicação seja verificada. Só é permitido um endereço de email. Por exemplo, anyuser@example.com.

  • customerManagedKeyIdentifier (opcional): o ARN da chave gerenciada pelo cliente (gerada pelo KMS) a ser usada para criptografar os dados. Se não for especificada, a chave AWS AppFabric gerenciada será usada. Para ter mais informações sobre Chaves pertencentes à AWS e chaves gerenciadas pelo cliente, consulte Chaves de clientes e chaves AWS no Guia do desenvolvedor AWS Key Management Service .

Campos de resposta

  • appClientArn- O nome de recurso da Amazon (ARN) que inclui o AppClient ID. Por exemplo, o AppClient ID éa1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

  • verificationStatus- O status da AppClient verificação.

    • pending_verification- A verificação do ainda AppClient está em andamento com AppFabric. Até que AppClient seja verificado, somente um usuário (especificado emstarterUserEmails) pode usar AppClient o. O usuário verá uma notificação no portal do AppFabric usuário, introduzida emEtapa 3. Adicione a URL AppFabric do portal do usuário ao seu aplicativo, indicando que o aplicativo não foi verificado.

    • verified- O processo de verificação foi concluído com sucesso AppFabric e agora AppClient está totalmente verificado.

    • rejected- O processo de verificação do AppClient foi rejeitado por AppFabric. Eles AppClient não podem ser usados por usuários adicionais até que o processo de verificação seja reiniciado e concluído com êxito.

curl --request POST \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.amazonaws.com/appclients/ \
  --data '{
    "appName": "Test App",
    "description": "This is a test app",
    "redirectUrls": ["https://localhost:8080"],
    "starterUserEmails": ["anyuser@example.com"],
    "customerManagedKeyIdentifier": "arn:aws:kms:<region>:<account>:key/<key>"
}'

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

{
    "appClientConfigSummary": {
        "appClientArn": "arn:aws:appfabric:<region>:<account>:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "verificationStatus": "pending_verification"
    }
}

Etapa 2. Autentique e autorize sua aplicação

Permita que seu aplicativo integre AppFabric insights com segurança estabelecendo um fluxo de autorização do OAuth 2.0. Primeiro, você precisa criar um código de autorização que verifique a identidade da sua aplicação. Para ter mais informações, consulte Autorizar. Em seguida, você trocará esse código de autorização por um token de acesso, que concede ao seu aplicativo as permissões para buscar e exibir AppFabric insights dentro do seu aplicativo. Para ter mais informações, consulte Token.

Para obter mais informações sobre como conceder permissão para autorizar uma aplicação, consulte Permitir acesso para autorizar aplicações.

  1. Para criar um código de autorização, use a operação AWS AppFabric oauth2/authorize da API.

    Campos de solicitação

    • app_client_id(obrigatório) - O AppClient ID do Conta da AWS criado na Etapa 1. Crie um AppClient. Por exemplo, a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

    • redirect_uri (obrigatório): o URI para o qual redirecionar os usuários finais após a autorização que você usou na Etapa 1. Crie um AppClient. Por exemplo, https://localhost:8080.

    • state (obrigatório): um valor exclusivo para manter o estado entre a solicitação e o retorno de chamada. Por exemplo, a8904edc-890c-1005-1996-29a757272a44.

    GET https://productivity.appfabric.<region>.amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\
redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44

  2. Após a autenticação, você irá para o URI especificado com um código de autorização retornado como parâmetro de consulta. Por exemplo, onde code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

    https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44

  3. Troque esse código de autorização por um token de acesso usando a operação AppFabric oauth2/token da API.

    Esse token é usado para solicitações de API e é inicialmente válido starterUserEmails até que AppClient seja verificado. Depois de AppClient verificado, esse token pode ser usado por qualquer usuário. Você precisa usar suas credenciais de assinatura de conta versão 4 para realizar essa operação de API. Para obter mais informações sobre a assinatura versão 4, consulte Solicitações de AWS API de assinatura no Guia do usuário do IAM.

    Campos de solicitação

    • code (obrigatório): o código de autorização que você recebeu após a autenticação na última etapa. Por exemplo, mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

    • app_client_id(obrigatório) - O AppClient ID do Conta da AWS criado na Etapa 1. Crie um AppClient. Por exemplo, a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

    • grant_type (obrigatório): o valor deve ser authorization_code.

    • redirect_uri (obrigatório): o URI para o qual redirecionar os usuários após a autorização que você usou na Etapa 1. Crie um AppClient. Esse deve ser o mesmo URI de redirecionamento usado para criar um código de autorização. Por exemplo, https://localhost:8080.

    Campos de resposta

    • expires_in: quanto tempo falta para o token expirar. O tempo de expiração padrão é de 12 horas.

    • refresh_token: o token de atualização recebido da solicitação inicial do token.

    • token: o token recebido da solicitação inicial do token.

    • token_type: o valor será Bearer.

    • appfabric_user_id- O ID AppFabric do usuário. Isso é retornado somente para solicitações que usem o tipo de concessão authorization_code.

    curl --location \
"https://appfabric.<region>.amazonaws.com/oauth2/token" \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: <sha256_payload>" \
--header "X-Amz-Security-Token: <security_token>" \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--data "{
    \"code\": \"mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc",
    \"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\",
    \"grant_type\": \"authorization_code\",
    \"redirect_uri\": \"https://localhost:8080\"
}"

    Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

    {
    "expires_in": 43200,
    "refresh_token": "apkaeibaerjr2example",
    "token": "apkaeibaerjr2example",
    "token_type": "Bearer", 
    "appfabric_user_id" : "<userId>"
}

Etapa 3. Adicione a URL AppFabric do portal do usuário ao seu aplicativo

Os usuários finais precisam se AppFabric autorizar a acessar dados de seus aplicativos que são usados para gerar insights. AppFabric elimina a complexidade de os desenvolvedores de aplicativos controlarem esse processo criando um portal de usuário dedicado (uma tela pop-up) para que os usuários finais autorizem seus aplicativos. Quando os usuários estiverem prontos AppFabric para aumentar a produtividade, eles serão direcionados ao portal do usuário, que permite conectar e gerenciar aplicativos usados para gerar insights e ações entre aplicativos. Quando conectados, os usuários podem conectar aplicativos AppFabric para aumentar a produtividade e depois voltar ao seu aplicativo para explorar os insights e as ações. Para integrar seu aplicativo AppFabric para fins de produtividade, você precisa adicionar um AppFabric URL específico ao seu aplicativo. Essa etapa é crucial para permitir que os usuários acessem o portal AppFabric do usuário diretamente do seu aplicativo.

  1. Navegue até as configurações da sua aplicação e localize a seção para adicionar URLs de redirecionamento.

  2. Depois de encontrar a área apropriada, adicione o seguinte AppFabric URL como URL de redirecionamento para seu aplicativo:

    https://userportal.appfabric.<region>.amazonaws.com/eup_login

Depois de adicionar a URL, seu aplicativo será configurado para direcionar os usuários ao portal do AppFabric usuário. Aqui, os usuários podem fazer login, conectar e gerenciar seus aplicativos usados AppFabric para gerar insights de produtividade.

Etapa 4. Use AppFabric para revelar informações e ações entre aplicativos

Depois que os usuários conectarem seus aplicativos, você poderá trazer os insights do usuário para melhorar sua produtividade, ajudando a reduzir a troca de aplicativos e contextos. AppFabric só gera insights para um usuário com base no que o usuário tem permissão para acessar. AppFabric armazena dados do usuário em uma Conta da AWS propriedade de AppFabric. Para obter informações sobre como AppFabric usa seus dados, consulteProcessamento de dados.

É possível usar as seguintes APIs baseadas em IA para gerar e exibir informações e ações em nível de usuário em suas aplicações:

Informações acionáveis (ListActionableInsights)

A API ListActionableInsights ajuda os usuários a gerenciar melhor seu dia, revelando informações oportunas baseadas nas atividades de todas as aplicações, incluindo emails, calendário, mensagens, tarefas e muito mais. As informações retornadas também mostrarão links incorporados para artefatos usados para gerar a informação, ajudando os usuários a visualizar rapidamente quais dados foram usados para gerar a informação. Além disso, a API pode retornar ações sugeridas com base na informação e permitir que os usuários executem ações entre aplicações de dentro da sua aplicação. Especificamente, a API se integra a plataformas como Asana, Google Workspace, Microsoft 365 e Smartsheet para permitir que os usuários enviem emails, criem eventos de calendário e criem tarefas. Os grandes modelo de linguagem (LLM) podem preencher previamente detalhes dentro de uma ação recomendada (como corpo do email ou nome da tarefa), que os usuários podem personalizar antes da execução, simplificando a tomada de decisões e aumentando a produtividade. Semelhante à experiência dos usuários finais de autorizar aplicativos, AppFabric usa o mesmo portal dedicado para que os usuários visualizem, editem e executem ações entre aplicativos. Para executar ações, AppFabric exige que os ISVs redirecionem os usuários para um portal AppFabric do usuário onde eles possam ver os detalhes das ações e executá-las. Cada ação gerada por AppFabric tem um URL exclusivo. Esse URL está disponível na resposta da resposta da API ListActionableInsights.

Abaixo há um resumo das ações entre aplicações com suporte e em quais aplicações:

  • Enviar email (Google Workspace, Microsoft 365)

  • Criar evento do calendário (Google Workspace, Microsoft 365)

  • Criar tarefa (Asana, Smartsheet)

Campos de solicitação

  • nextToken (opcional): o token de paginação para obter o próximo conjunto de informações.

  • includeActionExecutionStatus: um filtro que aceita uma lista de status de execução da ação. As ações são filtradas com base nos valores de status passados. Valores possíveis: NOT_EXECUTED | EXECUTED

Cabeçalho da solicitação

  • O cabeçalho da autorização precisa ser passado com o valor Bearer Token .

Campos de resposta

  • insightId: o id exclusivo da informação gerada.

  • insightContent: retorna um resumo da informação e links incorporados aos artefatos usados para gerar a informação. Observação: isso seria um conteúdo HTML contendo links incorporados (tags <a>).

  • insightTitle: o título da informação gerada.

  • createdAt: quando a informação foi gerada.

  • actions: uma lista de ações recomendadas para a informação gerada. Objeto de ação:

    • actionId: o id exclusivo da ação gerada.

    • actionIconUrl: o URL do ícone da aplicação no qual a ação é sugerida para ser executada.

    • actionTitle: o título da ação gerada.

    • actionUrl- O URL exclusivo para o usuário final visualizar e executar a ação no portal AppFabric do usuário. Observação: para executar ações, os aplicativos ISV redirecionarão os usuários para o portal AppFabric do usuário (tela pop-up) usando essa URL.

    • actionExecutionStatus: uma enumeração que indica o status da ação. Os valores possíveis são: EXECUTED | NOT_EXECUTED

  • nextToken (opcional): o token de paginação para obter o próximo conjunto de informações. É um campo opcional que, se retornado nulo, significa que não há mais informações a serem carregadas.

Para ter mais informações, consulte ActionableInsights.

curl -v --location \
  "https://productivity.appfabric.<region>.amazonaws.com"\
"/actionableInsights" \
  --header "Authorization: Bearer <token>"

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

200 OK

{
    "insights": [
        {
            "insightId": "7tff3412-33b4-479a-8812-30EXAMPLE1111",
            "insightContent": "You received an email from James
            regarding providing feedback
            for upcoming performance reviews.",
            "insightTitle": "New feedback request",
            "createdAt": 2022-10-08T00:46:31.378493Z,
            "actions": [
                {
                    "actionId": "5b4f3412-33b4-479a-8812-3EXAMPLE2222",
                    "actionIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg",
                    "actionTitle": "Send feedback request email",
                    "actionUrl": "https://userportal.appfabric.us-east-1.amazonaws.com/action/action_id_1"
                    "actionExecutionStatus": "NOT_EXECUTED"
                }
            ]
        },
        {
            "insightId": "2dff3412-33b4-479a-8812-30bEXAMPLE3333",
            "insightContent":"Steve sent you an email asking for details on project. Consider replying to the email.",
            "insightTitle": "New team launch discussion",
            "createdAt": 2022-10-08T00:46:31.378493Z,
            "actions": [
                {
                    "actionId": "74251e31-5962-49d2-9ca3-1EXAMPLE1111",
                    "actionIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg",
                    "actionTitle": "Reply to team launch email",
                    "actionUrl": "https://userportal.appfabric.us-east-1.amazonaws.com/action/action_id_2"
                    "actionExecutionStatus": "NOT_EXECUTED"
                }
            ]
        }
    ],
    "nextToken": null
}

Preparação da reunião (ListMeetingInsights)

A API ListMeetingInsights ajuda os usuários a se prepararem melhor para as reuniões vindouras, resumindo o objetivo da reunião e revelando artefatos relevantes entre aplicações, como emails, mensagens e muito mais. Os usuários podem se preparar rapidamente para as reuniões agora e não perder tempo alternando entre aplicações para localizar conteúdo.

Campos de solicitação

  • nextToken (opcional): o token de paginação para obter o próximo conjunto de informações.

Cabeçalho da solicitação

  • O cabeçalho da autorização precisa ser passado com o valor Bearer Token.

Campos de resposta

  • insightId: o id exclusivo da informação gerada.

  • insightContent: a descrição da informação, destacando os detalhes em um formato de string. Por exemplo, por que essa informação é importante.

  • insightTitle: o título da informação gerada.

  • createdAt: quando a informação foi gerada.

  • calendarEvent: o evento ou reunião importante do calendário em que o usuário deve se concentrar. Objeto Calendar Event:

    • startTime: a hora de início do evento.

    • endTime: a hora de término do evento.

    • eventUrl: o URL do evento do calendário na aplicação do ISV.

  • resources: a lista contendo os outros recursos relacionados à geração da informação. Objeto de recurso:

    • appName: o nome da aplicação à qual o recurso pertence.

    • resourceTitle: o título do recurso.

    • resourceType: o tipo do recurso. Os valores possíveis são: EMAIL | EVENT | MESSAGE | TASK

    • resourceUrl: o URL do recurso na aplicação.

    • appIconUrl: o URL da imagem da aplicação à qual o recurso pertence.

  • nextToken (opcional): o token de paginação para obter o próximo conjunto de informações. É um campo opcional que, se retornado nulo, significa que não há mais informações a serem carregadas.

Para ter mais informações, consulte MeetingInsights.

curl --location \
  "https://productivity.appfabric.<region>.amazonaws.com"\
"/meetingContexts" \
  --header "Authorization: Bearer <token>"

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

200 OK

{
    "insights": [
        {
            "insightId": "74251e31-5962-49d2-9ca3-15EXAMPLE4444"
            "insightContent": "Project demo meeting coming up soon. Prepare accordingly",
            "insightTitle": "Demo meeting next week",
            "createdAt": 2022-10-08T00:46:31.378493Z,
            "calendarEvent": {
                    "startTime": {
                        "timeInUTC": 2023-10-08T10:00:00.000000Z,
                        "timeZone": "UTC"
                     },
                    "endTime": {
                        "timeInUTC": 2023-10-08T11:00:00.000000Z,
                        "timeZone": "UTC"
                     },
                    "eventUrl": "http://someapp.com/events/1234",
            }
            "resources": [
                {
                    "appName": "SOME_EMAIL_APP",
                    "resourceTitle": "Email for project demo",
                    "resourceType": "EMAIL",
                    "resourceUrl": "http://someapp.com/emails/1234",
                    "appIconUrl":"https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg"
                }
            ]
        },
        {
            "insightId": "98751e31-5962-49d2-9ca3-15EXAMPLE5555"
            "insightContent": "Important code complete task is now due. Consider updating the status.",
            "insightTitle": "Code complete task is due",
            "createdAt": 2022-10-08T00:46:31.378493Z,
            "calendarEvent":{
                    "startTime": {
                        "timeInUTC": 2023-10-08T10:00:00.000000Z,
                        "timeZone": "UTC"
                     },
                    "endTime": {
                        "timeInUTC": 2023-10-08T11:00:00.000000Z,
                        "timeZone": "UTC"
                     },
                    "eventUrl": "http://someapp.com/events/1234",
            },
            "resources": [
                {
                    "appName": "SOME_TASK_APPLICATION",
                    "resourceTitle": "Code Complete task is due",
                    "resourceType": "TASK",
                    "resourceUrl": "http://someapp.com/task/1234",
                    "appIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg"
                }
            ]
        }
    ],
    "nextToken": null
}

Forneça comentários sobre suas informações ou ações

Use a operação AppFabric PutFeedback da API para fornecer feedback sobre as informações e ações geradas. Você pode incorporar esse recurso em seus aplicativos para fornecer uma forma de enviar uma avaliação de feedback (de 1 a 5, em que quanto maior a classificação, melhor) para um determinado InsightId ou ActionId.

Campos de solicitação

  • id: o identificador do objeto para o qual o comentário está sendo enviado. Isso pode ser o InsightId ou ActionId o.

  • feedbackFor: o tipo de recurso para o qual o comentário está sendo enviado. Valores possíveis: ACTIONABLE_INSIGHT | MEETING_INSIGHT | ACTION

  • feedbackRating: classificação do comentário de 1 a 5. Quanto maior a classificação, melhor.

Campos de resposta

  • Não há campos de resposta.

Para ter mais informações, consulte PutFeedback.

curl --request POST \
  --url "https://productivity.appfabric.<region>.amazonaws.com"\
"/feedback" \
  --header "Authorization: Bearer <token>" \
  --header "Content-Type: application/json" \
  --data '{
    "id": "1234-5678-9012",
    "feedbackFor": "ACTIONABLE_INSIGHT"
    "feedbackRating": 3
}'

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 201 com um corpo HTTP vazio.

Etapa 5. Solicitação AppFabric para verificar sua inscrição

Até agora, você atualizou a interface do usuário do seu aplicativo para incorporar informações e ações AppFabric entre aplicativos e recebeu insights para um único usuário. Depois de ficar satisfeito com o teste e quiser estender sua experiência AppFabric aprimorada para mais usuários, você pode enviar sua inscrição AppFabric para análise e verificação. AppFabric verificará as informações do aplicativo antes de permitir uma ampla adoção para ajudar a proteger os desenvolvedores de aplicativos, os usuários finais e seus dados, abrindo caminho para expandir a adoção pelos usuários de forma responsável.

Inicie o processo de verificação

Comece o processo de verificação enviando um email para appfabric-appverification@amazon.com e solicitando que sua aplicação seja verificada.

No email, inclua os detalhes a seguir:

  • Seu Conta da AWS ID

  • O nome da aplicação para a qual você está buscando verificação

  • Seu AppClient ID

  • Suas informações de contato

Além disso, forneça as seguintes informações, se disponíveis, para nos ajudar a avaliar a prioridade e o impacto:

  • Um número estimado de usuários aos quais você planeja conceder acesso

  • Sua data de lançamento prevista

nota

Se você tiver um Conta da AWS gerente ou gerente de desenvolvimento de AWS parceiros, copie-os em seu e-mail. Incluir esses contatos pode ajudar a agilizar o processo de verificação.

Critérios de verificação

Antes de usar esse processo de verificação, verifique se ele atende aos critérios a seguir.

  • Você deve usar um válido Conta da AWS para usar AppFabric para produtividade

Além disso, você deve atender a pelo menos um destes critérios:

  • Sua organização é AWS parceira AWS Partner Network com pelo menos um nível “AWS Selecionar”. Para obter mais informações, consulte Níveis de serviços de parceiros da AWS.

  • Sua organização deveria ter gasto pelo menos $10.000 em AppFabric serviços nos últimos três anos.

  • Sua aplicação deve estar listada no AWS Marketplace. Para obter mais informações, consulte o AWS Marketplace.

Aguarde a atualização do status da verificação

Depois que sua inscrição for analisada, responderemos por e-mail e o status de sua inscrição AppClient mudará de pending_verification paraverified. Se a aplicação for rejeitada, você precisará reiniciar o processo de verificação.