Compartilhar via


Cartões Adaptáveis CardPlatform (versão prévia)

O CardPlatform permite que você envie Cartões Adaptáveis aos usuários. Pode ser usado para conteúdo acionário, como aprovações, captura de formulários e mensagens gerais. Ele dá suporte à modelagem e cartões personalizados.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte a CardPlatform
URL https://cardplatform.app/support
Email support@cardplatform.app
Metadados do conector
Publicador CardPlatform
Site https://cardplatform.app/
Política de privacidade https://cardplatform.app/privacy/
Categorias Colaboração; Comunicação

O CardPlatform permite que você envie Cartões Adaptáveis e conteúdo acionável diretamente para seus usuários.

Pré-requisitos

Para usar CardPlatform, você precisará:

  • Crie uma assinatura cardPlatform para iniciar a seleção do plano;
  • Há uma assinatura de avaliação gratuita que está disponível para avaliação e teste.

Como obter credenciais

Após a conclusão da inscrição , você receberá sua Chave de API em um email.

Depois de ter a Chave de API, crie uma nova Conexão, insira a Chave de API e comece a enviar cartões.

Introdução ao conector

Para começar, primeiro envie uma mensagem:

  1. Escolha a ação Enviar Mensagem

    Selecione a ação Enviar Mensagem

  2. Preencha os três campos

    Selecione a ação Enviar Mensagem

    • Destinatários – preencha seu endereço de email;

    • Título – Escrever um título, por exemplo, Olá, Mundo

    • Insira o cartão adaptável, este exemplo enviará Hello World no cartão, por exemplo,

      {
          "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
              {
                  "type": "TextBlock",
                  "size": "Large",
                  "isSubtle": true,
                  "wrap": true,
                  "text": "Hello World"
              }
          ]
      }
      
  3. Execute o fluxo e o cartão será exibido no Outlook

    Cartão Adaptável no Outlook

Problemas e limitações conhecidos

Se seus cartões adaptáveis não estiverem sendo mostrados no Outlook, haverá um plug-in do Outlook chamado Depurador de Mensagens Acionável que pode ajudar a resolver o problema.

Instale no site do Depurador de Mensagens Acionável .

O suporte extra está disponível no site de suporte do CardPlatform.

perguntas frequentes

  1. Como enviar uma aprovação?

    Use a ação Enviar Aprovação ;

  2. Como enviar uma mensagem sem esperar uma resposta?

    Use a ação Enviar Mensagem ;

  3. Como faço para projetar meus Cartões Adaptáveis?

    Use o Designer de Cartão Adaptável para criar seus Cartões Adaptáveis;

  4. Onde encontro o esquema e os exemplos de Cartões Adaptáveis?

    O esquema e os exemplos podem ser encontrados em:

  5. O que são modelos?

    Um modelo permite que você projete o Cartão Adaptável e aplique os dados a ele, propagando dados do layout do Cartão Adaptável.

    1. O que são modelos públicos?

      Os modelos públicos são criados pela comunidade e estão disponíveis para todos usarem. Todos os modelos públicos podem ser listados usando a ação Listar modelos públicos ;

    2. O que são modelos privados?

      Modelos privados são sua própria coleção privada de modelos, que podem ser armazenados e reutilizados.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API secureString Chave de API do CardPlatform Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Atualizar um modelo privado

Atualiza o conteúdo de um modelo privado.

Criar um modelo privado

Crie um novo modelo privado.

Enviar Aprovação

Envia um Cartão Adaptável de Aprovação e retorna a resposta com a escolha e os campos inseridos.

Enviar cartão adaptável

Envia um Cartão Adaptável e retorna a resposta com a escolha e os campos inseridos.

Enviar Mensagem

Envia um Cartão Adaptável como uma mensagem (sem ações).

Excluir modelo privado

Remove um modelo privado do conjunto de modelos privados.

Listar modelos privados

Recupera uma lista de todos os modelos privados.

Listar modelos públicos

Recupera uma lista de todos os modelos públicos.

Localizar um modelo público

Encontre um modelo público analisando a estrutura de seus dados.

Obter um modelo privado

Recupera um modelo privado por nome.

Obter um modelo público

Recupera o conteúdo de um modelo público.

Transformar modelo privado

Popula um modelo privado com os dados e retorna um Cartão Adaptável totalmente preenchido.

Transformar modelo público

Popula um modelo público com os dados e retorna um Cartão Adaptável totalmente preenchido.

Atualizar um modelo privado

Atualiza o conteúdo de um modelo privado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do Modelo
name True string

Nome do Modelo

object

Criar um modelo privado

Crie um novo modelo privado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do Modelo
name True string

Nome do Modelo

object

Retornos

response
object

Enviar Aprovação

Envia um Cartão Adaptável de Aprovação e retorna a resposta com a escolha e os campos inseridos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Destinatários
recipients True array of string

Email de destinatários

Título
heading True string

Título

Instruções
instructions True string

Instruções

Ações
actions True array of string

Lista de ações

Tipo de escolha
choiceType True string

Tipo de escolha

Opção padrão para aprovar
approvalChoice True string

Opção padrão para aprovar

Opção padrão para rejeição
rejectionChoice True string

Opção padrão para rejeição

Retornos

Resposta do cartão anterior

Resposta
ResponseSchema

Enviar cartão adaptável

Envia um Cartão Adaptável e retorna a resposta com a escolha e os campos inseridos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Destinatários
recipients True array of string

Endereço de email de destinatários

Título
heading True string

Título

Cartão Adaptável
card True string

Cartão Adaptável

ID
id string

ID para identificar o cartão

Nome do cartão
cardname string

Nome do cartão

Retornos

Resposta do cartão anterior

Resposta
ResponseSchema

Enviar Mensagem

Envia um Cartão Adaptável como uma mensagem (sem ações).

Parâmetros

Nome Chave Obrigatório Tipo Description
Destinatários
recipients True array of string

Endereço de email de destinatários

Título
heading True string

Título

Cartão Adaptável
card True string

Cartão Adaptável

Retornos

Excluir modelo privado

Remove um modelo privado do conjunto de modelos privados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do Modelo
name True string

Nome do Modelo

Listar modelos privados

Recupera uma lista de todos os modelos privados.

Retornos

Nome Caminho Tipo Description
array of string

Listar modelos públicos

Recupera uma lista de todos os modelos públicos.

Retornos

response
object

Localizar um modelo público

Encontre um modelo público analisando a estrutura de seus dados.

Parâmetros

Nome Chave Obrigatório Tipo Description
object

Retornos

response
object

Obter um modelo privado

Recupera um modelo privado por nome.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do modelo privado
name True string

Nome do modelo privado

Retornos

response
object

Obter um modelo público

Recupera o conteúdo de um modelo público.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do modelo público
path True string

Caminho do modelo público

Retornos

Lista de modelos

Lista de modelos
TemplateListSchema

Transformar modelo privado

Popula um modelo privado com os dados e retorna um Cartão Adaptável totalmente preenchido.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do Modelo
name True string

Nome do Modelo

object

Retornos

response
object

Transformar modelo público

Popula um modelo público com os dados e retorna um Cartão Adaptável totalmente preenchido.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho do modelo público
path True string

Caminho do modelo público

object

Retornos

response
object

Definições

ResponseSchema

Resposta do cartão anterior

Nome Caminho Tipo Description
entrevistado
respondent string
respondentName
respondentName string
respondentEmail
respondentEmail string
escolha
choice string
comentário
comment string
responseDate
responseDate string

TemplateListSchema

Lista de modelos

Nome Caminho Tipo Description
lista
list array of object
chave
list.key string
templates
list.templates array of object
arquivo
list.templates.file string
fullPath
list.templates.fullPath string

CardResponseSchema

objeto

Esse é o tipo 'object'.