Integración con WordPress

Business Messaging for WbizTool es el plugin oficial para WordPress. Envía mensajes de WhatsApp desde tu número conectado cuando ocurre algo en tu sitio: cambia un pedido de WooCommerce, se reprograma o cancela una reserva de WP Amelia, o se envía un formulario de Contact Form 7.

Antes de empezar#

• Una cuenta de Wbiztool con un número de WhatsApp conectado en la configuración de WhatsApp.
• Tu Client ID y tu API key de Configuración → Claves API.
• El WhatsApp Client ID del número desde el que se envía, que aparece en la configuración de WhatsApp.

Instalar el plugin#

1. Instálalo desde WordPress

   En el administrador de WordPress, ve a Plugins → Añadir nuevo plugin, busca Business Messaging for WbizTool, haz clic en Instalar ahora y luego en Activar. También puedes descargarlo del directorio de plugins de WordPress y subir el zip en Plugins → Añadir nuevo plugin → Subir plugin. Si la subida falla (por ejemplo, por un límite de tamaño de archivo), descomprime el zip y copia la carpeta business-messaging-for-wbiztool en /wp-content/plugins/ por FTP; luego actívalo en Plugins.

2. Abre la configuración del plugin

   Aparece un nuevo menú WbizTool en la barra lateral del administrador con cuatro páginas: Settings (configuración), Templates (plantillas), Test Messages (mensajes de prueba) y Logs (registros).

Configurar el plugin#

1. Ingresa tus credenciales de la API

   En WbizTool → Settings, en API Configuration (configuración de la API), completa Client ID, API Key y WhatsApp Client ID, y haz clic en Test Connection (probar conexión).

   Con credenciales correctas, Test Connection pone en cola un mensaje de prueba real al número ficticio 10000000000, así que aparece en tu historial de mensajes de Wbiztool. No se puede entregar y aparece ahí como fallido; puedes ignorarlo. Si ves Unable to connect to WbizTool API. Please check your internet connection. (no se puede conectar con la API de WbizTool; revisa tu conexión a internet), lo más probable es que tu Client ID, tu API key o tu WhatsApp Client ID sean incorrectos, o que tu plan no tenga mensajes disponibles. Rara vez indica un problema con tu conexión a internet.

2. Configura las opciones generales

   En General Settings (configuración general):

   • Default Country Code (código de país predeterminado): se usa cuando el país de facturación de un pedido de WooCommerce no se puede asociar a un código de llamada. El valor predeterminado es 1, así que cámbialo por el de tu país principal, por ejemplo 91.
   • Test Mode (modo de prueba): cuando está activado, los mensajes se escriben en el registro, pero no se envían.
   • Admin Notifications (notificaciones al administrador): esta casilla no tiene ningún efecto visible en la versión 1.0.3, porque la página de configuración no tiene ningún campo para el número de teléfono del administrador que usa. Para recibir alertas de administrador por envíos de formularios, usa la configuración de Contact Form 7 que se describe más abajo.

3. Activa las integraciones y los eventos

   En Integration Settings (configuración de integraciones), habilita cada plugin que uses y marca los eventos que deben enviar un mensaje. Una integración solo muestra sus opciones cuando ese plugin está activo en tu sitio. Haz clic en Save Settings (guardar configuración).

4. Edita las plantillas de mensaje

   En WbizTool → Templates, elige la pestaña WooCommerce, Amelia o Contact Form 7, elige un evento y edita su texto. La página muestra las variables que puedes usar y una vista previa en vivo. Reset (restablecer) recupera el texto predeterminado.

5. Envía una prueba

   En WbizTool → Test Messages, envía un mensaje a tu propio número para confirmar que todo funciona y luego revisa WbizTool → Logs.

WooCommerce#

Los mensajes se envían al teléfono de facturación del pedido. El código de país se toma del país de facturación; si ese país no se reconoce, se usa el Default Country Code.

Variables de plantilla:

Plantilla de ejemplo:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Los mensajes se envían al teléfono del cliente de la reserva. La página de configuración muestra seis eventos:

• Booking Added (Frontend bookings) (reserva agregada, reservas desde el frontend)
• Booking Rescheduled (reserva reprogramada)
• Booking Cancelled (reserva cancelada)
• Appointment Added (Backend) (cita agregada, desde el backend)
• Event Booking Saved (reserva de evento guardada)
• Event Booking Updated (reserva de evento actualizada)

Variables disponibles en las plantillas de Amelia:

Contact Form 7#

Cuando se envía un formulario, el plugin puede enviarte un mensaje a ti (el administrador), a la persona que completó el formulario o a ambos.

El plugin encuentra el nombre, el email, el teléfono y el mensaje de tu formulario por el nombre del campo. Usa nombres habituales como your-name, your-email, your-phone (o phone, mobile, whatsapp), your-subject y your-message. La respuesta automática al cliente solo se envía cuando se encuentra un campo de teléfono. Pide el número con su código de país: el plugin solo reconoce algunos códigos de país y, en los demás casos, usa el Default Country Code.

Variables de plantilla:

Cada campo del formulario también está disponible con su propio nombre, con los guiones reemplazados por guiones bajos. Por ejemplo, un campo llamado your-city es {your_city}.

Ejemplo de notificación para el administrador:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Los saltos de línea del mensaje del visitante se eliminan, así que {message} llega en una sola línea.

Registros#

WbizTool → Logs muestra los mensajes que el plugin intentó enviar, con la fecha, el tipo de evento, la integración, el teléfono, el mensaje y el estado. Úsalo para comprobar si se activó un evento y si el mensaje se envió. No muestra por qué falló un mensaje.

Solución de problemas#

Para ver los errores de PHP del plugin, activa el registro de depuración de WordPress en wp-config.php. Los errores se escriben en wp-content/debug.log. Vuelve a desactivarlo cuando termines.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);