Tarjetas adaptables CardPlatform (versión preliminar)
CardPlatform permite enviar tarjetas adaptables a los usuarios. Se puede usar para contenido accional, como aprobaciones, captura de formularios y mensajería general. Admite plantillas y tarjetas personalizadas.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con CardPlatform |
| URL | https://cardplatform.app/support |
| Correo Electrónico | support@cardplatform.app |
| Metadatos del conector | |
|---|---|
| Publicador | CardPlatform |
| Sitio web | https://cardplatform.app/ |
| Directiva de privacidad | https://cardplatform.app/privacy/ |
| Categorías | Colaboración; Comunicación |
CardPlatform permite enviar tarjetas adaptables y contenido accionable directamente a los usuarios.
Requisitos previos
Para usar CardPlatform, deberá:
- Cree una suscripción a CardPlatform para empezar a seleccionar el plan;
- Hay una suscripción de evaluación gratuita con la que se puede probar y experimentar.
Obtención de credenciales
Una vez completada la suscripción , recibirá la clave de API en un correo electrónico.
Una vez que tenga la clave de API, cree una nueva conexión, escriba la clave de API y empiece a enviar tarjetas.
Introducción al conector
Para empezar, primero envíe un mensaje:
Elija la acción Enviar mensaje .
Rellene los tres campos
Destinatarios: rellene su dirección de correo electrónico;
Encabezado: escriba un encabezado, por ejemplo, Hola mundo.
Inserte la tarjeta adaptable, en este ejemplo se enviará Hello World en la tarjeta, por ejemplo.
{ "$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" } ] }
Ejecute el flujo y la tarjeta aparecerá en Outlook.
Problemas y limitaciones conocidos
Si las tarjetas adaptables no se muestran en Outlook, hay un complemento de Outlook denominado Actionnable Message Debugger que puede ayudar a resolver el problema.
Instale desde el sitio del depurador de mensajes accionable .
La compatibilidad adicional está disponible en el sitio de soporte técnico de CardPlatform.
Preguntas más frecuentes
¿Cómo envío una aprobación?
Use la acción Enviar aprobación ;
¿Cómo envío un mensaje, sin esperar una respuesta?
Use la acción Enviar mensaje ;
¿Cómo diseño mis tarjetas adaptables?
Use el Diseñador de tarjetas adaptables para crear sus tarjetas adaptables;
¿Dónde encuentro el esquema y los ejemplos de tarjetas adaptables?
El esquema y los ejemplos se pueden encontrar en:
¿Qué son las plantillas?
Una plantilla le permite diseñar la tarjeta adaptable y, a continuación, aplicar los datos a ella, separando los datos del diseño de la tarjeta adaptable.
¿Qué son las plantillas públicas?
La comunidad crea plantillas públicas y está disponible para que todas las usen. Todas las plantillas públicas se pueden enumerar mediante la acción Enumerar plantillas públicas ;
¿Qué son las plantillas privadas?
Las plantillas privadas son su propia colección privada de plantillas, que se pueden almacenar y reutilizar.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | Clave de API de CardPlatform | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualización de una plantilla privada |
Actualiza el contenido de una plantilla privada. |
| Búsqueda de una plantilla pública |
Busque una plantilla pública mediante el análisis de la estructura de los datos. |
| Creación de una plantilla privada |
Cree una nueva plantilla privada. |
| Eliminación de una plantilla privada |
Quita una plantilla privada del conjunto de plantillas privadas. |
| Enumerar plantillas privadas |
Recupera una lista de todas las plantillas privadas. |
| Enumerar plantillas públicas |
Recupera una lista de todas las plantillas públicas. |
| Enviar aprobación |
Envía una tarjeta adaptable de aprobación y devuelve la respuesta con la opción y los campos especificados. |
| Enviar mensaje |
Envía una tarjeta adaptable como mensaje (sin acciones). |
| Enviar tarjeta adaptable |
Envía una tarjeta adaptable y devuelve la respuesta con la opción y los campos especificados. |
| Obtención de una plantilla privada |
Recupera una plantilla privada por nombre. |
| Obtener una plantilla pública |
Recupera el contenido de una plantilla pública. |
| Transformación de una plantilla privada |
Rellena una plantilla privada con los datos y devuelve una tarjeta adaptable totalmente rellenada. |
| Transformación de una plantilla pública |
Rellena una plantilla pública con los datos y devuelve una tarjeta adaptable totalmente rellenada. |
Actualización de una plantilla privada
Actualiza el contenido de una plantilla privada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de libro
|
name | True | string |
Nombre de libro |
|
|
object |
Búsqueda de una plantilla pública
Busque una plantilla pública mediante el análisis de la estructura de los datos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
|
object |
Devoluciones
- response
- object
Creación de una plantilla privada
Cree una nueva plantilla privada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de libro
|
name | True | string |
Nombre de libro |
|
|
object |
Devoluciones
- response
- object
Eliminación de una plantilla privada
Quita una plantilla privada del conjunto de plantillas privadas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de libro
|
name | True | string |
Nombre de libro |
Enumerar plantillas privadas
Recupera una lista de todas las plantillas privadas.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of string |
Enumerar plantillas públicas
Enviar aprobación
Envía una tarjeta adaptable de aprobación y devuelve la respuesta con la opción y los campos especificados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Recipientes
|
recipients | True | array of string |
Correo electrónico de destinatarios |
|
Heading
|
heading | True | string |
Heading |
|
Instrucciones
|
instructions | True | string |
Instrucciones |
|
Acciones
|
actions | True | array of string |
Lista de acciones |
|
Tipo de elección
|
choiceType | True | string |
Tipo de elección |
|
Opción predeterminada para aprobar
|
approvalChoice | True | string |
Opción predeterminada para aprobar |
|
Opción predeterminada para rechazar
|
rejectionChoice | True | string |
Opción predeterminada para rechazar |
Devoluciones
Respuesta de la tarjeta anterior
- Respuesta
- ResponseSchema
Enviar mensaje
Envía una tarjeta adaptable como mensaje (sin acciones).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Recipientes
|
recipients | True | array of string |
Dirección de correo electrónico de destinatarios |
|
Heading
|
heading | True | string |
Heading |
|
Tarjeta adaptable
|
card | True | string |
Tarjeta adaptable |
Devoluciones
- response
- CardResponseSchema
Enviar tarjeta adaptable
Envía una tarjeta adaptable y devuelve la respuesta con la opción y los campos especificados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Recipientes
|
recipients | True | array of string |
Dirección de correo electrónico de destinatarios |
|
Heading
|
heading | True | string |
Heading |
|
Tarjeta adaptable
|
card | True | string |
Tarjeta adaptable |
|
identificación
|
id | string |
Identificador para identificar la tarjeta |
|
|
Nombre de la tarjeta
|
cardname | string |
Nombre de la tarjeta |
Devoluciones
Respuesta de la tarjeta anterior
- Respuesta
- ResponseSchema
Obtención de una plantilla privada
Recupera una plantilla privada por nombre.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de la plantilla privada
|
name | True | string |
Nombre de la plantilla privada |
Devoluciones
- response
- object
Obtener una plantilla pública
Recupera el contenido de una plantilla pública.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso de la plantilla pública
|
path | True | string |
Ruta de acceso de la plantilla pública |
Devoluciones
Lista de plantillas
- Lista de plantillas
- TemplateListSchema
Transformación de una plantilla privada
Rellena una plantilla privada con los datos y devuelve una tarjeta adaptable totalmente rellenada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de libro
|
name | True | string |
Nombre de libro |
|
|
object |
Devoluciones
- response
- object
Transformación de una plantilla pública
Rellena una plantilla pública con los datos y devuelve una tarjeta adaptable totalmente rellenada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso de plantilla pública
|
path | True | string |
Ruta de acceso de la plantilla pública |
|
|
object |
Devoluciones
- response
- object
Definiciones
ResponseSchema
Respuesta de la tarjeta anterior
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
encuestado
|
respondent | string | |
|
respondentName
|
respondentName | string | |
|
encuestadoEmail
|
respondentEmail | string | |
|
choice
|
choice | string | |
|
comentario
|
comment | string | |
|
responseDate
|
responseDate | string |
TemplateListSchema
Lista de plantillas
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
list
|
list | array of object | |
|
key
|
list.key | string | |
|
templates
|
list.templates | array of object | |
|
archivo
|
list.templates.file | string | |
|
fullPath
|
list.templates.fullPath | string |
CardResponseSchema
objeto
Este es el tipo 'objeto'.