Guide del prodotto
Collega un account Telegram
Puoi collegare a Wbiztool il tuo account Telegram, accanto ai tuoi numeri WhatsApp. Invia con la stessa API e dalle stesse pagine di un numero WhatsApp, e le persone vedono i tuoi messaggi come normali messaggi Telegram inviati da te.
- Una sola API per entrambi. Invia messaggio, Invia a più numeri, Pianifica messaggio, Invia a un gruppo, Annulla messaggio e i webhook sullo stato dei messaggi funzionano allo stesso modo. Passa l'ID dell'account Telegram come
whatsapp_client. - Le stesse pagine. L'invio rapido, le campagne e i promemoria possono inviare da questo account.
- Più modi per raggiungere le persone. Invia a un numero di telefono, a uno @username, a un link t.me o a un gruppo.
Chi può farlo: Proprietari ed Editor collegano e gestiscono gli account Telegram.
Prima di iniziare#
- Telegram sul telefono, con l'accesso effettuato con l'account da cui vuoi inviare.
- Un indirizzo email confermato.
- Un piano in regola con i pagamenti e con un posto libero per un numero. Un account Telegram occupa uno dei posti per i numeri del tuo piano, come un numero WhatsApp. Vedi Limiti dei numeri.
- Messaggi rimasti nel tuo piano. Ogni messaggio inviato da un account Telegram usa un credito messaggi, come su WhatsApp.
Collegare il tuo account#
Nella pagina Numeri, fai clic su Aggiungi account Telegram. Lo trovi anche in fondo alla finestra Aggiungi un numero WhatsApp: Vuoi collegare un account Telegram? Aggiungi account Telegram.
La finestra Aggiungi un account Telegram offre due modi per accedere: Scansiona codice QR o Codice di accesso. Il risultato è lo stesso.
Con un codice QR#
Usalo quando il telefono è vicino al computer.
Apri Aggiungi account Telegram
Nella pagina Numeri, fai clic su Aggiungi account Telegram. La finestra si apre con Scansiona codice QR selezionato.
Mostra il codice QR
Fai clic su Mostra codice QR. La finestra Scansiona con Telegram mostra il codice.
Apri Aggiungi dispositivo sul telefono
Apri Telegram sul telefono e vai in Impostazioni → Dispositivi → Aggiungi dispositivo.
Scansiona il codice
Inquadra il codice QR con il telefono. Il codice cambia ogni 30 secondi: scansiona quello più recente. Quando l'accesso riesce, la finestra mostra Account Telegram collegato e "… è collegato. I messaggi che invii da questo account partono tramite Telegram."
Con un codice di accesso#
Usalo quando non puoi scansionare un codice QR, ad esempio quando il telefono è il tuo unico dispositivo.
Scegli Codice di accesso
Nella finestra Aggiungi un account Telegram, fai clic sulla scheda Codice di accesso.
Inserisci il tuo numero
Controlla il tuo paese in Prefisso internazionale. In Numero di telefono Telegram, digita il numero usato dal tuo account Telegram, senza prefisso internazionale, ad esempio
9876543210. Fai clic su Invia codice di accesso.Digita il codice
Telegram invia un codice di accesso alla tua app Telegram (o via SMS). Nella finestra Inserisci il codice di accesso, digitalo in Codice di accesso e fai clic su Accedi. La finestra mostra poi Account Telegram collegato.
Verifica in due passaggi#
Se il tuo account ha la verifica in due passaggi, dopo il codice QR o il codice di accesso la finestra chiede la sua password di Telegram: Inserisci la tua password di Telegram. Digita la tua password di Telegram (cloud) in Password di Telegram e fai clic su Accedi. Wbiztool la usa una sola volta per accedere e non la salva mai.
Dopo il collegamento#
- L'account riceve una scheda nella pagina Numeri con un badge Telegram e il suo ID, ad esempio ID 702. Fai clic sull'ID per copiarlo: usalo come
whatsapp_clientnell'API, come per un numero. - Fai clic su Invia messaggio di test per verificare che invii. In Invia a, digita uno @username o un numero di telefono con il prefisso internazionale, ad esempio
@nameo+91 98765 43210. - Rinomina e Rimuovi funzionano come per un numero WhatsApp. Vedi Gestire un numero.
Inviare dal tuo account Telegram#
Scegli l'account Telegram come qualsiasi numero: in Da nell'invio rapido, come numero di invio di una campagna o di un promemoria, oppure con il suo ID come whatsapp_client nell'API. I suoi messaggi compaiono nei Report, e il webhook di Invia messaggio segnala SENT o FAILED come per WhatsApp.
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 702,
"phone": "@emma_thompson",
"msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
}'
Sostituisci 12345, YOUR_API_KEY e 702 con i tuoi valori: 702 è l'ID dell'account Telegram, dalla sua scheda.
A chi puoi inviare#
Da un account Telegram, phone nell'API (e i numeri nell'invio rapido, i numeri di una campagna e Invia a di un promemoria) accetta uno qualsiasi di questi:
| Scrivi | Esempio | Da sapere |
|---|---|---|
| Un numero di telefono con il prefisso internazionale | +91 98765 43210 | La persona deve essere su Telegram. La prima volta, il numero viene aggiunto ai contatti Telegram del tuo account. Telegram rifiuta le persone che nascondono il proprio numero agli sconosciuti: il messaggio non riesce con "Not on Telegram, or their privacy settings hide this number". |
| Uno @username | @emma_thompson | Lo username Telegram della persona. |
| Un link t.me | t.me/emma_thompson | Equivale allo @username. Funziona anche https://t.me/emma_thompson. |
tg:<id> | tg:5012345678 | Il modo in cui l'inbox e i suoi webhook indicano una persona che non mostra né numero né username. Usalo per risponderle. |
Username, link t.me e tg:<id> funzionano solo da un account Telegram. Da un numero WhatsApp, Invia messaggio e Pianifica messaggio rispondono "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client", e Invia a più numeri li salta.
Quale account sceglie l'API#
Quando ometti whatsapp_client, Invia messaggio usa l'unico numero collegato, prima WhatsApp:
- Un solo numero WhatsApp collegato viene usato anche se è collegato anche un account Telegram. Aggiungere un account Telegram non sposta su di esso le tue integrazioni esistenti.
- Un account Telegram viene usato solo quando nessun numero WhatsApp è collegato.
- Uno @username usa l'unico account Telegram collegato.
Per inviare dall'account Telegram in tutti gli altri casi, passa il suo ID come whatsapp_client.
Gruppi#
Da un account Telegram, group_name (e Gruppi nell'invio rapido) accetta:
- lo @username o il link t.me di un gruppo pubblico, ad esempio
@lumen_clubot.me/lumen_club, oppure - il nome esatto di un gruppo o canale di cui l'account fa parte, ad esempio
Lumen VIP Club. Maiuscole e minuscole non contano.
L'account deve essere già membro del gruppo e poterci scrivere. Non entra mai da solo in un gruppo.
- Se nessun gruppo corrisponde, il messaggio non riesce con "Group not found".
- Se l'account non può scrivere nel gruppo, non riesce con "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)".
I limiti di Telegram#
Telegram limita il numero di persone che un account può contattare senza che lo abbiano contattato prima. Gli account nuovi sono i più limitati.
- Quando Telegram chiede di rallentare, l'account va in pausa e i suoi messaggi attendono. Partono dopo la pausa.
- Quando Telegram limita i messaggi agli sconosciuti, quel messaggio non riesce con "Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour", e l'account si ferma per un'ora.
Inbox (Unibox)#
Un account Telegram si può aggiungere all'inbox Unibox come un numero: in Numeri inbox, fai clic su Aggiungi numero all’inbox e sceglilo. Occupa uno dei numeri inbox del tuo componente aggiuntivo Unibox, come un numero WhatsApp.
- Le sue chat private compaiono nell'inbox: i messaggi che riceve e quelli inviati dal telefono o da Wbiztool. Le chat di Telegram mostrano un segno di Telegram.
- I file fino a 16 MB vengono copiati nell'inbox.
- Le risposte funzionano anche con le persone che nascondono il proprio numero.
- Gruppi, canali, Messaggi salvati e la chat di servizio di Telegram (quella con i codici di accesso) non vengono mai mostrati.
Il webhook di un account nell'inbox invia i suoi messaggi come quello di un numero. Il payload ha platform impostato a telegram, e contact.phone e message.from sono il numero della persona, il suo @username o tg:<id>: invia la tua risposta a quel valore come phone. Vedi Payload.
Disconnettere o riconnettere#
- Disconnetti nella scheda impedisce all'account di inviare. Fa anche uscire Wbiztool dall'elenco dei dispositivi dell'account in Telegram.
- Se Telegram chiude la sessione, ad esempio quando disconnetti Wbiztool in Impostazioni → Dispositivi o l'account viene disconnesso ovunque, la scheda mostra Non collegato. Proprietari ed Editor ricevono un avviso di disconnessione formulato per Telegram, come per un numero WhatsApp. Vedi Avvisi di disconnessione WhatsApp.
- Finché l'account non è collegato, i suoi messaggi restano In attesa di invio.
- Per collegarlo di nuovo, fai clic su Riconnetti nella sua scheda e accedi di nuovo, con un codice QR o un codice di accesso.
Non ancora disponibile#
- L'esportazione dei membri dei gruppi Telegram. L'esportazione dei membri dei gruppi funziona solo per i gruppi WhatsApp.
- I gruppi Telegram nell'inbox Unibox. Lì compaiono solo le chat private.
Risoluzione dei problemi#
| Problema | Cosa fare |
|---|---|
| Nessun pulsante Aggiungi account Telegram | Sei Analista in questo spazio di lavoro. Chiedi a un Proprietario di farlo o di renderti Editor. |
| Aggiungi account Telegram è disattivato | Passaci sopra con il puntatore per vedere il motivo: la tua email non è confermata, tutti i posti per i numeri del tuo piano sono occupati oppure il piano non è in regola con i pagamenti. Valgono le stesse regole dei numeri, vedi Limiti dei numeri. |
| Il codice QR non funziona | Cambia ogni 30 secondi: scansiona quello più recente, in Telegram in Impostazioni → Dispositivi → Aggiungi dispositivo. Se la finestra dice "L’accesso ha richiesto troppo tempo. Ricomincia.", fai clic su Ricomincia. |
| "Il codice non è corretto. Controlla l’ultimo codice inviato da Telegram e riprova." | Digita il codice di accesso più recente dalla tua app Telegram (o dall'SMS). |
| "Il codice è scaduto. Ricomincia per riceverne uno nuovo." | Fai clic su Ricomincia e digita il nuovo codice. |
| "La password non è corretta. Riprova." | Digita la password di Telegram dell'account, quella della verifica in due passaggi, non il codice di accesso. |
| "Questo numero non ha un account Telegram." | Controlla il paese e il numero, oppure accedi con il codice QR. |
| "Telegram chiede di aspettare prima di riprovare. Riprova più tardi." | Aspetta un po', poi accedi di nuovo. |
| Fallito con "Not on Telegram, or their privacy settings hide this number" | La persona non è su Telegram, oppure nasconde il proprio numero a chi non conosce. Invia invece al suo @username, oppure chiedile di scrivere prima al tuo account e rispondi dall'inbox. |
| Fallito con "Group not found" | Controlla il nome esatto del gruppo, oppure usa il suo @username o il link t.me. L'account deve essere membro del gruppo. |
| Fallito con "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)" | Entra prima nel gruppo in Telegram con questo account. Se solo gli amministratori possono scrivere, chiedi a un amministratore del gruppo. |
| Fallito con "Telegram limited this account: …" | Vedi I limiti di Telegram. L'invio riprende dopo un'ora. |
| L'API risponde "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client" | Passa l'ID dell'account Telegram come whatsapp_client. Vedi Quale account sceglie l'API. |
| La scheda mostra Non collegato | Telegram ha chiuso la sessione. Fai clic su Riconnetti e accedi di nuovo. |
