API WhatsAPP Business per Unix
Invia messaggi WhatsAPP con la nostra API per Unix in modo facile e sicuro. Prova gratuitamente la nostra API per Unix. Il nostro team ti aiuterà a integrare l'invio automatico di WhatsAPP nella tua applicazione in Unix.
Funzionalità dell'API WhatsAPP Business
Invia un messaggio tramite WhatsAPP con Unix
wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessage&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&message=AFILNET_MESSAGE"
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 |
Invia un file tramite WhatsAPP con Unix
wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessage&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendfile&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&type=AFILNET_TYPE&fileurl=AFILNET_FILEURL&thumburl=AFILNET_THUMBURL&message=AFILNET_MESSAGE"
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 |
Invia un messaggio modello tramite WhatsAPP con Unix
wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessage&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendfile&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&type=AFILNET_TYPE&fileurl=AFILNET_FILEURL&thumburl=AFILNET_THUMBURL&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessagefromtemplate&user=AFILNET_USER&password=AFILNET_PASSWORD&idtemplate=AFILNET_IDTEMPLATE&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&options=AFILNET_OPTIONS"
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 |
Ottieni un elenco di conversazioni WhatsAPP con Unix
wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessage&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendfile&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&type=AFILNET_TYPE&fileurl=AFILNET_FILEURL&thumburl=AFILNET_THUMBURL&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessagefromtemplate&user=AFILNET_USER&password=AFILNET_PASSWORD&idtemplate=AFILNET_IDTEMPLATE&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&options=AFILNET_OPTIONS"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=getchats&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID"
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 |
Ottieni un elenco di messaggi WhatsAPP con Unix
wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessage&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendfile&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&type=AFILNET_TYPE&fileurl=AFILNET_FILEURL&thumburl=AFILNET_THUMBURL&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessagefromtemplate&user=AFILNET_USER&password=AFILNET_PASSWORD&idtemplate=AFILNET_IDTEMPLATE&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&options=AFILNET_OPTIONS"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=getchats&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=getmessages&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION"
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 |
Ottieni un elenco di messaggi non letti da una chat WhatsAPP con Unix
wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessage&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendfile&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&type=AFILNET_TYPE&fileurl=AFILNET_FILEURL&thumburl=AFILNET_THUMBURL&message=AFILNET_MESSAGE"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=sendmessagefromtemplate&user=AFILNET_USER&password=AFILNET_PASSWORD&idtemplate=AFILNET_IDTEMPLATE&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION&options=AFILNET_OPTIONS"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=getchats&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=getmessages&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION"wget -qO- "https://www.afilnet.com/api/http/?class=whatsapp&method=getunreadmessages&user=AFILNET_USER&password=AFILNET_PASSWORD&platformid=AFILNET_PLATFORMID&destination=AFILNET_DESTINATION"
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 |
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"}}} |
---|
Quale API per Unix dovrei usare?
Scopri i vantaggi e gli svantaggi di ciascuna delle nostre API. Scopri quale API è la migliore per il tuo software in Unix.
Questa API ti consente di connetterti a noi da Unix per inviare richieste tramite richieste HTTP GET. Questa richiesta invia i parametri nello stesso URL della richiesta.
- HTTP GET è estremamente semplice da implementare
- Le informazioni vengono inviate non crittografate (le password possono essere estratte dai registri o dalla cache)
- Richiesta massima di ~4000 caratteri
L'API di richiesta POST ti consente di connetterti alla nostra API da Unix inviando parametri di richiesta tramite parametri POST HTTP. Le informazioni vengono inviate indipendentemente dall'URL.
- HTTP POST è semplice da implementare
- Le informazioni vengono inviate crittografate
- Non c'è limite alla dimensione della richiesta
- Sicurezza media
L'API di autenticazione di base consente l'utilizzo di richieste GET e POST in Unix con un livello di sicurezza aggiuntivo, poiché in questo caso nome utente e password vengono inviati nell'intestazione della richiesta.
- L'autenticazione di base è facile da implementare
- I dati di accesso vengono inviati crittografati
- Il limite di dimensione dipende dall'uso di GET o POST
- Sicurezza media
SOAP ti consente di inviare richieste in formato XML con Unix, SOAP aggiunge un ulteriore livello di sicurezza alle richieste API.
- L'integrazione di SOAP è più complessa
- Le informazioni vengono inviate crittografate
- Non c'è limite alla dimensione della richiesta
- Sicurezza medio/alta
La nostra API JSON ti consente di inviare richieste in formato JSON con Unix, inoltre questa API aggiunge il protocollo oAuth 2.0 nell'autenticazione che ti consente di aggiungere un ulteriore livello di sicurezza.
- L'integrazione di JSON oAuth 2.0 è più complessa
- Le informazioni vengono inviate crittografate
- Non c'è limite alla dimensione della richiesta
- Alta sicurezza
Connetti Unix con la nostra API WhatsAPP Business
Registrati come cliente
Per poter accedere all'API devi essere un client Afilnet. La registrazione richiederà alcuni minuti.
Richiedi la tua prova gratuita
La nostra azienda ti offrirà un saldo di prova che ti consentirà di testare con l'API di cui hai bisogno.
Integra l'API
Esegui l'integrazione API utilizzando il linguaggio di programmazione di tua scelta. Se hai domande o suggerimenti sull'API, contattaci
Benvenuti in Afilnet!
Tutto pronto!, È riuscito a migliorare le sue comunicazioni con Afilnet. Siamo qui per supportare la nostra API quando ne hai bisogno
Contatta il nostro team per qualsiasi domanda tramite i metodi di contatto che offriamo. Il nostro team cercherà di offrirti una soluzione immediata e ti aiuterà nell'integrazione della nostra API nel tuo Software.