API de chat Web pour SQL Server
Gérez le système de chat à partir de l'API. Accédez ou répondez aux conversations depuis notre API.
Obtenez une liste des canaux de chat actifs avec 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
Paramètre | Description | Obligatoire / Optionnel |
---|---|---|
class=chat | Classe à laquelle la requête est réalisée | Obligatoire |
method=getchatchannels | Méthode de la classe à laquelle la requête est réalisée | Obligatoire |
user | L'utilisateur / e-mail de votre compte chez Afilnet | Obligatoire |
password | Le mot de passe de votre compte chez Afilnet | Obligatoire |
Répondre:
- statut
-
result (si status=success), vous recevrez les valeurs suivantes :
-
list
- platformid
- platform
- name
-
list
- error (si status=error), vous recevrez le code d'erreur
Codes d'erreur :
Code | Description |
---|---|
MISSING_USER | Utilisateur / e-mail non renseigné |
MISSING_PASSWORD | Mot de passe non renseigné |
MISSING_CLASS | Classe non renseignée |
MISSING_METHOD | Méthode non renseignée |
MISSING_COMPULSORY_PARAM | Paramètre obligatoire non renseigné |
INCORRECT_USER_PASSWORD | Utilisateur ou mot de passe incorrect |
INCORRECT_CLASS | Classe incorrecte |
INCORRECT_METHOD | Méthode incorrecte |
Envoyer un message par chat avec 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
Paramètre | Description | Obligatoire / Optionnel |
---|---|---|
class=chat | Classe à laquelle la requête est réalisée | Obligatoire |
method=sendmessage | Méthode de la classe à laquelle la requête est réalisée | Obligatoire |
user | L'utilisateur / e-mail de votre compte chez Afilnet | Obligatoire |
password | Le mot de passe de votre compte chez Afilnet | Obligatoire |
platform | Plateforme à laquelle le message est envoyé. Valeurs possibles: 'webchat', 'whatsapp', 'telegram', 'operator' | Obligatoire |
platformid | Identifiant de la plateforme | Obligatoire |
destination | Destinataire où le message de discussion est envoyé | Obligatoire |
message | Message à envoyer via le chat | Obligatoire |
Répondre:
- statut
-
result (si status=success), vous recevrez les valeurs suivantes :
- Acucun valeur supplémentaire vous sera envoyé
- error (si status=error), vous recevrez le code d'erreur
Codes d'erreur :
Code | Description |
---|---|
MISSING_USER | Utilisateur / e-mail non renseigné |
MISSING_PASSWORD | Mot de passe non renseigné |
MISSING_CLASS | Classe non renseignée |
MISSING_METHOD | Méthode non renseignée |
MISSING_COMPULSORY_PARAM | Paramètre obligatoire non renseigné |
INCORRECT_USER_PASSWORD | Utilisateur ou mot de passe incorrect |
INCORRECT_CLASS | Classe incorrecte |
INCORRECT_METHOD | Méthode incorrecte |
CHANNEL_NOT_FOUND | Le canal indiqué n'existe pas |
Envoyer un fichier par chat avec 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
Paramètre | Description | Obligatoire / Optionnel |
---|---|---|
class=chat | Classe à laquelle la requête est réalisée | Obligatoire |
method=sendfile | Méthode de la classe à laquelle la requête est réalisée | Obligatoire |
user | L'utilisateur / e-mail de votre compte chez Afilnet | Obligatoire |
password | Le mot de passe de votre compte chez Afilnet | Obligatoire |
platform | Plateforme à laquelle le message est envoyé. Valeurs possibles: 'webchat', 'whatsapp', 'telegram', 'operator' | Obligatoire |
platformid | Identifiant de la plateforme | Obligatoire |
destination | Destinataire où le fichier est envoyé | Obligatoire |
type | Type de fichier envoyé. Valeurs possibles: "image", "vidéo", "audio", "voix", "document", "contact" | Obligatoire |
fileurl | URL où se trouve le fichier à envoyer par chat | Obligatoire |
thumburl | URL de l'image miniature qui accompagne le fichier | Optionnel |
message | Message accompagnant le dossier | Optionnel |
Répondre:
- statut
-
result (si status=success), vous recevrez les valeurs suivantes :
- Acucun valeur supplémentaire vous sera envoyé
- error (si status=error), vous recevrez le code d'erreur
Codes d'erreur :
Code | Description |
---|---|
MISSING_USER | Utilisateur / e-mail non renseigné |
MISSING_PASSWORD | Mot de passe non renseigné |
MISSING_CLASS | Classe non renseignée |
MISSING_METHOD | Méthode non renseignée |
MISSING_COMPULSORY_PARAM | Paramètre obligatoire non renseigné |
INCORRECT_USER_PASSWORD | Utilisateur ou mot de passe incorrect |
INCORRECT_CLASS | Classe incorrecte |
INCORRECT_METHOD | Méthode incorrecte |
CHANNEL_NOT_FOUND | Le canal indiqué n'existe pas |
CHAT_NOT_FOUND | Le chat indiqué n'existe pas |
INCORRECT_FILETYPE | Le type de fichier est incorrect, vérifiez les valeurs possibles |
INCORRECT_FILEURL | L'URL du fichier n'est pas valide |
INCORRECT_THUMBURL | L'URL de la miniature n'est pas valide |
Obtenez une liste de conversations dans un chat avec 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
Paramètre | Description | Obligatoire / Optionnel |
---|---|---|
class=chat | Classe à laquelle la requête est réalisée | Obligatoire |
method=getchats | Méthode de la classe à laquelle la requête est réalisée | Obligatoire |
user | L'utilisateur / e-mail de votre compte chez Afilnet | Obligatoire |
password | Le mot de passe de votre compte chez Afilnet | Obligatoire |
platform | Plateforme à laquelle le message est envoyé. Valeurs possibles: 'webchat', 'whatsapp', 'telegram', 'operator' | Obligatoire |
platformid | Identifiant de la plateforme | Obligatoire |
Répondre:
- statut
-
result (si status=success), vous recevrez les valeurs suivantes :
-
list
- platformid
- platform
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (si status=error), vous recevrez le code d'erreur
Codes d'erreur :
Code | Description |
---|---|
MISSING_USER | Utilisateur / e-mail non renseigné |
MISSING_PASSWORD | Mot de passe non renseigné |
MISSING_CLASS | Classe non renseignée |
MISSING_METHOD | Méthode non renseignée |
MISSING_COMPULSORY_PARAM | Paramètre obligatoire non renseigné |
INCORRECT_USER_PASSWORD | Utilisateur ou mot de passe incorrect |
INCORRECT_CLASS | Classe incorrecte |
INCORRECT_METHOD | Méthode incorrecte |
CHANNEL_NOT_FOUND | Le canal indiqué n'existe pas |
CHAT_NOT_FOUND | Le chat indiqué n'existe pas |
Obtenir la liste des messages d'un chat avec 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
Paramètre | Description | Obligatoire / Optionnel |
---|---|---|
class=chat | Classe à laquelle la requête est réalisée | Obligatoire |
method=getmessages | Méthode de la classe à laquelle la requête est réalisée | Obligatoire |
user | L'utilisateur / e-mail de votre compte chez Afilnet | Obligatoire |
password | Le mot de passe de votre compte chez Afilnet | Obligatoire |
platform | Plateforme à laquelle le message est envoyé. Valeurs possibles: 'webchat', 'whatsapp', 'telegram', 'operator' | Obligatoire |
platformid | Identifiant de la plateforme | Obligatoire |
destination | Destinataire dont vous souhaitez obtenir les messages | Obligatoire |
Répondre:
- statut
-
result (si status=success), vous recevrez les valeurs suivantes :
-
list
- platformid
- platform
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (si status=error), vous recevrez le code d'erreur
Codes d'erreur :
Code | Description |
---|---|
MISSING_USER | Utilisateur / e-mail non renseigné |
MISSING_PASSWORD | Mot de passe non renseigné |
MISSING_CLASS | Classe non renseignée |
MISSING_METHOD | Méthode non renseignée |
MISSING_COMPULSORY_PARAM | Paramètre obligatoire non renseigné |
INCORRECT_USER_PASSWORD | Utilisateur ou mot de passe incorrect |
INCORRECT_CLASS | Classe incorrecte |
INCORRECT_METHOD | Méthode incorrecte |
CHANNEL_NOT_FOUND | Le canal indiqué n'existe pas |
CHAT_NOT_FOUND | Le chat indiqué n'existe pas |
Obtenir une liste des messages non lus à partir d'un chat avec 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
Paramètre | Description | Obligatoire / Optionnel |
---|---|---|
class=chat | Classe à laquelle la requête est réalisée | Obligatoire |
method=getunreadmessages | Méthode de la classe à laquelle la requête est réalisée | Obligatoire |
user | L'utilisateur / e-mail de votre compte chez Afilnet | Obligatoire |
password | Le mot de passe de votre compte chez Afilnet | Obligatoire |
platform | Plateforme à laquelle le message est envoyé. Valeurs possibles: 'webchat', 'whatsapp', 'telegram', 'operator' | Obligatoire |
platformid | Identifiant de la plateforme | Obligatoire |
destination | Destinataire dont vous souhaitez obtenir les messages | Obligatoire |
Répondre:
- statut
-
result (si status=success), vous recevrez les valeurs suivantes :
-
list
- platformid
- platform
- message
- destination
- messageid
- issent
- status
- datetime
-
list
- error (si status=error), vous recevrez le code d'erreur
Codes d'erreur :
Code | Description |
---|---|
MISSING_USER | Utilisateur / e-mail non renseigné |
MISSING_PASSWORD | Mot de passe non renseigné |
MISSING_CLASS | Classe non renseignée |
MISSING_METHOD | Méthode non renseignée |
MISSING_COMPULSORY_PARAM | Paramètre obligatoire non renseigné |
INCORRECT_USER_PASSWORD | Utilisateur ou mot de passe incorrect |
INCORRECT_CLASS | Classe incorrecte |
INCORRECT_METHOD | Méthode incorrecte |
CHANNEL_NOT_FOUND | Le canal indiqué n'existe pas |
CHAT_NOT_FOUND | Le chat indiqué n'existe pas |
Quelle API pour SQL Server dois-je utiliser ?
Découvrez les avantages et les inconvénients de chacune de nos API. Découvrez quelle API convient le mieux à votre logiciel en SQL Server.
Cette API vous permet de vous connecter à nous depuis SQL Server pour envoyer des requêtes via des requêtes HTTP GET. Cette requête envoie les paramètres dans la même URL que la requête.
- HTTP GET est extrêmement simple à mettre en œuvre
- Les informations sont envoyées non cryptées (les mots de passe peuvent être extraits des journaux ou du cache)
- Requête maximale d'environ 4 000 caractères
L'API de requête POST vous permet de vous connecter à notre API à partir de SQL Server en envoyant des paramètres de requête via des paramètres HTTP POST. Les informations sont envoyées indépendamment de l'URL.
- HTTP POST est simple à mettre en œuvre
- Les informations sont envoyées cryptées
- Il n'y a pas de limite à la taille de la demande
- Sécurité moyenne
L'API d'authentification de base permet l'utilisation de requêtes GET et POST en SQL Server avec une couche de sécurité supplémentaire, puisque dans ce cas le nom d'utilisateur et le mot de passe sont envoyés dans l'en-tête de la requête.
- L'authentification de base est facile à mettre en œuvre
- Les données d'accès sont envoyées cryptées
- La limite de taille dépend de l'utilisation de GET ou POST
- Sécurité moyenne
SOAP vous permet d'envoyer des requêtes au format XML avec SQL Server, SOAP ajoute une couche de sécurité supplémentaire aux requêtes API.
- L'intégration SOAP est plus complexe
- Les informations sont envoyées cryptées
- Il n'y a pas de limite à la taille de la demande
- Moyenne / Haute sécurité
Notre API JSON permet d'envoyer des requêtes au format JSON avec SQL Server, en plus cette API ajoute le protocole oAuth 2.0 dans l'authentification qui permet d'ajouter une couche de sécurité supplémentaire.
- L'intégration JSON oAuth 2.0 est plus complexe
- Les informations sont envoyées cryptées
- Il n'y a pas de limite à la taille de la demande
- Haute sécurité
Connectez SQL Server à notre Chats API
Inscrivez-vous en tant que client
Pour avoir accès à l'API, vous devez être un client Afilnet. L'inscription prendra quelques minutes.
Demander votre essai gratuit
Notre société vous proposera une balance d'essai qui vous permettra de tester avec l'API dont vous avez besoin.
Intégrer l'API
Effectuez l'intégration de l'API en utilisant le langage de programmation de votre choix. Si vous avez des questions ou des suggestions sur l'API, contactez-nous
Bienvenue sur Afilnet!
Tout est prêt!, A réussi à améliorer ses communications avec Afilnet. Nous sommes ici pour prendre en charge notre API lorsque vous en avez besoin
Contactez notre équipe pour toute question via les méthodes de contact que nous proposons. Notre équipe essaiera de vous proposer une solution immédiate et vous aidera dans l'intégration de notre API dans votre logiciel.