Cómo integrar WhatsApp con Dialogflow

Introducción

La integración de WhatsApp con Dialogflow es una de las formas más efectivas de crear chatbots inteligentes para tu negocio. Esta combinación te permite automatizar la atención al cliente, responder preguntas frecuentes y mejorar la experiencia del usuario las 24 horas del día.

¿Qué es Dialogflow?

Dialogflow es una plataforma de Google Cloud que utiliza procesamiento de lenguaje natural (NLP) para entender las intenciones de los usuarios y generar respuestas contextuales. Es especialmente útil para crear conversaciones naturales con chatbots.

Requisitos previos

• Cuenta de Google Cloud Platform (puedes usar el nivel gratuito)
• Cuenta de WhatsApp Business API o acceso a Twilio
• Conocimientos básicos de programación (Python o Node.js)
• Servidor con acceso a internet para alojar el webhook

Paso 1: Configurar Dialogflow

1.1 Crear un agente

1. Accede a la consola de Dialogflow
2. Crea un nuevo proyecto o selecciona uno existente
3. Haz clic en "Create Agent"
4. Completa la información básica del agente

1.2 Configurar intenciones

Las intenciones representan lo que el usuario quiere hacer. Por ejemplo:

• saludo: Cuando el usuario dice "Hola" o "Buenos días"
• consultar_horarios: Cuando pregunta por los horarios de atención
• solicitar_informacion: Cuando pide información sobre productos o servicios

1.3 Configurar entidades

Las entidades extraen información específica de los mensajes, como fechas, números, nombres, etc.

Paso 2: Configurar WhatsApp Business API

Opción A: Usar Twilio

Twilio es la forma más sencilla de comenzar:

1. Regístrate en Twilio
2. Verifica tu número de teléfono
3. Obtén tu Account SID y Auth Token
4. Configura un número de WhatsApp en el panel de Twilio

Opción B: WhatsApp Business API oficial

Para usar la API oficial de Meta necesitas:

• Aprobar tu negocio con Meta
• Configurar un servidor de negocio
• Obtener las credenciales de acceso

Paso 3: Crear el webhook

El webhook es el puente entre WhatsApp y Dialogflow. Aquí tienes un ejemplo completo en Python usando Flask:

from flask import Flask, request
from google.cloud import dialogflow_v2 as dialogflow
from twilio.rest import Client
import os

app = Flask(__name__)

# Configuración de Twilio
twilio_client = Client(
    os.environ.get("TWILIO_ACCOUNT_SID"),
    os.environ.get("TWILIO_AUTH_TOKEN")
)

# Configuración de Dialogflow
DIALOGFLOW_PROJECT_ID = os.environ.get("DIALOGFLOW_PROJECT_ID")
DIALOGFLOW_LANGUAGE_CODE = "es"

@app.route("/webhook", methods=["POST"])
def webhook():
    """Endpoint que recibe mensajes de WhatsApp"""
    # Obtener datos del mensaje
    message_body = request.form.get("Body")
    from_number = request.form.get("From")
    
    # Procesar con Dialogflow
    response_text = detect_intent_texts(
        DIALOGFLOW_PROJECT_ID,
        from_number,
        message_body,
        DIALOGFLOW_LANGUAGE_CODE
    )
    
    # Enviar respuesta a WhatsApp
    twilio_client.messages.create(
        body=response_text,
        from_=f"whatsapp:{os.environ.get("TWILIO_WHATSAPP_NUMBER")}",
        to=from_number
    )
    
    return "OK", 200

def detect_intent_texts(project_id, session_id, text, language_code):
    """Detecta la intención del usuario usando Dialogflow"""
    session_client = dialogflow.SessionsClient()
    session = session_client.session_path(project_id, session_id)
    
    text_input = dialogflow.TextInput(
        text=text, language_code=language_code
    )
    query_input = dialogflow.QueryInput(text=text_input)
    
    response = session_client.detect_intent(
        request={"session": session, "query_input": query_input}
    )
    
    return response.query_result.fulfillment_text

if __name__ == "__main__":
    app.run(debug=True, port=5000)

Paso 4: Desplegar el webhook

Puedes desplegar tu webhook en:

Paso 5: Configurar el webhook en Twilio

Mejores prácticas

Conclusión

La integración de WhatsApp con Dialogflow te permite crear chatbots inteligentes que pueden transformar la forma en que interactúas con tus clientes. Con esta guía, deberías tener todo lo necesario para comenzar a construir tu propio chatbot.

¿Necesitas ayuda con la implementación? Contáctanos y te ayudaremos a configurar tu chatbot personalizado.

• Heroku: Fácil y rápido para comenzar
• Google Cloud Run: Integración perfecta con Dialogflow
• AWS Lambda: Escalable y económico
• Tu propio servidor: Máximo control
  1. Ve al panel de Twilio
  2. Configura el webhook URL en la configuración de WhatsApp
  3. Prueba enviando un mensaje a tu número de WhatsApp
  • Manejo de errores: Siempre maneja los errores y proporciona respuestas por defecto
  • Contexto de conversación: Usa el contexto de Dialogflow para mantener conversaciones coherentes
  • Validación: Valida los datos antes de procesarlos
  • Logging: Registra todas las interacciones para análisis posterior