Saltar al contenido principal

General

Las referencias en Whats UY son la forma en que asociamos una cuenta de WhatsApp con nuestro servicio, lo que te permite interactuar con la API.

Crear una Nueva Referencia​

Las referencias te permiten asociar una cuenta de WhatsApp escaneando un código QR. Estas referencias habilitan el envío de mensajes y la configuración de la redirección de mensajes a un webhook de tu elección. Además, puedes asignar un bot para que maneje las interacciones con tus clientes.

Para solicitar una nueva referencia, visita tu perfil y haz clic en "Solicitar Nueva Referencia".

Si prefieres crear la referencia a través de la API, puedes hacerlo utilizando el siguiente endpoint:

curl --location --request POST 'https://api.whatsuy.com/references/add' \
--header 'Authorization: Bearer <your-token>' \
--header 'Content-Type: application/json'

Respuesta de ejemplo:

{
    "success": true,
    "message": "",
    "data": {
        "reference": {
            "reference": 11111111,
            "state": "ESPERANDO-LOGIN",
            "active": false,
            "lastChange": "2022-08-26T20:23:36.693Z",
            "lastValidPaiment": null,
            "lastAccountSyncTimestamp": null,
            "createdAt": "2022-08-26T20:23:36.693Z",
        }
    }
}

Asociar Sesión de WhatsApp​

Para asociar tu cuenta de WhatsApp, debes generar un código QR. Para hacerlo, ve a la referencia y haz clic en "Click para generar QR". Luego, abre tu aplicación de WhatsApp y sigue estos pasos:

  1. Abre el Menú.
  2. Ve a "Dispositivos Vinculados".
  3. Haz clic en "VINCULAR UN DISPOSITIVO".
  4. Escanea el código QR.

También puedes obtener el código QR a través de la API de la siguiente manera:

curl --location --request POST 'https://api.whatsuy.com/sessions/add' \
--header 'Authorization: Bearer <your-token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "11111111"
}'

Recibirás una respuesta que incluye el valor data.update.qr, que deberás mostrar como imagen QR.

Estado de la Referencia​

Puedes comprobar el estado de tu referencia con el siguiente comando:

curl --location --request GET 'https://api.whatsuy.com/references/find/11111111' \
--header 'Authorization: Bearer <your-token>' \
--header 'Content-Type: application/json'

Sandbox​

Las referencias de tipo sandbox te permiten realizar pruebas necesarias para integrar tus procesos o sistema con Whats UY. Funcionan de la misma manera que las referencias normales, pero tienen las siguientes diferencias:

  • No requieren pagos para funcionar y no pueden recibir pagos.
  • Tienen un límite de hasta 250 mensajes de salida y 500 mensajes de entrada diarios.
  • Solo puedes enviar mensajes de texto y estos tendrán un prefijo indicando que se envían mediante un sandbox.

Pagos​

Los pagos extienden la duración de uso de la referencia, añadiendo un mes a la misma. Si tienes algún problema con los pagos, por favor, genera una consulta en la sección de soporte del sistema. Si tienes alguna duda o necesitas ayuda adicional, nuestro equipo de soporte estará encantado de ayudarte.