Usare conferme di lettura, indicatori di digitazione e reazioni
Rendi gli scambi di servizio reattivi preservando la semantica di messaggi e reazioni.
Prerequisiti
Un messaggio ricevuto, il permesso di operare come mittente e un'interazione di servizio supportata.
1. Decidi cosa significa il segnale
Segna un messaggio in arrivo come letto quando il tuo team ha preso in carico la conversazione nel proprio flusso di lavoro. WhatsApp segna come letti anche i messaggi precedenti in quella conversazione, quindi questa azione conferma più del solo messaggio di riferimento. Usa l'indicatore di digitazione mentre prepari una risposta, non come indicatore permanente.
2. Usa l'operazione pubblicata
Usa Segna un messaggio come letto, POST /v1/whatsapp/messages/{message_id}/read, per un messaggio ricevuto. WhatsApp segna quel messaggio e ogni messaggio precedente nella conversazione come letto. Imposta typing_indicator quando stai preparando una risposta. Un 202 conferma che la conferma di lettura è stata accettata per l'elaborazione; non dimostra che il cliente abbia visto l'indicatore. Non esiste un webhook di consegna della conferma né un messaggio separato da interrogare.
Dopo che Meta accetta la conferma, il messaggio ricevuto può mostrare read_at mantenendo il proprio stato received. La conferma non genera alcun messaggio in uscita fatturabile. Segui l'operazione pubblicata per le conferme di lettura per conoscere la scadenza dell'indicatore di digitazione e l'età consentita del messaggio.
3. Gestisci le modifiche alle reazioni
Iscriviti a whatsapp.reacted per le modifiche alle reazioni in arrivo. Una reazione annota un messaggio di riferimento; non è un altro messaggio di testo whatsapp.received. Un emoji null può rappresentare la rimozione. Preserva l'emoji esatta anziché normalizzare valori distinti.
4. Mantieni separati lo storico e lo stato corrente
Usa il log delle reazioni per le modifiche e le reazioni del messaggio per lo stato corrente per mittente. Un riferimento più vecchio e non risolto dal provider può non avere una reazione corrispondente, quindi l'assenza di una voce non dimostra che il cliente non abbia mai reagito.
5. Testa la fine dell'interazione
Prova reazioni aggiunte, sostituite e rimosse, elaborazione ritardata e una risposta interrotta. Assicurati che la risposta effettiva o il passaggio a un operatore umano segua il segnale.
Risoluzione dei problemi
Se una reazione non compare nella lista dei messaggi, controlla l'evento di reazione e il log dei messaggi di riferimento. Se l'indicatore di digitazione persiste nello stato della tua applicazione, verifica la sua scadenza separatamente dallo stato di lettura. Consulta eventi WhatsApp per la struttura pubblicata del webhook.
Passaggi successivi
- Esplora la funzionalità WhatsApp correlata.
- Trova tutte le guide e le risposte spiegate su WhatsApp.
- Prepara il tuo primo scambio completo.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaConnecting WhatsApp to Bird: from buying a number to a live channelComprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builderEsplora la funzionalitàWhatsApp
Prova l'esercitazione e ottieni un brief di implementazione