Tutorial sulla convalida in blocco dei numeri di telefono WhatsApp

15 luglio 2024

Hai mai voluto assicurarti che i numeri dei clienti della tua azienda siano correttamente salvati nella tua rubrica? Con Wassenger questo cambia le regole del gioco per la comunicazione diretta. Per le aziende, verificare la validità, le cifre e il formato di numeri di telefono casuali e non normalizzati nel formato internazionale E164 è essenziale per massimizzare gli sforzi di marketing, risparmiare tempo e ridurre i costi quando si comunica con potenziali clienti nelle odierne attività digitali su scala globale.

Seguendo questo tutorial, puoi pulire e convalidare i numeri di telefono del tuo database usando l’API di Wassenger e ottenere numeri normalizzati, filtrati e validi in formato E164 che puoi usare per fare chiamate, inviare messaggi WhatsApp o SMS alla tua base utenti (a proposito, Wassenger può aiutarti a comunicare meglio su WhatsApp, scopri di più qui)

Wassenger offre una soluzione affidabile per convalidare i numeri di telefono su WhatsApp, semplificando la comunicazione e migliorando il coinvolgimento dei clienti. In questo articolo, approfondiremo l’importanza della convalida dei numeri e come Wassenger può aiutare a ottimizzare le tue strategie di outreach.

🤩 🤖 Wassenger è una piattaforma di comunicazione completa e una soluzione API per WhatsApp. Esplora più di 100+ casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti a una prova gratuita e iniziando in pochi minuti**!**

Requisiti

  • Avere un numero WhatsApp già collegato alla piattaforma e online.
  • Il Token API utente deve essere utilizzato in ogni richiesta API che richiede autenticazione

In questo tutorial useremo il seguente endpoint API:

Novità! Ora puoi validare una lista di numeri in una singola richiesta API passando i numeri nel corpo della chiamata. Clicca qui per provarlo

Convalidare i numeri

Convalida e normalizza una lista di numeri di telefono, eventualmente forzando il prefisso paese o il prefisso locale.

La convalida viene eseguita solo a livello di formato delle cifre, non verifica se un determinato numero di telefono esiste su WhatsApp.

URL API di destinazione (POST)

Il Token API utente deve essere utilizzato in ogni richiesta API che richiede autenticazione

https://api.wassenger.com/v1/numbers/validate

Header HTTPS richiesti

Puoi definirlo tramite il parametro di query URL “token” o l’header HTTP “Token”.

Content-Type: application/json
Token: $API-TOKEN

Corpo della richiesta in formato JSON

{
  "country": "US",
  "numbers": [
    {
      "phone": "202-456-1414"
    },
    {
      "phone": "+1 202 456 1414"
    },
    {
      "phone": "1 415(858-6273)"
    }
  ]
}

Ottieni la risposta API

{
  "numbers": [
    {
      "valid": true,
      "error": null,
      "phone": "+12024561414",
      "wid": "12024561414@c.us",
      "input": "202-456-1414",
      "kind": "fixed_line",
      "countryPrefix": 1,
      "country": "US",
      "formats": {
        "local": "2024561414",
        "national": "2024561414",
        "international": "+12024561414"
      }
    }
  ],
  "summary": {
    "valid": 3,
    "invalid": 0
  }
}

Validare numeri usando il codice

Scopri come usare il codice nel tuo browser senza installare alcun software.

Inoltre, puoi trovare diversi linguaggi che puoi testare su Replit.com:

# Gli esempi richiedono l’installazione del pacchetto Python requests. # Installalo eseguendo: pip install requests

import requests

url = "https://api.wassenger.com/v1/numbers/validate"

payload = { "country": "US", "numbers": [{ "phone": "202-456-1414" }, { "phone": "+1 202 456 1414" }, { "phone": "1 415 (858-6273)" }] } headers = { "Content-Type": "application/json", "Token": "$API_KEY" }

response = requests.post(url, json=payload, headers=headers)

print(response.json())

"https://api.wassenger.com/v1/numbers/validate", CURLOPT\_RETURNTRANSFER => true, CURLOPT\_ENCODING => "", CURLOPT\_MAXREDIRS => 10, CURLOPT\_TIMEOUT => 30, CURLOPT\_HTTP\_VERSION => CURL\_HTTP\_VERSION\_1\_1, CURLOPT\_CUSTOMREQUEST => "POST", CURLOPT\_POSTFIELDS => json\_encode(\[ 'country' => 'US', 'numbers' => \[ \[ 'phone' => '202-456-1414' \], \[ 'phone' => '+1 202 456 1414' \], \[ 'phone' => '1 415 (858-6273)' \] \] \]), CURLOPT\_HTTPHEADER => \[ "Content-Type: application/json", "Token: $API\_KEY" \], \]); $response = curl\_exec($curl); $err = curl\_error($curl); curl\_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } - [PHP](https://replit.com/new) \# Gli esempi richiedono l’installazione del pacchetto pecl\_http, un client HTTP semplice ed elegante per PHP. \# Installalo eseguendo: pecl install pecl\_http \# Ulteriori informazioni: https://pecl.php.net/package/pecl\_http/3.2.0 append(json\_encode(\[ 'country' => 'US', 'numbers' => \[ \[ 'phone' => '202-456-1414' \], \[ 'phone' => '+1 202 456 1414' \], \[ 'phone' => '1 415 (858-6273)' \] \] \])); $request->setRequestUrl('https://api.wassenger.com/v1/numbers/validate'); $request->setRequestMethod('POST'); $request->setBody($body); $request->setHeaders(\[ 'Content-Type' => 'application/json', 'Token' => '$API\_KEY' \]); $client->enqueue($request)->send(); $response = $client->getResponse(); echo $response->getBody(); - [Go](https://replit.com/new) ```swift package main import( "fmt" "strings" "net/http" "io" ) func main() { url:= "https://api.wassenger.com/v1/numbers/validate" payload:= strings.NewReader("{\"country\":\"US\", \"numbers\":[{\"phone\":\"202-456-1414\"}, {\"phone\":\"+1 202 456 1414\"}, {\"phone\":\"1 415(858-6273)\"}]}") req, _:= http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") req.Header.Add("Token", "$API_KEY") res, _:= http.DefaultClient.Do(req) defer res.Body.Close() body, _:= io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` - [C#](https://replit.com/new) (RestClient) ```swift // This code requires you to have installed RestSharp package. // Documentation: https://restsharp.dev // Installation: https://www.nuget.org/packages/RestSharp var client = new RestClient("https://api.wassenger.com/v1/numbers/validate"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Token", "$API_KEY"); request.AddParameter("application/json", "{\"country\":\"US\", \"numbers\":[{\"phone\":\"202-456-1414\"}, {\"phone\":\"+1 202 456 1414\"}, {\"phone\":\"1 415(858-6273)\"}]}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` - [Ruby](https://replit.com/new) require 'uri' require 'net/http' url = URI("https://api.wassenger.com/v1/numbers/validate") http = Net::HTTP.new(url.host, url.port) http.use\_ssl = true request = Net::HTTP::Post.new(url) request\["Content-Type"\] = 'application/json' request\["Token"\] = '$API\_KEY' request.body = "{\\"country\\":\\"US\\",\\"numbers\\":\[{\\"phone\\":\\"202-456-1414\\"},{\\"phone\\":\\"+1 202 456 1414\\"},{\\"phone\\":\\"1 415 (858-6273)\\"}\]}" response = http.request(request) puts response.read\_body - [Java](https://replit.com/new) ```swift // This code requires you to have installed Unirest package. // Documentation: https://kong.github.io/unirest-java/#requests // Installation: http://kong.github.io/unirest-java/ HttpResponse response = Unirest.post("https://api.wassenger.com/v1/numbers/validate") .header("Content-Type", "application/json") .header("Token", "$API_KEY") .body("{\"country\":\"US\", \"numbers\":[{\"phone\":\"202-456-1414\"}, {\"phone\":\"+1 202 456 1414\"}, {\"phone\":\"1 415(858-6273)\"}]}") .asString(); ``` > 🤩 🤖 [**Wassenger**](https://wassenger.com/) è una piattaforma di comunicazione completa e una soluzione API per WhatsApp. [**Esplora più di 100+ casi d'uso API e automatizza qualsiasi cosa su WhatsApp**](https://wassenger.com/) iscrivendoti [a una prova gratuita e iniziando in pochi minuti**!**](https://wassenger.com/register) #### Test live dell’upload del file usando l’API ![](/images/blog/whatsapp-phone-numbers-bulk-validation-tuto-02.png) [Esplora il nostro tester API live](https://app.wassenger.com/help/api-tester) ### FAQ #### Ho bisogno di un account WhatsApp Business? Il nostro sistema funziona allo stesso modo sia che tu abbia un account WhatsApp Personale sia Business. #### Posso usare Wassenger per chatbot? Sì, puoi costruire il tuo chatbot con la nostra API e i webhook. Per farlo, è necessario abbonarsi a un piano Platform che ti permetta di implementare chatbot sopra l’API. Esplora di più nel nostro articolo correlato [**qui**](https://medium.com/@wassenger/build-a-whatsapp-chatgpt-powered-ai-chatbot-for-your-business-595a60eb17da). #### Dove posso ottenere gli esempi di codice API? Controlla la [documentazione API](https://app.wassenger.com/docs) e seleziona l’esempio di codice pronto all’uso nel linguaggio desiderato. Forniamo esempi di codice per i linguaggi e gli strumenti CLI più comuni, come JavaScript, Node.js, Python, Ruby, PHP, Java, C#, Swift, Go e altri. > ***Cerchi altre risposte?*** [***Dai un’occhiata alle FAQ estese***](https://app.wassenger.com/help/category/faq)***.*** #### Ulteriori risorse utili #### Documentazione API 🖥️ Per maggiori dettagli sull’endpoint API, consulta la documentazione dove troverai tutti i dettagli sui parametri di richiesta accettati, le possibili risposte di successo o errore e esempi di codice pronti all’uso in più linguaggi di programmazione: [https://app.wassenger.com/docs/#tag/Numbers/operation/validateNumbers](https://app.wassenger.com/docs/#tag/Numbers/operation/validateNumbers)

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free