Rispondi ai messaggi WhatsApp con un'app Dify

Meta può inviare i messaggi WhatsApp direttamente a Dify?

Non in modo da completare l'handshake. Prima di consegnare qualsiasi cosa, Meta chiama la destinazione con una GET e si aspetta il valore hub.challenge come corpo grezzo della risposta. Il Webhook Trigger di Dify accetta un solo metodo HTTP per trigger e la sua documentazione dice che un corpo di risposta non JSON viene convertito automaticamente in JSON, quindi OK torna indietro come oggetto messaggio. La challenge non può mai essere restituita identica e Meta non inizia mai a consegnare.

Quindi serve qualcosa di piccolo davanti. Un nodo Webhook di n8n, una route in Python o Node o una funzione serverless risponde alla GET, accetta la POST e passa il testo a Dify. Il receiver è anche il punto in cui si controlla il lungo segreto casuale nell'URL del webhook, perché l'intestazione X-Hub-Signature-256 è firmata con l'app secret del Tech Provider e il cliente non può validarla.

Come parla il receiver con l'app Dify?

Con una sola chiamata alla Service API di Dify: POST /chat-messages, autenticata con l'API key dell'app. Il corpo contiene query, il testo del cliente, e user, un identificatore che definisci tu. Usa il numero WhatsApp del mittente come user e conserva il conversation_id restituito da Dify, così il messaggio successivo della stessa persona continua la stessa conversazione.

response_mode conta. Con blocking la risposta arriva a generazione completa, e la documentazione di Dify avverte che su Dify Cloud una generazione lunga può essere interrotta dal proxy edge. Le app Agent supportano solo streaming e una richiesta blocking verso di esse fallisce con 400. La forma più robusta è un receiver che legge lo stream e invia un solo messaggio WhatsApp alla fine.

La risposta esce poi come messaggio di testo della Cloud API verso lo stesso numero, ed è gratuita dentro la finestra di 24 ore aperta dal messaggio del cliente.

Cosa aggiunge il server MCP dentro Dify?

La possibilità per un agente Dify di agire sul numero senza che tu colleghi ogni chiamata. Dify si connette ai server MCP via HTTP e, per impostazione predefinita, si registra sul server tramite OAuth dynamic client registration, che è ciò che supporta il server MCP di EasyCoexistence. Aggiungilo in Tools, accedi una volta e l'agente ottiene gli strumenti: elencare i numeri, controllare lo stato di salute di un numero, inviare un messaggio, inviare un template approvato, leggere lo stato dei template.

È la sede giusta per il lavoro proattivo: un workflow Dify che fa follow-up il giorno dopo deve usare send_template, perché il testo libero fuori dalla finestra restituisce l'errore 131047, e le descrizioni degli strumenti lo dicono al modello.

Quello che MCP non può fare è svegliare Dify quando un cliente scrive. Il protocollo è richiesta e risposta, quindi i messaggi in arrivo passano ancora dal webhook e dal receiver davanti.

Errori comuni

• Usare l'URL di un Webhook Trigger di Dify come destinazione del webhook. La challenge torna avvolta in JSON e Meta non verifica mai l'endpoint.
• Inviare una richiesta blocking a un'app Dify Agent. Le app Agent supportano solo streaming e la chiamata fallisce con 400.
• Usare un valore user nuovo a ogni messaggio. Dify lega le conversazioni a user, quindi ogni messaggio apre una conversazione nuova senza memoria.

Domande frequenti

Continua a leggere