Vai al contenuto
Wbiztool

API account WhatsApp

API Stato della connessione WhatsApp

Verifica se uno dei tuoi numeri WhatsApp è collegato e pronto per inviare messaggi. Usalo prima di una campagna, o mentre attendi che un numero appena collegato completi il collegamento. Usa questo endpoint invece di /api/v1/whatsapp/status/<id>/, che non funziona.

POSThttps://wbiztool.com/api/v1/whatsapp-client/status/

Corpo: JSON o campi di un modulo

Esempio rapido#

curl -X POST https://wbiztool.com/api/v1/whatsapp-client/status/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'

Sostituisci 12345, YOUR_API_KEY e 678 con i tuoi valori. Consulta Autenticazione per sapere dove trovarli.

Parametri della richiesta#

client_idintegerobbligatorio

Il tuo ID Client API, da Impostazioni → Chiavi API.

api_keystringobbligatorio

La tua chiave API, dalla stessa pagina.

whatsapp_clientintegerobbligatorio

ID del numero WhatsApp da controllare, dalle Impostazioni WhatsApp, da Elenca account oppure il whatsapp_client_id restituito da Collega un numero.

Usare i client ufficiali#

Il client Python chiama questo endpoint per te.

Python
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.get_whatsapp_client_status(678)
print(result)

Il client Python solleva requests.exceptions.HTTPError quando l'API restituisce HTTP 400 o 403, quindi racchiudi la chiamata in un try/except.

getWhatsAppClientStatus() del client Node.js chiama un indirizzo che non esiste e non riesce con un 404. Usa fetch come nell'Esempio rapido.

Risposta#

Quando le tue credenziali sono valide, la richiesta restituisce HTTP 200 con uno di questi corpi.

Il numero è collegato:

{ "message": "Connected", "status": 1 }

Il numero non è collegato:

{ "message": "Disconnected", "status": 0 }
CampoTipoDescrizione
statusinteger1 se il numero è collegato. 0 se non è collegato oppure se la richiesta non è riuscita.
messagestringConnected, Disconnected oppure l'errore.

Anche un numero che hai eliminato dalle Impostazioni WhatsApp restituisce Disconnected.

Errori#

MessaggioHTTPCome risolvere
Auth Error200Invia client_id, api_key e un whatsapp_client numerico nel corpo di una richiesta POST, come JSON valido o campi di un modulo.
Invalid Client Id403Invia client_id come numero intero, ad esempio 12345.
Auth Error: invalid api key400Verifica che la chiave esista, non sia stata eliminata e appartenga a questo client_id.
Auth Error 2200Quell'ID whatsapp_client non è nello spazio di lavoro di questa chiave API.
Demo Account can not access apis200Usa un account normale.

Suggerimenti#

  • Prima di inviare: se il numero da cui invii è scollegato, i suoi messaggi restano in coda finché non si ricollega o finché non scadono, quindi controlla lo stato prima di invii consistenti. I messaggi non inviati su un numero scollegato vengono rimossi dopo 90 giorni.
  • Dopo aver collegato un numero: interroga questo endpoint ogni pochi secondi finché non restituisce Connected. Il webhook connected può arrivare qualche secondo prima che questo endpoint restituisca Connected, quindi continua a interrogarlo per un minuto al massimo dopo l'evento. Vedi Collega un numero.
  • Tutti i numeri insieme: per ottenere lo stato di tutti i numeri in una sola chiamata, usa Elenca account.