Collegare un sistema esterno o un assistente

Cosa fare

1. Per i messaggi ricevuti, apri Impostazioni e trova URL webhook (per il server WhatsApp).
2. Scegli Copia per ottenere l’indirizzo esatto dell’installazione usata dal tuo account.
3. Chiedi al responsabile di configurare gli eventi in arrivo per il dispositivo desiderato usando quell’indirizzo.
4. Organizza un messaggio di prova in arrivo dal tuo numero quando il responsabile conferma che tutto è pronto.
5. Controlla il risultato atteso, per esempio una risposta automatica corrispondente o un nuovo messaggio di gruppo registrato quando Registro è attivo.
6. Per collegare un assistente, accedi tramite la schermata di autorizzazione aperta dal tuo client MCP.
7. Controlla l’applicazione e l’account indicati prima di approvare l’accesso.
8. Per integrare gli invii, apri Impostazioni → Integrazioni esterne. Crea una chiave con un nome per un account connesso e gruppi selezionati esplicitamente. Salva subito la chiave; viene mostrata una sola volta. Copia l’URL di base dell’API.
9. Esempio: Configura Abacus.AI per generare nuovi contenuti in ciascuno degli otto orari giornalieri di pubblicazione in America/Sao_Paulo. Invia ogni pubblicazione a tre gruppi consentiti con un nuovo Idempotency-Key. Riutilizza la chiave solo per ripetere una richiesta identica.
10. Ometti scheduled_at per inserire subito la richiesta in coda, oppure usa una data e ora assolute con -03:00 o Z (UTC), fino a 30 giorni nel futuro. Il processo controlla la coda ogni minuto; scheduled_at è il primo momento consentito, senza garanzia di consegna al secondo esatto.
11. Controlla lo stato della pubblicazione e gli esiti per gruppo prima di riprovare. Annulla solo gli invii non ancora avviati. Revoca una chiave compromessa in Impostazioni, poi crea e salva una chiave sostitutiva; le vecchie pubblicazioni non riprendono con una nuova chiave.

Cosa sapere

• Gli assistenti possono leggere i dati esposti e inviare testo quando richiesto. Leggi la guida agli strumenti dell’assistente prima di richiedere un invio.
• Usa il pannello per le modifiche non disponibili tramite MCP.
• L’accesso all’API è incluso nei piani Pro e Agency mensili o annuali. Starter richiede un cambio di piano. Le chiavi consentono solo l’account e i gruppi selezionati; sostituire l’account WhatsApp blocca gli invii. Non condividere mai le credenziali del server.
• I testi supportano 4.096 caratteri; le didascalie, 1.024. Carica file JPEG, PNG o WebP fino a 5 MiB nei campi multipart payload e image. Gli URL di immagini remote non sono accettati.
• Una nuova pubblicazione restituisce HTTP 202. Una richiesta identica ripetuta con lo stesso Idempotency-Key restituisce la pubblicazione originale con HTTP 200; un contenuto diverso con la stessa chiave restituisce 409. Un timeout dopo l’avvio dell’invio può lasciare l’esito non confermato; non reinviare automaticamente con un’altra chiave.

Problemi comuni