Índice:
Introducción
La extensión Catalyst AI Personal Shopper fue desarrollada por Dawntech Inc. Actualmente, se encuentra en la versión 1.0 y está disponible en portugués de Brasil, español e inglés.
Con esta extensión, el usuario puede tener acceso a un catálogo personalizado de productos generado a través de inteligencia artificial, funcionando como un personal shopper vía WhatsApp.
Este manual tiene como objetivo ayudar a los usuarios de la plataforma Blip en la instalación, configuración y uso de la extensión Catalyst AI Personal Shopper. Además, cualquier duda sobre el uso puede ser dirigida a contact@dawntech.dev o llamando al (51) 3557-2998.
Acerca de la Extensión
La extensión Catalyst AI Personal Shopper fue desarrollada con el objetivo de integrar un flujo de comercio electrónico dentro del Constructor de Blip a un catálogo específico de Facebook, lo que hace posible mostrar los productos en los canales publicados.
Las siguientes funcionalidades se ofrecen:
- Obtención de componentes del catálogo de productos de WhatsApp a partir de un catálogo de Facebook, filtrado por campo personalizado y mensaje de contactos al chatbot, haciendo uso del contexto de conversación de 24 horas de los contactos.
- Posibilidad de obtener PLMs (mensajes de lista de productos) para WhatsApp y carruseles de imágenes para otros canales.
- Diversos filtros ya disponibles a través de API, como se puede ver en la documentación.
- Devolución de mensaje personalizado de acuerdo con la entrada de los usuarios y los productos devueltos.
Instalación y Configuración
Para utilizar la extensión Catalyst AI Personal Shopper, en el bot Router asociado al contrato, ve a la Blip Store y busca la extensión Catalyst AI Personal Shopper en la pestaña de Extensiones. Cuando la encuentres, actívala en ese mismo bot. Después de la instalación, al abrir el bot Router, las opciones de configuración de la extensión Catalyst AI Personal Shopper estarán disponibles: La pantalla de configuración de la extensión se muestra en la figura a continuación:
En caso de errores, la extensión avisará sobre los inputs con problemas:
Manual de Uso
Los usuarios con permiso de administrador pueden cambiar la información de configuración de la extensión, además de agregar llamadas HTTP específicas al Constructor para la extensión, utilizando las configuraciones mencionadas anteriormente.
Para utilizar las características de la extensión, es necesario configurar una acción de tipo Solicitud HTTP llamando a la URL a continuación, con dos parámetros de URL: takeblip-bot-key y takeblip-tenant-id (o a través de headers, con los mismos nombres), siendo la clave de acceso del bot donde se instaló la extensión (bot Router) y el nombre del contrato, respectivamente (como se ilustra en la figura siguiente). Para facilitar su uso, la URL con estos parámetros se genera automáticamente en la sección Información Generada.
La extensión proporciona dos puntos finales HTTP:
- Obtención de productos del catálogo (POST):
- URL: https://api.catalyst.dwnt.store/catalyst-ai-personal-shopper/search?takeblip-tenant-id={{tenant_id}}&takeblip-bot-key={{router_api_key}}&openai-api-key={{openai_key}}.
- Payload (JSON):
{
"input": "Mensaje libre del usuario",
"phone": "Identificador del contacto para guardar contexto",
"filter": { "{campo}": "{valor}" }, // El filtro se puede usar en conjunto con la entrada del usuario
"text": {
"header": "Productos",
"body": "¡Aprende más haciendo clic aquí!",
"footer": "¡Haz clic abajo!",
"section_name": "Productos"
}
}
Donde {campo} y {valor} determinan el filtro a ser aplicado en el catálogo de Facebook. Por ejemplo, usando {campo} y {valor} con los valores "name" y "Blusa", respectivamente, se devolverán los productos en el catálogo de Facebook que tienen "Blusa" en la columna "name".
El mensaje libre ("input") puede ser cualquier cosa, como por ejemplo "Necesito un atuendo para un cumpleaños al aire libre".
El campo "phone" se utiliza para almacenar el contexto de la conversación del usuario para respuestas más precisas y tiene un tiempo máximo de almacenamiento de 24 horas, siendo reseteado después de este período.
La respuesta de la solicitud viene en el siguiente formato:
{
"dynamic-content": { // Contenido dinámico para usar en Constructor con tipo application/json
"type": "interactive",
"interactive": {
"type": "product_list",
"header": {
"type": "text",
"text": "Productos"
},
"body": {
"text": "¡Aprende más haciendo clic aquí!"
},
"footer": {
"text": "¡Haz clic abajo!"
},
"action": {
"catalog_id": "865085895408431",
"sections": [
{
"product_items": [
{
"product_retailer_id": "ID_1"
},
{
"product_retailer_id": "ID_2"
},
// ...
{
"product_retailer_id": "ID_N"
}
]
}
]
}
}
},
"message": "Mensaje personalizado generado por inteligencia artificial de acuerdo con los productos encontrados y la pregunta del contacto"
}
2.Obtención de resumen de carrito (POST):
-
- URL: https://api.catalyst.dwnt.store/catalog-extension/cartSummary?takeblip-tenant-id={{tenant_id}}&takeblip-bot-key={{router_api_key}}.
- Payload (JSON):
{
"product_items": [
{
"product_retailer_id": "<STRING>",
"quantity": "<STRING (por ejemplo: 1)>",
"item_price": "<STRING (por ejemplo: 1.5)>",
"currency": "<STRING (por ejemplo: USD)>"
},
...
]
}
Términos de Uso
Al instalar esta extensión, usted acepta los términos de uso descritos en dawntech.dev/privacy, lo cual también se aplica al uso de datos recopilados por la extensión (si/cuando sea necesario).
SLA
El SLA de esta y otras extensiones de Dawntech Inc. se puede acceder en status.dawntech.dev.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃