Invio di SMS

Puoi usare il nodo messages per inviare SMS ai tuoi clienti.

Prima di iniziare

Devi soddisfare tutti i prerequisiti elencati nella sezione Prima di iniziare della documentazione Messaggi.

Limitazioni:

• Un SMS può avere una lunghezza massima di 4096 caratteri.

Passaggio 1: invio di una richiesta POST a /messages

Dopo aver ottenuto l'ID WhatsApp per l'utente che desideri contattare, utilizzalo per inviare un SMS. Specifica text nel campo type.

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

Per maggiori informazioni sui parametri, consulta:

• Parametri comuni a tutte le richieste di messaggio
• Parametri per i messaggi di testo

Se desideri formattare il messaggio, consulta Formattazione nei messaggi di testo.

Invio di URL negli SMS

Per impostazione predefinita, l'applicazione mobile di WhatsApp riconosce gli URL e li rende selezionabili. Per aggiungere un'anteprima dell'URL, includi "preview_url": true nel corpo del messaggio e assicurati che l'URL inizi con http:// o https://. È richiesto un nome host, gli indirizzi IP non corrispondono.

Tieni presente che l'uso di preview_url qui è diverso dall'API Cloud. Consulta la documentazione sull'API Cloud Messaggi.

Esempio

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

Nella maggior parte dei casi in cui si invia un URL, con o senza anteprima, il destinatario del messaggio vedrà un URL su cui è possibile cliccare.

Le anteprime degli URL vengono visualizzate solo nei seguenti scenari:

1. L'azienda ha inviato un modello di messaggio all'utente.
2. L'utente inizia una conversazione tramite un link "Clicca per iniziare a chattare".
3. L'utente aggiunge il numero di telefono dell'azienda alla propria rubrica e inizia una conversazione.

Passaggio 2: verifica della risposta

Una risposta positiva include un oggetto messages con un ID per il messaggio appena creato.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

Una risposta negativa contiene un messaggio di errore. Consulta Codici di errore e di stato per ulteriori informazioni.