API della chat web per SQL Server
Gestisci il sistema di chat dall'API. Accedi o rispondi alle conversazioni dalla nostra API.
Ottieni un elenco di canali di chat attivi con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'chat';
DECLARE @method varchar(500) = 'getchatchannels';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?class='+@class+'&method='+@method+'&user='+@user+'&password='+@password;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=chat | Classe alla quale si realizza la richiesta | Obbligatorio |
method=getchatchannels | 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 |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
-
list
- platformid
- platform
- name
-
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 |
Invia un messaggio tramite chat con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'chat';
DECLARE @method varchar(500) = 'sendmessage';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @platform varchar(500) = 'whatsapp';
DECLARE @platformid varchar(500) = '100';
DECLARE @destination varchar(500) = '3460000000';
DECLARE @message varchar(500) = 'test+message';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&platform='+@platform+'&platformid='+@platformid+'&destination='+@destination+'&message='+@message;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=chat | 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 |
platform | Piattaforma a cui viene inviato il messaggio. Valori possibili: 'webchat', 'whatsapp', 'telegram', 'operator' | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | Destinatario a cui viene inviato il messaggio di chat | Obbligatorio |
message | Messaggio da inviare tramite chat | 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 chat con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'chat';
DECLARE @method varchar(500) = 'sendfile';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @platform varchar(500) = 'whatsapp';
DECLARE @platformid varchar(500) = '100';
DECLARE @destination varchar(500) = '3460000000';
DECLARE @type varchar(500) = 'image';
DECLARE @fileurl varchar(500) = 'https://www.example.com/image.jpg';
DECLARE @thumburl varchar(500) = 'https://www.example.com/thumb.jpg';
DECLARE @message varchar(500) = 'test+message';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&platform='+@platform+'&platformid='+@platformid+'&destination='+@destination+'&type='+@type+'&fileurl='+@fileurl+'&thumburl='+@thumburl+'&message='+@message;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=chat | 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 |
platform | Piattaforma a cui viene inviato il messaggio. Valori possibili: 'webchat', 'whatsapp', 'telegram', 'operator' | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
destination | Destinatario a cui viene inviato il file | Obbligatorio |
type | Tipo di file inviato. Valori possibili: "image", "video", "audio", "voice", "document", "contact" | Obbligatorio |
fileurl | URL in cui si trova il file da inviare tramite chat | Obbligatorio |
thumburl | Url dell'immagine in miniatura che accompagna il file | Opzionale |
message | Messaggio che accompagna il file | 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 |
Ottieni un elenco di conversazioni in una chat con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'chat';
DECLARE @method varchar(500) = 'getchats';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @platform varchar(500) = 'whatsapp';
DECLARE @platformid varchar(500) = '100';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&platform='+@platform+'&platformid='+@platformid;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=chat | 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 |
platform | Piattaforma a cui viene inviato il messaggio. Valori possibili: 'webchat', 'whatsapp', 'telegram', 'operator' | Obbligatorio |
platformid | Identificatore della piattaforma | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
-
list
- platformid
- platform
- 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 l'elenco dei messaggi da una chat con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'chat';
DECLARE @method varchar(500) = 'getmessages';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @platform varchar(500) = 'whatsapp';
DECLARE @platformid varchar(500) = '100';
DECLARE @destination varchar(500) = '34600000000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&platform='+@platform+'&platformid='+@platformid+'&destination='+@destination;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=chat | 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 |
platform | Piattaforma a cui viene inviato il messaggio. Valori possibili: 'webchat', 'whatsapp', 'telegram', 'operator' | 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
- platform
- 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 con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'chat';
DECLARE @method varchar(500) = 'getunreadmessages';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @platform varchar(500) = 'whatsapp';
DECLARE @platformid varchar(500) = '100';
DECLARE @destination varchar(500) = '34600000000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&platform='+@platform+'&platformid='+@platformid+'&destination='+@destination;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
Impostazione | Descrizione | Obbligatorio / Opzionale |
---|---|---|
class=chat | 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 |
platform | Piattaforma a cui viene inviato il messaggio. Valori possibili: 'webchat', 'whatsapp', 'telegram', 'operator' | 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
- platform
- 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 |
Quale API per SQL Server dovrei usare?
Scopri i vantaggi e gli svantaggi di ciascuna delle nostre API. Scopri quale API è la migliore per il tuo software in SQL Server.
Questa API ti consente di connetterti a noi da SQL Server 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 SQL Server 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 SQL Server 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 SQL Server, 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 SQL Server, 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 SQL Server con la nostra API Chat
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.