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 |
| 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:
Escolha a ação Enviar Mensagem
Preencha os três campos
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" } ] }
Execute o fluxo e o cartão será exibido 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
Como enviar uma aprovação?
Use a ação Enviar Aprovação ;
Como enviar uma mensagem sem esperar uma resposta?
Use a ação Enviar Mensagem ;
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;
Onde encontro o esquema e os exemplos de Cartões Adaptáveis?
O esquema e os exemplos podem ser encontrados em:
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.
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 ;
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
- response
- CardResponseSchema
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
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'.