Vai al contenuto
Wbiztool

API account WhatsApp

API Elenca account WhatsApp

Usa questa API per ottenere in una sola chiamata l'elenco completo di tutti i tuoi numeri WhatsApp con il relativo stato di connessione. A differenza di Elenca numeri collegati, include anche i numeri scollegati.

POSThttps://wbiztool.com/api/v1/whatsapp/accounts/

Corpo: JSON o campi di un modulo

DifferenzaElenca accountElenca numeri collegati
Include numeri scollegati ed eliminatiNo
Chiavi degli elementiwhatsapp_client_id, whatsapp_number, statusid, whatsapp_client_id, whatsapp_client_number, is_connected
message in caso di successoNon inclusookay

Esempio rapido#

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

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

Nessuno dei due client ufficiali ha un metodo per questo endpoint, quindi chiamalo direttamente come negli esempi.

Parametri della richiesta#

client_idintegerobbligatorio

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

api_keystringobbligatorio

La tua chiave API, dalla stessa pagina. L'elenco riguarda lo spazio di lavoro in cui è stata creata questa chiave.

Risposta#

Una richiesta riuscita restituisce HTTP 200:

{
  "whatsapp_clients": [
    {
      "whatsapp_client_id": 678,
      "whatsapp_number": "919876543210",
      "status": "connected"
    },
    {
      "whatsapp_client_id": 702,
      "whatsapp_number": "919812345678",
      "status": "not_connected"
    }
  ],
  "status": 1
}
CampoTipoDescrizione
statusinteger1 in caso di successo, 0 se la richiesta non è riuscita.
whatsapp_clientsarrayTutti i numeri WhatsApp mai aggiunti a questo spazio di lavoro. Presente solo in caso di successo.
whatsapp_clients[].whatsapp_client_idintegerL'ID del numero. Passalo come whatsapp_client nelle altre chiamate API.
whatsapp_clients[].whatsapp_numberstringIl numero di telefono così come è stato salvato quando è stato aggiunto.
whatsapp_clients[].statusstringconnected o not_connected.

L'elenco non segue un ordine garantito. Ordina per whatsapp_client_id se l'ordine è importante.

Una risposta riuscita non ha il campo message, quindi leggilo con un valore di ripiego come negli esempi.

Errori#

MessaggioHTTPCome risolvere
Auth Error200Invia sia client_id sia api_key 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.

Se il server incontra un problema imprevisto, o se la richiesta non è una POST, la risposta è un oggetto vuoto: {}. Considera un fallimento l'assenza di status.

Suggerimenti#

  • Ricollegare un numero: un numero not_connected può essere ricollegato nelle Impostazioni WhatsApp oppure con Collega un numero.
  • Un solo numero: per controllare un singolo numero, usa Stato della connessione.
  • Più spazi di lavoro: la chiave API determina quale spazio di lavoro viene elencato. Usa una chiave creata nello spazio di lavoro che ti interessa.