Cartões adaptáveis CardPlatform (Pré-visualização)

CardPlatform permite que você envie cartões adaptáveis para os usuários. Pode ser usado para conteúdo de ação, como aprovações, captura de formulários e mensagens gerais. Ele suporta modelos e cartões personalizados.

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

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Suporte CardPlatform
URL	https://cardplatform.app/support
Email	support@cardplatform.app

Metadados do conector
Editora	CardPlatform
Sítio Web	https://cardplatform.app/
Política de privacidade	https://cardplatform.app/privacy/
Categorias	Colaboração; Comunicação

CardPlatform permite que você envie Adaptive Cards e conteúdo acionável diretamente para seus usuários.

Pre-requisites

Para usar o CardPlatform, você precisará:

• Criar uma subscrição CardPlatform, para começar a selecionar o plano;
• Há uma assinatura de avaliação gratuita que está disponível para teste e experimentação.

Como obter credenciais

Após a conclusão da inscrição , você receberá sua chave de API em um e-mail.

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

2. Preencha os três campos

   • Destinatários - preencha o seu endereço de e-mail;

   • Cabeçalho - Escreva um título, por exemplo, Hello World

   • 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 aparecerá no Outlook

Problemas conhecidos e limitações

Se seus cartões adaptáveis não estão sendo mostrados no Outlook, há um plug-in do Outlook chamado Actionnable Message Debugger que pode ajudar a resolver o problema.

Instale a partir do site do Depurador de Mensagens Acionável .

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

FAQ

1. Como faço para enviar uma aprovação?

   Use a ação Enviar aprovação ;

2. Como posso enviar uma mensagem sem esperar por uma resposta?

   Use a ação Enviar mensagem ;

3. Como faço para projetar meus cartões adaptáveis?

   Use o Adaptive Card Designer para criar seus Adaptive Cards;

4. Onde posso encontrar o esquema e os exemplos para Adaptive Cards?

   O esquema e os exemplos podem ser encontrados em:

   • adaptivecards.io
   • madewithcards.io

5. O que são modelos?

   Um modelo permite que você projete o Adaptive Card e, em seguida, aplique os dados a ele, separando dados do layout do Adaptive Card.

   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.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 API da CardPlatform	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de 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.
Encontrar um modelo público	Encontre um modelo público analisando a estrutura dos seus dados.
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.
Obter um modelo privado	Recupera um modelo privado pelo nome.
Obter um modelo público	Recupera o conteúdo de um modelo público.
Transformar modelo privado	Preenche um modelo privado com os dados e retorna um Cartão adaptável totalmente preenchido.
Transformar modelo público	Preenche um modelo público com os dados e retorna um Cartão adaptável totalmente preenchido.

Atualizar um modelo privado

ID da Operação:

PrivateTemplates_Update

Atualiza o conteúdo de um modelo privado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Modelo	name	True	string	Nome do Modelo
			object

Criar um modelo privado

ID da Operação:

PrivateTemplates_Create

Crie um novo modelo privado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Modelo	name	True	string	Nome do Modelo
			object

Devoluções

response

object

Encontrar um modelo público

ID da Operação:

PublicTemplate_Find

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
			object

Devoluções

response

object

Enviar aprovação

ID da Operação:

SendApproval

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Destinatários	recipients	True	array of string	E-mail dos destinatários
Heading	heading	True	string	Heading
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
Escolha padrão para aprovar	approvalChoice	True	string	Escolha padrão para aprovar
Escolha padrão para rejeitar	rejectionChoice	True	string	Escolha padrão para rejeitar

Devoluções

Resposta de cartão anterior

Resposta

ResponseSchema

Enviar cartão adaptável

ID da Operação:

SendCard

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Destinatários	recipients	True	array of string	Endereço de e-mail dos destinatários
Heading	heading	True	string	Heading
Cartão adaptável	card	True	string	Cartão adaptável
ID	id		string	Documento de identificação para identificar o cartão
Nome do Cartão	cardname		string	Nome do Cartão

Devoluções

Resposta de cartão anterior

Resposta

ResponseSchema

Enviar Mensagem

ID da Operação:

SendMessage

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Destinatários	recipients	True	array of string	Endereço de e-mail dos destinatários
Heading	heading	True	string	Heading
Cartão adaptável	card	True	string	Cartão adaptável

Devoluções

response

CardResponseSchema

Excluir modelo privado

ID da Operação:

PrivateTemplates_Delete

Remove um modelo privado do conjunto de modelos privados.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Modelo	name	True	string	Nome do Modelo

Listar modelos privados

ID da Operação:

PrivateTemplate_GetAll

Recupera uma lista de todos os modelos privados.

Devoluções

Name	Caminho	Tipo	Description
		array of string

Listar modelos públicos

ID da Operação:

PublicTemplate_GetAll

Recupera uma lista de todos os modelos públicos.

Devoluções

response

object

Obter um modelo privado

ID da Operação:

PrivateTemplate_Get

Recupera um modelo privado pelo nome.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do modelo privado	name	True	string	Nome do modelo privado

Devoluções

response

object

Obter um modelo público

ID da Operação:

PublicTemplate_Get

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Caminho do modelo público	path	True	string	Caminho do modelo público

Devoluções

Lista de modelos

Lista de modelos

TemplateListSchema

Transformar modelo privado

ID da Operação:

PrivateTemplate_Transform

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Modelo	name	True	string	Nome do Modelo
			object

Devoluções

response

object

Transformar modelo público

ID da Operação:

PublicTemplate_Transform

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Caminho do modelo público	path	True	string	Caminho do modelo público
			object

Devoluções

response

object

Definições

ResponseSchema

Resposta de cartão anterior

Name	Caminho	Tipo	Description
entrevistado	respondent	string
Nome do entrevistado	respondentName	string
respondentE-mail	respondentEmail	string
choice	choice	string
comentário	comment	string
data-resposta	responseDate	string

TemplateListSchema

Lista de modelos

Name	Caminho	Tipo	Description
lista	list	array of object
chave	list.key	string
templates	list.templates	array of object
ficheiro	list.templates.file	string
caminho completo	list.templates.fullPath	string

CardResponseSchema

string

objecto

Este é o tipo 'objeto'.