Resumen
Wati proporciona un conjunto de API que te ayudan a interactuar con WhatsApp mediante programación. Puedes utilizar estas API para enviar y recibir mensajes, gestionar contactos, manejar medios e integrar Wati con tus sistemas existentes. Esta guía te ofrece una visión general clara de las API disponibles y de lo que hace cada una, para que puedas empezar rápidamente.
Instrucciones
API disponibles
Con Wati, puedes acceder a múltiples API agrupadas por funcionalidad.
API de mensajería
Utiliza estas API para enviar y recibir mensajes en WhatsApp.
Obtener mensajes del número de WhatsApp - Recupera los mensajes recibidos en tu número de WhatsApp.
Enviar mensaje de sesión - Envía un mensaje dentro de una sesión activa de WhatsApp.
Enviar archivo de sesión - Envía un archivo adjunto dentro de una sesión activa.
Enviar mensaje de plantilla - Envía un mensaje de plantilla de WhatsApp preaprobado.
Enviar mensajes de plantilla (en masa) - Envía varios mensajes de plantilla a la vez.
Enviar mensaje de plantilla usando CSV - Carga un archivo CSV para enviar mensajes de plantilla de forma masiva.
Enviar mensaje de botón interactivo - Envía mensajes con botones en los que se puede hacer clic para obtener respuestas rápidas.
Enviar mensaje de lista interactiva - Envía mensajes con una lista de opciones seleccionable.
API de gestión de contactos
Utiliza estas API para gestionar tu base de datos de contactos.
Obtener lista de contactos - Recupera todos los contactos almacenados en Wati.
Añadir contacto - Crear un nuevo contacto.
Actualizar atributos de contacto - Modifica los detalles de un contacto existente.
API de medios y autenticación
Utiliza estas API para gestionar archivos y asegurar el acceso.
Obtener medio por nombre de archivo - Recupera archivos multimedia utilizando sus nombres de archivo.
Rotar token - Actualiza tu token de autenticación para mantener un acceso seguro a la API.
API de operador y asignación
Utiliza estas API para gestionar la propiedad y el enrutamiento del chat.
Asignar operador - Asigna una conversación de WhatsApp a un operador específico.
¿Dónde puedo encontrar el punto final de la API y el token de acceso?
Para acceder a los detalles de tu API en Wati:
1. Inicia sesión en tu cuenta de Wati.
2. En el menú de navegación, haz clic en API, o ve a: Connector → API → Create API Token
3. En la página API Tokens, haz clic en Generate new token.
4. Introduce un nombre de token y selecciona los ámbitos (permisos) necesarios, como:
contacts:readcontacts:writemessagetemplate:read
5. (Opcional) Establece una fecha de caducidad para el token. Por seguridad, se recomienda rotar los tokens cada 6 meses.
6. Copia y guarda de forma segura el token generado.
Nota:
La nueva opción Crear nuevo token elimina las dependencias a nivel de usuario y permanecerá válida hasta que se actualice manualmente o alcance su fecha de vencimiento.
Cuando utiliza la opción Crear nuevo token, el token se muestra solo una vez en el momento de su generación, por lo que debe copiarlo y guardarlo de forma segura.
Recursos adicionales
Documentación de la API de Wati: referencia detallada de todas las API disponibles
Documentación de Webhook: aprende a configurar y manejar webhooks
Colección Postman: una colección lista para usar para probar las API de Wati
Estas API te ayudan a automatizar la comunicación de WhatsApp, a agilizar los flujos de trabajo de mensajería y a gestionar las interacciones con los clientes de forma más eficiente. Consulta la documentación para obtener información detallada sobre la implementación y las mejores prácticas.
Preguntas frecuentes (FAQ)
API de mensajería
1. ¿Para qué se utilizan las API de mensajería de Wati?
Las API de mensajería de Wati te permiten enviar y recibir mensajes de WhatsApp mediante programación. Estas API habilitan acciones como recuperar mensajes recibidos en tu número de WhatsApp, enviar mensajes o archivos dentro de una sesión activa de WhatsApp, enviar mensajes de plantilla preaprobados, enviar mensajes de plantilla masivos y enviar mensajes interactivos con botones o listas seleccionables.
2. ¿Cómo puedes recuperar los mensajes recibidos en tu número de WhatsApp utilizando las API de Wati?
Puedes recuperar los mensajes recibidos en tu número de WhatsApp utilizando la API Get messages from WhatsApp number. Esta API devuelve los mensajes que se han recibido en el número de WhatsApp conectado en Wati.
3. ¿Qué tipos de mensajes se pueden enviar utilizando las API de mensajería de Wati?
Las API de mensajería de Wati te permiten enviar varios tipos de mensajes, incluyendo mensajes de sesión durante una sesión activa de WhatsApp, archivos adjuntos dentro de una sesión activa, mensajes de plantilla de WhatsApp preaprobados, mensajes de plantilla masivos, mensajes de botón interactivos y mensajes de lista interactivos.
API de gestión de contactos
4. ¿Para qué se utilizan las API de gestión de contactos de Wati?
Las API de gestión de contactos de Wati te permiten gestionar la base de datos de contactos almacenada en Wati. Estas API te permiten recuperar la lista de contactos, crear nuevos contactos y actualizar los atributos de los contactos existentes.
5. ¿Cómo puedes recuperar o actualizar contactos utilizando las API de Wati?
Puedes recuperar contactos utilizando la API Get contact list, crear un nuevo contacto utilizando la API Add contact y modificar los detalles de contacto utilizando la API Update contact attributes.
Gestión de medios, autenticación y conversaciones
6. ¿Para qué se utilizan las API de medios y autenticación en Wati?
Las API de medios y autenticación te permiten recuperar archivos multimedia almacenados en Wati y mantener un acceso seguro a la API. Por ejemplo, la API Get media by file name recupera los archivos multimedia almacenados, y la API Rotate token actualiza el token de autenticación utilizado para acceder a las API de Wati.
7. ¿Cómo puedes asignar una conversación de WhatsApp a un operador utilizando las API de Wati?
Puedes asignar una conversación de WhatsApp a un operador específico utilizando la API Assign operator. Esta API enruta la conversación al operador seleccionado para que pueda gestionar el chat.
Acceso y configuración de la API
8. ¿Dónde puedes encontrar el punto final de la API y el token de acceso en Wati?
Puedes encontrar el punto final de la API y el token de acceso iniciando sesión en tu cuenta de Wati y navegando a API en el menú de navegación, o yendo a Connector → API → Create API Token.
9. ¿Cómo se genera un nuevo token de API en Wati?
Para generar un nuevo token de API, abre la página API Tokens en Wati, haz clic en Generate new token, introduce un nombre de token, selecciona los ámbitos necesarios como contacts:read, contacts:write o messagetemplate:read, opcionalmente establece una fecha de caducidad, y luego copia y guarda de forma segura el token generado. Se recomienda rotar los tokens cada seis meses por seguridad.