Introducción
En este tutorial se describe cómo configurar el cliente de la API local, registrar un número de teléfono de empresa, actualizar la configuración y enviar un mensaje de prueba.
El proceso para empezar a usar la API se puede dividir en tres partes:
- Preparar los activos: antes de comenzar, debes configurar los activos necesarios para completar la integración de la API, incluida una cuenta de WhatsApp Business.
- Instalar el cliente de la API local: instala el cliente de la API. Una vez que este funcione, podrás actualizar la configuración de la aplicación.
- Empezar a usar el cliente: registra tu número de teléfono con una llamada a la API a
/accounty envía un mensaje de prueba con una llamada a/messages.
Antes de empezar
Necesitas lo siguiente:
- Una cuenta de Facebook Business Manager.
- Una línea de crédito para tu cuenta empresarial de WhatsApp. También puedes consultar Información sobre la facturación de la API local para obtener más información sobre el proceso de facturación.
- Una herramienta de línea de comandos (p. ej., Terminal) o una aplicación como Postman que pueda realizar solicitudes cURL.
Una vez que verifiques tu negocio, este se revisa para comprobar si cumple con las Condiciones del servicio de WhatsApp y la Política de comercio de WhatsApp. Este paso se inicia automáticamente. Puedes comprobar el estado de la verificación y la revisión del negocio en la pestaña Configuración de la cuenta de WhatsApp Business en Business Manager. La verificación del negocio se mostrará como Verificada y el estado de la cuenta aparecerá como Aprobado una vez que se hayan realizado las aprobaciones.
Configurar la cuenta de WhatsApp
Añade un número de teléfono y su nombre para mostrar a la cuenta de WhatsApp Business. Se enviará el nombre para mostrar a revisión.
Puedes cambiar el nombre para mostrar tantas veces como quieras hasta que completes el registro; después, deberás esperar 30 días entre solicitudes de cambios de nombre para mostrar.
Cuando se completen todas las revisiones, podrás ver el certificado codificado mediante Base64 y acceder a este, ya que lo necesitarás para el registro del cliente de la API local. Te recomendamos que, en el registro, uses un nombre para mostrar aprobado para iniciar la integración, antes de realizar más cambios en un nombre para mostrar. Puedes cambiar el nombre para mostrar en cualquier momento después de completar la integración.
Revisar la información de facturación y precios
Cuando tu empresa comience a enviar mensajes con la API local, es importante que comprendas el proceso de facturación (por ejemplo, cómo y cuándo se te cobra, y cómo ver y pagar tu factura mensual). Para obtener más información, consulta Información sobre la facturación de tu cuenta de WhatsApp Business. Para ver las reglas de precios y el coste por mensaje, consulta nuestra página Precios.
Versiones de software recomendadas
| Software | Versión | Detalles |
|---|---|---|
API local | ||
API local para AWS | Consulta el registro de cambios Versión de la plantilla: | |
MySQL |
| Ten en cuenta que la base de datos migrada a MySQL 8 no se puede cambiar a MySQL 5. Por lo tanto, haz una copia de seguridad de la base de datos antes de la migración. |
PostgreSQL |
| Se admiten |
Docker | La versión | Se requiere la versión Asegúrate de que la llamada del sistema statx esté incluida en la lista de llamadas del sistema permitidas para Docker. |
Postman | Cualquier versión reciente | |
libseccomp |
| Solo se admite la versión |
glibc |
| Solo se admite la versión |
Sistema operativo (SO) | Versión más reciente | Utiliza al menos la versión de kernel mínima |
Paso 1: Instalar el cliente de la API local
Entorno
En esencia, el cliente de la API local se basa en Docker. Consulta Arquitectura del cliente para obtener más información sobre cada componente.
Actualmente, el cliente de la API local no es compatible con Docker para Windows o el subsistema de Windows para Linux. Para cubrir las necesidades de desarrollo, la solución recomendada consiste en utilizar una máquina virtual Linux y ejecutar Docker en ella. Para las cargas de trabajo de producción, se recomienda utilizar un servidor Linux a fin de evitar problemas de compatibilidad y rendimiento.
Equipo
El cliente de la API local se ejecutará en cualquier máquina conectada a internet que pueda ejecutar Docker para Linux, ya sea en una máquina virtual o en un servidor Linux. Para obtener más información, consulta las preguntas frecuentes. Por ejemplo, las pruebas simples se pueden realizar en un portátil. Para un servidor de entorno de producción, se recomienda, como mínimo, SSD de 250 GB, 16 GB de RAM y CPU de 4 núcleos. No se recomienda usar HDD porque, con carga, las velocidades de E/S se convertirán en cuellos de botella.
En la mayoría de los casos, tendrás que ejecutar la base de datos en un servidor físico aparte desde los contenedores de aplicación principal y aplicación web. El servidor de base de datos debe presentar solo unos milisegundos de latencia respecto a los equipos informáticos.
Instalación
Existen dos maneras de empezar a usar la API local:
- Instalación local: puedes configurar los contenedores de Docker por tu cuenta mediante la guía de instalación. Te recomendamos empezar por una de las configuraciones de desarrollador para familiarizarte con el proceso de configuración y el envío de mensajes. Esta solución local se puede utilizar en el ordenador antes de la migración a un entorno de producción.
- Amazon Web Services (AWS): si utilizas AWS o quieres obtener una solución más independiente, consulta la guía de AWS. La solución AWS configura una solución de API local completa con copias de seguridad, recuperación, etc., en una nube de AWS de la que eres propietario y administrador.
Una vez que el cliente de la API local se encuentra en ejecución, debes iniciar sesión como admin para realizar el resto de pasos de configuración.
Actualizar la configuración
Puedes realizar cambios en la configuración de la aplicación cuando el cliente de la API local esté en funcionamiento. Sin embargo, no tendrás acceso a las diferentes opciones de configuración del perfil de tu cliente de la API local hasta que se complete el registro.
- Con la configuración de la aplicación se define el funcionamiento del cliente: la configuración de devolución de llamada, el buscapersonas, Webhooks, el estado enviado, el comportamiento de la descarga de contenido multimedia, etc. Nota: Te recomendamos encarecidamente que configures una URL de webhook para poder recibir notificaciones sobre errores o mensajes entrantes.
- En la configuración del perfil empresarial y la configuración del perfil se define la información de la empresa, como la dirección, el correo electrónico, el sitio web, el sector, datos sobre esta y la foto del perfil.
Paso 2: Empezar a usar el cliente
Registro
Una vez que el cliente de la API local esté en funcionamiento, puedes registrar el número de teléfono. Para ello, envía una llamada a la API al extremo account.
Enviar un mensaje de prueba
Puedes enviar mensajes de prueba con el extremo messages. Primero, comprueba el estado del número de teléfono que utilizas para las pruebas. Deberás enviar un mensaje a la cuenta de WhatsApp desde el número de teléfono de prueba a fin de activar el periodo de atención al cliente. De este modo, podrás enviar cualquier tipo de mensaje durante un plazo de 24 horas (consulta Control de desconexión para obtener detalles). A continuación, envía un mensaje de texto a tu número de teléfono de prueba. Si recibes el mensaje, significa que la instalación se ha realizado correctamente. Si no lo recibes, comprueba tu webhook para ver si hay notificaciones que puedan indicar que existen problemas.
Seguridad
Consulta nuestra guía sobre seguridad para obtener información sobre las contraseñas, la autenticación, la configuración de SSL, la segregación de la red, las comunicaciones cifradas, los encabezados HTTP y el protocolo TLS del servidor web en relación con el cliente de la API local.
Proceso de inicio
La API local de WhatsApp se somete a un procedimiento de inicio al establecer una conexión con el servidor. Este proceso es fundamental para garantizar un método fluido y fiable de enviar y recibir mensajes. Durante esta fase de inicio, la aplicación principal espera que se reúnan varios requisitos previos, tales como los siguientes:
Carga de los mensajes de plantilla: la API carga los mensajes de plantilla desde el servidor como parte de este proceso de inicialización.
Recepción y procesamiento de los mensajes fuera de internet: también gestiona la recepción y el procesamiento de los mensajes fuera de internet.
Si se intentan enviar mensajes mientras no se reúnen estos requisitos previos, la aplicación principal responderá con un mensaje de error que indicará que la aplicación principal no está lista y en los registros se mostrará un error que indicará que el servicio no está listo. Es importante tener en cuenta que este proceso de inicio se ejecuta cada vez que se establece una nueva conexión con el servidor de WhatsApp. Por consiguiente, si la aplicación principal se reinicia o se desconecta, el proceso de inicio volverá a comenzar para establecer el estado de la aplicación principal en “lista”. De esta forma, se garantiza que la API local de WhatsApp sea fiable y esté lista para la comunicación mediante mensajes.
Procesamiento de los mensajes fuera de internet
Cuando no se encuentra ningún mensaje fuera de internet, el paso de procesamiento de los mensajes fuera de internet se omite. Dicho de otra forma, si no hay mensajes esperando en un estado fuera de internet, esta fase concreta de la gestión de mensajes se salta.
En condiciones habituales, la API local de WhatsApp sigue un protocolo estándar de gestión de los mensajes fuera de internet. Espera la recepción y el procesamiento de todos los mensajes fuera de internet, con un tiempo de espera máximo definido previamente de seis minutos. Una vez transcurridos estos seis minutos, se considera que la fase de procesamiento de los mensajes fuera de internet se ha completado correctamente.
Sugerencias adicionales
SÍPara empezar, envía y recibe mensajes con empleados internos primero a fin de comprobar que el sistema funciona. Responde a todos los clientes en un plazo de 24 horas. Cumple nuestras políticas, que se describen en la Política de WhatsApp Business y la Política de comercio de WhatsApp. Utiliza varios números de teléfono para el desarrollo, las pruebas y la producción. Comprueba las preguntas frecuentes antes de abrir una solicitud de asistencia directa. Proporciona comentarios sobre el producto. La asistencia directa es el mejor canal para hacerlo. | NOEnvíes notificaciones duplicadas a varios canales. Envíes spam. Uses números 1-800 para pruebas. Crees una instancia de Business Manager solo para integraciones de WhatsApp. Usa una existente, si está disponible. |
Si detectamos que has infringido alguna de nuestras normas o políticas, nos reservamos el derecho a limitar o eliminar tu acceso a WhatsApp.