WhatsApp

Sherlock se conecta directo a la Cloud API de WhatsApp de Meta, sin intermediarios. La persona le escribe al número de la empresa y el agente responde con el mismo conocimiento y las mismas protecciones que en la web.

En Meta for Developers necesitás una app de tipo Business con el producto WhatsApp y:

• El Phone number ID del número (WhatsApp → API Setup).
• Un token de acceso permanente, de un usuario del sistema del Business Manager. El token temporal de la página de pruebas vence en 24 horas: no lo uses en producción.
• El App secret de la app (Configuración de la app → Básica), para verificar la firma de los mensajes que manda Meta.

1. En el Estudio del agente, vista Canales, hacé clic en «Conectar canal» → «WhatsApp».

2. Completá:

   Campo	Notas
   Nombre y Ambiente	Normalmente «Producción».
   Phone number ID	Meta for Developers → WhatsApp → API Setup.
   Número visible (opcional)	Para reconocerlo: +54 9 11 ….
   Access token (permanente)	Se guarda cifrado.
   App secret	Para verificar la firma de los webhooks. Se guarda cifrado.

3. Hacé clic en «Crear canal». La tarjeta del canal muestra la «URL del webhook (Callback URL)» y el «Token de verificación (Verify token)», con botones para copiarlos.

1. En Meta for Developers → tu app → WhatsApp → Configuración, pegá la URL del webhook y el token de verificación y hacé clic en Verificar y guardar.
2. En los campos del webhook, suscribí messages.
3. Mandale un mensaje al número desde un teléfono: el agente tiene que responder y la conversación aparece en Conversaciones con el canal «WhatsApp».

La URL del webhook tiene esta forma:

https://app.sherlock.posselab.net/channels/whatsapp/wa_xxxxxxxxxxxxxxxxxxxxxxxx

• Sherlock verifica la firma de cada mensaje que manda Meta con el App secret y descarta los que no coinciden.
• Marca el mensaje como leído y muestra «escribiendo…» mientras el agente responde.
• Entiende mensajes de texto y las respuestas a botones y listas. A un audio, una imagen, un documento o una ubicación responde «Por ahora solo puedo leer mensajes de texto. ¿Me escribís tu consulta?».
• Las respuestas son cortas, con negrita permitida y sin tablas. Si el agente citó fuentes, se agregan al final («Fuentes: [1] Condiciones generales (pág. 12)»).
• Las respuestas de más de 4.000 caracteres se envían en varios mensajes.
• Los mensajes de la misma persona dentro de 24 horas siguen la misma conversación; después de 24 horas sin mensajes, o si la conversación se cerró, empieza una nueva.

Cuando la persona pide hablar con alguien, la conversación se deriva: aparece en la Bandeja y el agente deja de responder. El operador contesta desde Conversaciones, en el detalle de la conversación («Se envía por WhatsApp al +54 9 11 …»), y el mensaje le llega a la persona por WhatsApp como un mensaje normal.