Come attivare il gateway e creare una chiave
Aggiornato il
In SyBox, questo si fa in Impostazioni > Integrazioni > API chiavi. 1) Vai su Impostazioni > Integrazioni > API chiavi. 2) Attiva l'opzione "Gateway API". 3) Fai clic su "Nuova chiave". 4) Scegli il "Tipo di chiave": 5) Inserisci il "Device o program name", ad esempio "PC ufficio" o "Software contabilità". Assegna una chiave distinta a ciascun programma o dispositivo. 6) Per una chiave di tipo "Invia tramite WhatsApp", configura anche: 7) Per una chiave di tipo "Importa SMS da un…
- Vai su Impostazioni > Integrazioni > API chiavi.
- Attiva l'opzione "Gateway API".
- Fai clic su "Nuova chiave".
- Scegli il "Tipo di chiave":
- "Invia tramite WhatsApp": il programma invia messaggi ai tuoi clienti.
- "Apri una pratica": il programma crea pratiche in SyBox. Non può inviare messaggi.
- "Importa SMS da un telefono": un telefono inoltra i propri SMS nella posta in arrivo.
- Inserisci il "Device o program name", ad esempio "PC ufficio" o "Software contabilità". Assegna una chiave distinta a ciascun programma o dispositivo.
- Per una chiave di tipo "Invia tramite WhatsApp", configura anche:
- "Sends da": il numero WhatsApp da cui invia la chiave (obbligatorio).
- "Allow free-text messaggi": attivo o disattivo.
- "Allow approved modelli": attivo o disattivo. Almeno uno dei due deve essere attivo, altrimenti vedrai "Consenti almeno il testo libero o i modelli — altrimenti la chiave non potrà inviare nulla."
- "Consenti l'invio di file multimediali": attivo o disattivo.
- "Modelli" (facoltativo): nomi dei modelli, separati da virgole. Lascia vuoto per consentire qualsiasi modello.
- "Paesi destinatari consentiti" (facoltativo): codici paese a due lettere, ad esempio IT,FR,ES. Lascia vuoto per consentire qualsiasi paese.
- "Invio consentito dalle" ... "A": le fasce orarie in cui la chiave può inviare. Lasciali uguali per nessun limite orario. Gli orari seguono il fuso orario locale del tuo spazio di lavoro.
- "Daily messaggio limit (0 = unlimited)".
- Per una chiave di tipo "Importa SMS da un telefono", imposta "Solo contatti e clienti". Quando è attivo, un SMS ricevuto da qualsiasi altro numero resta sul telefono e non raggiunge la casella. Disattivalo solo se il telefono è dedicato esclusivamente all'attività aziendale.
- Fai clic su Salva.
- Una finestra mostra l'"URL di base" e la "Chiave API". Copiali subito. "Copia subito questa chiave — viene mostrata una sola volta." Inseriscili nelle impostazioni del tuo software.
Domande
Ho perso la mia chiave API. Posso visualizzarla di nuovo?
No. Viene mostrata una sola volta. Crea una nuova chiave, configurala nel tuo software, poi elimina la vecchia chiave.
Credo che una chiave sia stata compromessa. Cosa devo fare?
Elimina subito quella chiave o disattivala. Solo quella specifica chiave smetterà di funzionare. Il tuo numero WhatsApp e le altre chiavi non subiranno alcun impatto.
L'elenco "Sends da" è vuoto.
L'elenco mostra solo i numeri WhatsApp collegati e attivi. Collega prima un numero da Impostazioni > Messaggi > Canali.
Il mio programma riceve un rifiuto quando prova a inviare messaggi.
Verifica che l'interruttore "Gateway API" sia attivo e che la chiave sia abilitata. Controlla anche i vincoli della chiave: testo libero o modelli, file multimediali, modelli autorizzati, paesi consentiti, orari di invio e limite giornaliero. Si applicano inoltre le regole standard di WhatsApp: ad esempio, il testo libero funziona solo entro 24 ore dall'ultimo messaggio del cliente.
Una chiave "Apri una pratica" può anche inviare messaggi?
No, è progettata appositamente così. Una chiave per pratiche non può scrivere ai clienti e una chiave di invio non può aprire pratiche. Usa una chiave diversa per ciascun utilizzo.
Ho una vecchia chiave di tipo "Ricevi da a program". Funziona ancora?
Sì, le chiavi esistenti di quel tipo continuano a funzionare regolarmente. Non è più possibile crearne di nuove con quel tipo. In alternativa, usa "Apri una pratica" per quella gestione.
Altre informazioni su API chiavi.