Απαντήστε σε μηνύματα WhatsApp με μια εφαρμογή Dify

Μπορεί η Meta να στέλνει μηνύματα WhatsApp απευθείας στο Dify;

Όχι με τρόπο που ολοκληρώνει τη χειραψία. Πριν παραδώσει οτιδήποτε, η Meta καλεί τον προορισμό με GET και περιμένει να λάβει πίσω την τιμή hub.challenge ως ακατέργαστο σώμα απόκρισης. Το Webhook Trigger του Dify δέχεται μία μέθοδο HTTP ανά trigger και η τεκμηρίωσή του αναφέρει ότι ένα σώμα απόκρισης που δεν είναι JSON μετατρέπεται αυτόματα σε JSON, οπότε το OK επιστρέφει ως αντικείμενο μηνύματος. Το challenge δεν μπορεί ποτέ να επιστραφεί αυτούσιο και η Meta δεν αρχίζει ποτέ να παραδίδει.

Επομένως χρειάζεται κάτι μικρό μπροστά από το Dify. Ένας κόμβος Webhook του n8n, μια διαδρομή σε Python ή Node ή μια serverless συνάρτηση απαντά στο GET, δέχεται το POST και παραδίδει το κείμενο στο Dify. Ο δέκτης αυτός είναι και το σημείο όπου ελέγχεται το μακρύ τυχαίο μυστικό μέσα στο URL του webhook, αφού η κεφαλίδα X-Hub-Signature-256 υπογράφεται με το app secret του Tech Provider και δεν μπορεί να επικυρωθεί από τον πελάτη.

Πώς μιλά ο δέκτης με την εφαρμογή Dify;

Με μία κλήση στο Service API του Dify: POST /chat-messages, με πιστοποίηση μέσω του API key της εφαρμογής. Το σώμα περιέχει το query, δηλαδή το κείμενο του πελάτη, και το user, έναν αναγνωριστικό κωδικό που ορίζετε εσείς. Χρησιμοποιήστε τον αριθμό WhatsApp του αποστολέα ως user και κρατήστε το conversation_id που επιστρέφει το Dify, ώστε το επόμενο μήνυμα του ίδιου ατόμου να συνεχίζει την ίδια συνομιλία.

Το response_mode έχει σημασία. Το `blocking` επιστρέφει όταν ολοκληρωθεί η απάντηση και η τεκμηρίωση του Dify προειδοποιεί ότι στο Dify Cloud μια μεγάλη παραγωγή μπορεί να διακοπεί από τον edge proxy. Οι εφαρμογές Agent υποστηρίζουν μόνο `streaming`, και ένα αίτημα `blocking` προς αυτές αποτυγχάνει με 400. Ένας δέκτης που διαβάζει τη ροή και στέλνει ένα μόνο μήνυμα WhatsApp στο τέλος είναι η στιβαρή λύση.

Η απάντηση φεύγει έπειτα ως μήνυμα κειμένου του Cloud API προς τον ίδιο αριθμό, χωρίς χρέωση μέσα στο παράθυρο των 24 ωρών που άνοιξε το μήνυμα του πελάτη.

Τι προσθέτει ο MCP server μέσα στο Dify;

Τη δυνατότητα ενός agent του Dify να ενεργεί στον αριθμό χωρίς να συνδέετε εσείς κάθε κλήση. Το Dify συνδέεται με MCP servers μέσω HTTP και, από προεπιλογή, εγγράφεται στον server μέσω OAuth dynamic client registration, κάτι που υποστηρίζει ο MCP server του EasyCoexistence. Προσθέστε τον στα Tools, συνδεθείτε μία φορά και ο agent αποκτά τα εργαλεία: λίστα αριθμών, έλεγχο της υγείας ενός αριθμού, αποστολή μηνύματος, αποστολή εγκεκριμένου template, ανάγνωση της κατάστασης των template.

Εκεί ανήκει η προληπτική δουλειά: ένα workflow του Dify που κάνει επαναληπτική επικοινωνία την επόμενη μέρα πρέπει να χρησιμοποιεί το send_template, επειδή το ελεύθερο κείμενο εκτός παραθύρου επιστρέφει το σφάλμα 131047, και οι περιγραφές των εργαλείων το λένε αυτό στο μοντέλο.

Αυτό που δεν μπορεί να κάνει το MCP είναι να ξυπνήσει το Dify όταν γράφει ένας πελάτης. Το πρωτόκολλο λειτουργεί με αίτημα και απόκριση, οπότε τα εισερχόμενα μηνύματα φτάνουν ακόμη μέσω του webhook και του δέκτη που βρίσκεται μπροστά.

Συνηθισμένα λάθη

• Χρήση του URL ενός Dify Webhook Trigger ως προορισμού του webhook. Το challenge επιστρέφει τυλιγμένο σε JSON και η Meta δεν επαληθεύει ποτέ το endpoint.
• Αποστολή αιτήματος `blocking` σε εφαρμογή Dify Agent. Οι εφαρμογές Agent υποστηρίζουν μόνο `streaming` και η κλήση αποτυγχάνει με 400.
• Χρήση νέας τιμής user για κάθε μήνυμα. Το Dify δεσμεύει τις συνομιλίες στο user, οπότε κάθε μήνυμα ξεκινά νέα συνομιλία χωρίς μνήμη.

Συχνές ερωτήσεις

Συνεχίστε την ανάγνωση