WhatsAPP Business API
Invia / Ricevi messaggi, immagini, audio e video tramite WhatsAPP in modo automatizzato tramite API
- API HTTP, invia voce da qualsiasi linguaggio di programmazione.
- API ufficiale, lavoriamo con l'API ufficiale di Facebook
- 99,9% SLA, ottimizziamo le prestazioni di tutti i server.
- Massima Connettività, Compatibile con qualsiasi cellulare con WhatsAPP
Funzionalità dell'API di WhatsAPP Business
Invia un messaggio tramite WhatsAPP
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=whatsapp | Classe alla quale si realizza la richiesta | Obbligatorio |
method=sendmessage | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
user | L’utente / email del suo conto Afilnet | Obbligatorio |
password | La password del suo conto Afilnet | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | whatsapp.sendmessage_destination | Obbligatorio |
message | whatsapp.sendmessage_message | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
Codice | Descrizione |
---|---|
MISSING_USER | Utente / email non aggiunta |
MISSING_PASSWORD | Password non aggiunta |
MISSING_CLASS | Categoria non inclusa |
MISSING_METHOD | Metodo non incluso |
MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
INCORRECT_USER_PASSWORD | Utente o password incorretti |
INCORRECT_CLASS | Categoria incorretta |
INCORRECT_METHOD | Metodo incorretto |
CHANNEL_NOT_FOUND | Il canale indicato non esiste |
Impostazioni.
- class : whatsapp
- method : sendmessage
- user : user
- password : password
- platformid : 100
- destination : 3460000000
- message : test+message
Richiesta:
Invia un file tramite WhatsAPP
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=whatsapp | Classe alla quale si realizza la richiesta | Obbligatorio |
method=sendfile | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
user | L’utente / email del suo conto Afilnet | Obbligatorio |
password | La password del suo conto Afilnet | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | whatsapp.sendfile_destination | Obbligatorio |
type | whatsapp.sendfile_type | Obbligatorio |
fileurl | whatsapp.sendfile_fileurl | Obbligatorio |
thumburl | whatsapp.sendfile_thumburl | Opzionale |
message | whatsapp.sendfile_message | Opzionale |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
Codice | Descrizione |
---|---|
MISSING_USER | Utente / email non aggiunta |
MISSING_PASSWORD | Password non aggiunta |
MISSING_CLASS | Categoria non inclusa |
MISSING_METHOD | Metodo non incluso |
MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
INCORRECT_USER_PASSWORD | Utente o password incorretti |
INCORRECT_CLASS | Categoria incorretta |
INCORRECT_METHOD | Metodo incorretto |
CHANNEL_NOT_FOUND | Il canale indicato non esiste |
CHAT_NOT_FOUND | La chat indicata non esiste |
INCORRECT_FILETYPE | Il tipo di file è sbagliato, controlla i possibili valori |
INCORRECT_FILEURL | L'URL del file non è valido |
INCORRECT_THUMBURL | L'URL della miniatura non è valido |
Impostazioni.
- class : whatsapp
- method : sendfile
- user : user
- password : password
- platformid : 100
- destination : 3460000000
- type : image
- fileurl : https://www.example.com/image.jpg
- thumburl : https://www.example.com/thumb.jpg
- message : test+message
Richiesta:
Invia un messaggio modello tramite WhatsAPP
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=whatsapp | Classe alla quale si realizza la richiesta | Obbligatorio |
method=sendmessagefromtemplate | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
user | L’utente / email del suo conto Afilnet | Obbligatorio |
password | La password del suo conto Afilnet | Obbligatorio |
idtemplate | Identificatore del modello | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | Destinatario del messaggio (Numero in formato internazionale) | Obbligatorio |
options | Le opzioni permettono di parametrizzare e configurare il messaggio da inviare (Vedi Allegato). | Opzionale |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
Codice | Descrizione |
---|---|
MISSING_USER | Utente / email non aggiunta |
MISSING_PASSWORD | Password non aggiunta |
MISSING_CLASS | Categoria non inclusa |
MISSING_METHOD | Metodo non incluso |
MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
INCORRECT_USER_PASSWORD | Utente o password incorretti |
INCORRECT_CLASS | Categoria incorretta |
INCORRECT_METHOD | Metodo incorretto |
CHANNEL_NOT_FOUND | Il canale indicato non esiste |
Impostazioni.
- class : whatsapp
- method : sendmessagefromtemplate
- user : user
- password : password
- idtemplate : 100
- platformid : 100
- destination : 3460000000
- options : {"header":{"file":"url"}}
Richiesta:
Ottieni un elenco di conversazioni WhatsAPP
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=whatsapp | Classe alla quale si realizza la richiesta | Obbligatorio |
method=getchats | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
user | L’utente / email del suo conto Afilnet | Obbligatorio |
password | La password del suo conto Afilnet | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
-
list
- platformid
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (si status=error), qui ricevera il codice errore
Codici di errore:
Codice | Descrizione |
---|---|
MISSING_USER | Utente / email non aggiunta |
MISSING_PASSWORD | Password non aggiunta |
MISSING_CLASS | Categoria non inclusa |
MISSING_METHOD | Metodo non incluso |
MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
INCORRECT_USER_PASSWORD | Utente o password incorretti |
INCORRECT_CLASS | Categoria incorretta |
INCORRECT_METHOD | Metodo incorretto |
CHANNEL_NOT_FOUND | Il canale indicato non esiste |
CHAT_NOT_FOUND | La chat indicata non esiste |
Impostazioni.
- class : whatsapp
- method : getchats
- user : user
- password : password
- platformid : 100
Richiesta:
Ottieni un elenco di messaggi WhatsAPP
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=whatsapp | Classe alla quale si realizza la richiesta | Obbligatorio |
method=getmessages | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
user | L’utente / email del suo conto Afilnet | Obbligatorio |
password | La password del suo conto Afilnet | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | Destinatario da cui si desidera ottenere i messaggi | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
-
list
- platformid
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (si status=error), qui ricevera il codice errore
Codici di errore:
Codice | Descrizione |
---|---|
MISSING_USER | Utente / email non aggiunta |
MISSING_PASSWORD | Password non aggiunta |
MISSING_CLASS | Categoria non inclusa |
MISSING_METHOD | Metodo non incluso |
MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
INCORRECT_USER_PASSWORD | Utente o password incorretti |
INCORRECT_CLASS | Categoria incorretta |
INCORRECT_METHOD | Metodo incorretto |
CHANNEL_NOT_FOUND | Il canale indicato non esiste |
CHAT_NOT_FOUND | La chat indicata non esiste |
Impostazioni.
- class : whatsapp
- method : getmessages
- user : user
- password : password
- platformid : 100
- destination : 34600000000
Richiesta:
Ottieni un elenco di messaggi non letti da una chat WhatsAPP
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=whatsapp | Classe alla quale si realizza la richiesta | Obbligatorio |
method=getunreadmessages | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
user | L’utente / email del suo conto Afilnet | Obbligatorio |
password | La password del suo conto Afilnet | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | Destinatario da cui si desidera ottenere i messaggi | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
-
list
- platformid
- message
- destination
- messageid
- issent
- status
- datetime
-
list
- error (si status=error), qui ricevera il codice errore
Codici di errore:
Codice | Descrizione |
---|---|
MISSING_USER | Utente / email non aggiunta |
MISSING_PASSWORD | Password non aggiunta |
MISSING_CLASS | Categoria non inclusa |
MISSING_METHOD | Metodo non incluso |
MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
INCORRECT_USER_PASSWORD | Utente o password incorretti |
INCORRECT_CLASS | Categoria incorretta |
INCORRECT_METHOD | Metodo incorretto |
CHANNEL_NOT_FOUND | Il canale indicato non esiste |
CHAT_NOT_FOUND | La chat indicata non esiste |
Impostazioni.
- class : whatsapp
- method : getunreadmessages
- user : user
- password : password
- platformid : 100
- destination : 34600000000
Richiesta:
ALLEGATO: Opzioni aggiuntive in Messaggi
In questo allegato imparerai come inviare messaggi dai tuoi modelli. I modelli WhatsAPP ti consentono di inviare messaggi più elaborati rispetto ai messaggi di testo, permettendoti di allegare file e includere pulsanti nei tuoi messaggi.
Opzioni
Le opzioni ti consentono di inviare messaggi interattivi, allegare immagini, video, documenti e condividere posizioni tramite WhatsApp. Per fare ciò, qui imparerai come personalizzare il parametro "opzioni". Il parametro "opzioni" deve essere una stringa in formato JSON seguendo le seguenti specifiche:
Parametri principali
header | Dettagli sull'intestazione del messaggio (facoltativo) |
---|---|
params | Valori ai diversi valori del modello (facoltativo) |
Esempio
{"header":"", "params": ""} |
Definire l'intestazione
La definizione di un'intestazione ti consentirà di allegare diversi file e servizi ai tuoi messaggi WhatsAPP
Invia un'immagine
file | URL immagine (formati consentiti: JPG, PNG, WEBP) Il file deve essere caricato su Internet ed essere accessibile tramite un URL
|
---|
Invia un video
file | URL del video (formati consentiti: MP4, MPEG, 3GP) Il file deve essere caricato su Internet ed essere accessibile tramite un URL
|
---|
Invia un documento
file | URL del documento (formati consentiti: TXT, PDF, PPT, DOC, DOCX, XLS, PPTX, XLSX) Il file deve essere caricato su Internet ed essere accessibile tramite un URL
|
---|
Invia una posizione
file | Latitudine e longitudine con il formato: (0.0000, 0.0000) | ||||
---|---|---|---|---|---|
location |
|
Definire i parametri
L'utilizzo dei parametri ti consentirà di personalizzare i tuoi modelli per ciascun destinatario, consentendo di includere nel messaggio le informazioni relative al destinatario. Alcuni esempi di queste informazioni potrebbero essere: dati personali, dati relativi al tuo account, informazioni di tracciamento, ecc.
Esempio JSON: | {"params":{"name":"John", "orderid": "10"}} |
---|
Esempi JSON validi
Invia un messaggio con parametri personalizzati
In questo esempio invieremo un messaggio parametrizzato.
Messaggio modello con parametri: | Gentile {{name}}, il tuo ordine con ID: {{orderid}} ha lasciato i nostri magazzini |
---|---|
Esempio JSON: | {"params":{"name":"John", "orderid": "10"}} |
Invia un'immagine
In questo esempio utilizzeremo un modello che ha un'immagine come intestazione.
Esempio JSON: | {"header":{"file":"https:\/\/test.com\/test.jpg"}} |
---|
Invia un'immagine e un messaggio con parametri personalizzati
In questo esempio utilizzeremo un modello che ha un'immagine come intestazione. Alleghiamo un'immagine con il numero di tracciamento.
Messaggio modello con parametri: | Gentile {{name}}, il tuo ordine con ID: {{orderid}} ha lasciato i nostri magazzini |
---|---|
Esempio JSON: | {"header":{"file":"https:\/\/test.com\/test.jpg"}, "params":{"name":"John", "orderid": "10"}} |
Invia un video
In questo esempio utilizzeremo un modello che ha un video come intestazione.
Esempio JSON: | {"header":{"file":"https:\/\/test.com\/test.mp4"}} |
---|
Invia un documento
In questo esempio utilizzeremo un modello che ha un documento come intestazione.
Esempio JSON: | {"header":{"file":"https:\/\/test.com\/test.mp4"}} |
---|
Invia una posizione
In questo esempio utilizzeremo un modello che ha una posizione come intestazione.
Esempio JSON: | {"header":{"file":"(LATITUDE, LONGITUDE)","location":{"name":"NAME","address":"ADDRESS"}}} |
---|
Strumenti che valorizzano il nostro API WhatsApp Business
CONNESSIONE API SICURA
Sicurezza su misura per la tua attività
Configura le tue connessioni API, crea nuovi accessi e gestisci quelli esistenti.
Filtra tutti gli accessi API per IP, aggiungi o rimuovi IP abilitati per garantire la sicurezza dei tuoi accessi.
Tieni traccia di tutte le connessioni effettuate, API utilizzate e date / ora di connessione
API MULTIPLE
Connettività su misura per la tua azienda
Ti offriamo più API per connetterti con noi, abbiamo un'API HTTP, BASIC AUTH, SOAP e JWT Authentication in modo che tu possa connetterti con noi nel modo desiderato.
Connettiti con qualsiasi API in modo sicuro, semplice e centralizzato . L'API Afilnet è perfetta per il tuo software.
Registri API
Conosci ogni richiesta nel dettaglio
Grazie ai nostri log potrai rivedere tutte le richieste fatte e la relativa risposta dalla nostra API, che ti permetterà di consultare i dettagli quando ne avrai bisogno.
Le informazioni che puoi consultare sono le seguenti:
- IP di origine della richiesta
- Data e ora della richiesta
- API e metodo chiamati
- Parametri inviati all'API
- Risposta dell'API
- metadati
Passaggi per utilizzare l'API di WhatsApp Business
Segui i passaggi per accedere all'API di WhatsApp Business
Registrati come cliente
Devi essere registrato come cliente per ottenere le credenziali per utilizzare WhatsAPP Business API . Una volta registrato, puoi effettuare le richieste che ti servono alla nostra API.
Controlla la tua attività su Facebook
Per poter utilizzare l'API di WhatsAPP Business, è essenziale disporre di un profilo aziendale verificato su Facebook. Puoi trovare ulteriori informazioni su Facebook Business
Acquisisci WhatsAPP Business
Contattaci in modo che possiamo fornirti un numero virtuale per WhatsAPP Business, vedi le tariffe del servizio sulla nostra pagina delle tariffe.
Integra WhatsAPP Business
Utilizza i metodi API che offriamo e integrali con i servizi WhatsAPP Business Afilnet
Funzionalità del servizio API WhatsAPP Business
Automatizza WhatsAPP
Automatizza le notifiche da WhatsAPP tramite APIAudio, immagini, video e documenti
Ricevi e / o invia i file di cui hai bisogno tramite WhatsAPP Business API.Gestione contatti e colloqui
Gestisci i tuoi contatti e conversazioni su WhatsAPP con la nostra API.Invia servizi cloud tramite WhatsAPP
Invia file al cloud tramite WhatsAPP, allega sondaggi, contratti e molto altro.Sicurezza della lista bianca
Abilita le liste bianche e consenti le connessioni solo dagli IP inclusi.Accessi multipli per account
Puoi creare tutti gli utenti da connettere all'API con lo stesso account che desideri.Sottoconti
Crea sotto-account per altre aziende o dipartimenti con la loro connessione API e il loro saldo.API gratuita
Puoi utilizzare l'API senza limitazioni e gratuitamente, paghi solo per l'utilizzo dei servizi.Domande frequenti sull'API di WhatsAPP Business
Qui troverai le domande più comuni che abbiamo ricevuto sul servizio WhatsAPP Business API.
Tramite WhatsAPP Business API potrai ricevere tutti i messaggi WhatsAPP inviati al tuo account, rispondere ad essi e avviare conversazioni con messaggi basati su modelli pre-autorizzati da WhatsAPP.
Puoi inviare WhatsAPP solo agli utenti che hanno precedentemente consentito di essere contattati da questo canale e utilizzando solo messaggi basati su modelli precedentemente autorizzati.
Puoi avere tutte le Chat attive di WhatsAPP di cui hai bisogno, purché soddisfi i requisiti stabiliti da WhatsAPP.
Nel servizio WhatsAPP Business API paghi per i canali attivi per WhatsAPP, pagherai solo un canone mensile per numero WhatsAPP Business attivo e il prezzo per conversazione (chat illimitate con un destinatario per 24 ore), puoi consultare maggiori informazioni sul nostro tassi di pagina.