Índice:
Introducción
Pagos PicPay es una extensión que permite de manera rápida y sencilla habilitar el medio de pago de PicPay en el contacto inteligente.
Por ejemplo: es posible proporcionar al usuario un enlace de pago de PicPay y verificar el historial de transacciones ocurridas en el bot a través de la misma extensión.
| Observación: ¡Extensión disponible solo en portugués! |
¿Cómo funciona?
Payment Module PicPay ofrece las siguientes funcionalidades:
- Creación de enlaces de pagos
- Informe de transacciones realizadas en el bot
Es compatible con los siguientes canales: WhatsApp
Instalación y configuración
Al activar la extensión en la Tienda Blip, deberá ser instalada en el bot ENRUTADOR con el canal de WhatsApp habilitado. Después de su activación, deberá seguir los pasos a continuación para su correcto funcionamiento.
- Crear un bot que se utilizará para el flujo de pagos.
Este subbot será utilizado por la extensión para publicar el flujo de pagos que será utilizado por la API de integración.
Nombre sugerido para el bot: Bot Pagos PicPay.
Nombre sugerido para el servicio en el enrutador: picpay.
Solo será necesario crear el bot, HABILITAR EL CONTEXTO DEL ENRUTADOR, publicar el flujo ya existente y conectarlo como servicio en el enrutador.
Configurar el contexto del enrutador
Publicar flujo
Por último, configura el servicio en tu enrutador.
Para hacerlo, sigue las instrucciones en nuestro artículo "Cómo crear un enrutador de bots" en el Centro de Ayuda.
- Acceder a la extensión de Pagos PicPay
Ingresa las credenciales de PicPay y selecciona el subbot creado anteriormente para la publicación del flujo de pagos. Luego, simplemente haz clic en conectar. Al hacerlo, el flujo de pagos se agregará al subbot seleccionado.
Tela Inicial de la Extensión
Las credenciales de PicPay las obtendrás desde tu cuenta de PicPay Empresas.
Obtener credenciales de PicPay
- Configurar la redirección del flujo existente al subbot.
Recuerda que la incorporación de un nuevo método de pago requerirá una adaptación en el flujo del contacto inteligente, por ejemplo, un menú de opciones para que el usuario elija el método de pago deseado.
Para enviar al usuario a través del flujo de pagos al subbot de pagos, será necesario crear una redirección que envíe el siguiente objeto como mensaje:
{
"origin": "nomeDoServicoAtual", //fluxo que envia o usuario
"destination": "picpay", //nome do servico do subbot
"userInput": "inputDoUsuario", //ultimo input do usuario
"custom": {
"picpay": {
"firstName": "PRIMEIRO NOME", //primeiro nome do usuario
"lastName": "ULTIMO NOME", //sobrenome do usuario
"cpf": "01234567890", //cpf do usuario
"amount": 1.99 //valor da transacao a ser criada
}
},
"callback": {
"serviceName": "servicoAposPagamento" //nome do servico que o usario devera ser redirecionado na volta do pagamento
}
}
Este objeto debe ser generado mediante una acción de "Ejecutar Script" que se debe ejecutar antes de la acción de "Redirigir a un servicio". A continuación, se muestra un ejemplo de script para construir el objeto:
function run(input,firstName,lastName,cpf,valor) {
let obj = {
"origin": "main",
"destination": "payments",
"userInput": input,
"custom": {
"picpay": {
"firstName": firstName,
"lastName": lastName,
"cpf": cpf,
"amount": parseFloat(valor)
}
},
"callback": {
"serviceName": "main"
}
};
return obj;
}
Este script recibe las variables de entrada:
- input.content
- firstName
- lastName
- cpf
- valor
Con excepción de input.content, las variables deben ser definidas en algún momento del flujo de conversación con tu cliente; la variable valor debe ser enviada como formato float en el objeto.
Considerando que la variable de retorno del script anterior será objService, puedes configurar la redirección al servicio de la siguiente manera:
Cuando el usuario sea redirigido de vuelta, después de que el pago haya sido exitoso o no, será redirigido al servicio agregado al "callback" con el siguiente mensaje:
{
"origin": "open-finance-take",
"destination": "servicoAposPagamento",
"userinput": "inputDoUsuario",
"custom": {
"picpay": {
"Success": "true",
"FailReason": ""
}
}
}
Este mensaje te permitirá manejar de la mejor manera cada situación de retorno del flujo de pago.
- Hacer seguimiento de las ventas realizadas por el bot
A partir del momento en que todo esté configurado, tu contacto inteligente estará listo para vender utilizando el método de pago de PicPay a través de la extensión.
Podrás hacer seguimiento de las transacciones que ocurran en el bot mediante la extensión.
Pantalla de informe de la extensión
Ejemplos de uso
- Conexión con tu cuenta de PicPay
- Accede a la Extensión: [Enlace de acceso a la extensión]
Insira las credenciales y elija el bot que ha sido previamente publicado, de acuerdo con el tema de instalación.
Después de conectar, la pantalla cambiará automáticamente al informe de transacciones, donde podrás hacer un seguimiento de las transacciones que se realizan en el contacto inteligente. La extensión no mostrará todas las ventas realizadas con tu cuenta de PicPay, solo aquellas realizadas a través del CI (Contacto Inteligente).
Soporte
Si tienes alguna duda o encuentras algún problema con la extensión, contáctanos al número (31) 3349-6201.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃