Risoluzione dei problemi e domande frequenti

Messaggio accettato ma non consegnato

Una risposta 200 dall’endpoint dei messaggi in uscita significa che ElevenLabs ha accettato e inoltrato la richiesta: la consegna dipende comunque da Meta. Se il messaggio non arriva, verifica nell’ordine:

1. Approvazione del template — il template deve avere lo stato Approved in WhatsApp Manager. I template in attesa o rifiutati non vengono consegnati.
2. Pagamenti — l’assenza di un metodo di pagamento o pagamenti non saldati sul tuo account WhatsApp Business bloccano la consegna dei template (errore Meta 131042). Aggiungi o aggiorna il metodo di pagamento in WhatsApp Manager.
3. Struttura dei parametri — le voci di template_params devono essere oggetti componente ({"type": "body", "parameters": [...]}), ogni placeholder nel template deve essere compilato e i template con nome richiedono un parameter_name per ogni valore. Consulta i parametri del template.
4. Formato del destinatario — whatsapp_user_id contiene solo cifre con il prefisso internazionale, senza +. Consulta il formato del numero del destinatario.
5. Limiti di marketing — Meta limita il numero di template di marketing che un utente può ricevere in un determinato periodo (errore 131049). I template di utilità non sono soggetti a questo limite.

Problemi di importazione

• Il numero non può essere importato — è registrato presso un altro provider WhatsApp o è attivo nell’app WhatsApp Business. Un numero può essere registrato con un solo provider; consulta le Limitazioni.
• Il tuo WABA non appare nel flusso di importazione — verifica di aver effettuato l’accesso a un account Facebook con autorizzazioni di amministratore sul portfolio aziendale proprietario del WABA, quindi riprova l’importazione.
• I WABA creati con un’app per sviluppatori Meta non possono essere importati tramite il flusso standard.

Verifica se un altro partner gestisce il numero

Un numero che risulta non idoneo, manca dal flusso di importazione o genera un errore durante l’importazione spesso è ancora registrato presso un provider precedente. Un partner che controlla il numero spiega sia un’importazione non riuscita sia un WABA mancante.

1. Vai a business.facebook.com e seleziona il portfolio aziendale.
2. Apri Impostazioni aziendali > Account WhatsApp.
3. Controlla Numeri di telefono in ciascun account WhatsApp finché non trovi quello che contiene il tuo numero.
4. Apri Partner.
5. Disconnetti il numero da quel partner (o rimuovi l’intero portfolio aziendale), quindi riprova l’importazione alcuni minuti dopo.

L’agente non risponde ai messaggi in entrata

La conferma di lettura e l’indicatore di digitazione aiutano a restringere la causa: vengono inviati nel momento in cui un messaggio viene accettato per l’elaborazione, prima che l’agente produca una risposta. Con Abilita indicatore di digitazione attivo (impostazione predefinita), invia un messaggio di prova e verifica se il messaggio viene contrassegnato come letto e se appare l’indicatore di digitazione.

L’indicatore di digitazione appare, ma non arriva alcuna risposta. Il messaggio ha raggiunto ElevenLabs e l’agente ha iniziato a lavorare; il problema si verifica durante la generazione o la consegna della risposta:

• L’agente richiede una variabile dinamica che non ha valore. Le conversazioni WhatsApp in entrata iniziano senza variabili dinamiche fornite dall’utente: vengono compilate solo le variabili di sistema. La soluzione è un webhook di avvio della conversazione che restituisca tutte le variabili richieste dall’agente; consulta il contesto di inizializzazione. I valori inseriti in Variabili dinamiche nell’editor dell’agente sono placeholder di test e non vengono usati in produzione.
• Meta ha rifiutato la risposta dell’agente, ad esempio per un limite di frequenza per questa coppia azienda-utente o per un problema di pagamento a livello di account. Consulta il riferimento degli errori qui sotto.

La conversazione non riesce se queste variabili dinamiche richieste non sono presenti.

Non appare alcun indicatore di digitazione. Il messaggio è stato scartato prima di raggiungere l’agente:

• Nessun agente è assegnato al numero oppure l’interruttore Abilita messaggistica è disattivato: controlla le impostazioni dell’account nella pagina WhatsApp.
• L’autorizzazione dell’account non è più valida: il token di accesso è scaduto o è stato revocato da Meta. Reimporta l’account nella pagina WhatsApp.
• Il workspace dell’agente è in Modalità a conservazione zero, che ignora completamente i messaggi WhatsApp in entrata.
• Il messaggio in entrata è di un tipo non supportato, ad esempio un video o una risposta a un flusso WhatsApp: consulta le Limitazioni.

La prima risposta dopo un template si comporta in modo anomalo

Se il tuo agente ha l’override Primo messaggio attivato nella scheda Sicurezza, può entrare in conflitto con le conversazioni avviate tramite template in uscita: il template è già stato inviato come primo messaggio. Se le risposte ai template si comportano in modo imprevisto, rimuovi l’override del primo messaggio per gli agenti usati con i messaggi WhatsApp in uscita.

Riferimento degli errori Meta

Gli errori restituiti da Meta durante la consegna vengono mostrati, quando possibile, con suggerimenti per la risoluzione. I più comuni:

Per l’elenco completo, consulta il riferimento ai codici di errore di Meta.

FAQ