API Web Chat para SQL Server
Gerencie o sistema de bate-papo da API. Acesse ou responda a conversas de nossa API.
Obtenha uma lista de canais de chat ativos com 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
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=chat | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getchatchannels | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- platform
- name
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
Envie uma mensagem por bate-papo com 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
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=chat | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=sendmessage | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platform | Plataforma para a qual a mensagem é enviada. Valores possíveis: 'webchat', 'whatsapp', 'telegram', 'operator' | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário para onde a mensagem de bate-papo é enviada | Mandatório |
message | Mensagem para enviar via chat | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
Envie um arquivo por bate-papo com 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
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=chat | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=sendfile | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platform | Plataforma para a qual a mensagem é enviada. Valores possíveis: 'webchat', 'whatsapp', 'telegram', 'operator' | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário para onde o arquivo é enviado | Mandatório |
type | Tipo de arquivo sendo enviado. Valores possíveis: 'imagem', 'vídeo', 'áudio', 'voz', 'documento', 'contato' | Mandatório |
fileurl | Url onde se encontra o arquivo a ser enviado por chat | Mandatório |
thumburl | Url da imagem em miniatura que acompanha o arquivo | Opcional |
message | Mensagem que acompanha o arquivo | Opcional |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
INCORRECT_FILETYPE | O tipo de arquivo está errado, verifique os valores possíveis |
INCORRECT_FILEURL | O url do arquivo não é válido |
INCORRECT_THUMBURL | O url da miniatura é inválido |
Obtenha uma lista de conversas em um bate-papo com 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
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=chat | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getchats | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platform | Plataforma para a qual a mensagem é enviada. Valores possíveis: 'webchat', 'whatsapp', 'telegram', 'operator' | Mandatório |
platformid | Identificador de plataforma | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- platform
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
Obtenha uma lista de mensagens de um bate-papo com 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
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=chat | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getmessages | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platform | Plataforma para a qual a mensagem é enviada. Valores possíveis: 'webchat', 'whatsapp', 'telegram', 'operator' | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário do qual você deseja obter as mensagens | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- platform
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
Obtenha uma lista de mensagens não lidas de um bate-papo com 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
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=chat | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getunreadmessages | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platform | Plataforma para a qual a mensagem é enviada. Valores possíveis: 'webchat', 'whatsapp', 'telegram', 'operator' | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário do qual você deseja obter as mensagens | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- platform
- message
- destination
- messageid
- issent
- status
- datetime
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
Qual API para SQL Server devo usar?
Descubra as vantagens e desvantagens de cada uma das nossas APIs. Descubra qual API é melhor para o seu Software em SQL Server.
Essa API permite que você se conecte a nós de SQL Server para enviar solicitações por meio de solicitações HTTP GET. Essa solicitação envia os parâmetros na mesma URL da solicitação.
- HTTP GET é extremamente simples de implementar
- As informações são enviadas sem criptografia (as senhas podem ser extraídas de logs ou cache)
- Solicitação máxima de aproximadamente 4.000 caracteres
A API de solicitação POST permite que você se conecte à nossa API de SQL Server enviando parâmetros de solicitação por meio de parâmetros HTTP POST. As informações são enviadas independentemente da URL.
- HTTP POST é simples de implementar
- As informações são enviadas criptografadas
- Não há limite para o tamanho da solicitação
- Segurança média
A API de autenticação básica permite o uso de solicitações GET e POST em SQL Server com uma camada de segurança adicional, pois neste caso o nome de usuário e a senha são enviados no cabeçalho da solicitação.
- A autenticação básica é fácil de implementar
- Os dados de acesso são enviados criptografados
- O limite de tamanho depende do uso de GET ou POST
- Segurança média
SOAP permite enviar solicitações em formato XML com SQL Server, SOAP adiciona uma camada extra de segurança às solicitações de API.
- A integração SOAP é mais complexa
- As informações são enviadas criptografadas
- Não há limite para o tamanho da solicitação
- Segurança média/alta
Nossa API JSON permite enviar solicitações em formato JSON com SQL Server, além disso, essa API adiciona o protocolo oAuth 2.0 na autenticação que permite adicionar uma camada adicional de segurança.
- A integração JSON oAuth 2.0 é mais complexa
- As informações são enviadas criptografadas
- Não há limite para o tamanho da solicitação
- Alta seguranca
Conecte SQL Server com nossa API Bate-papos
Registre-se como um cliente
Para ter acesso à API você deve ser um cliente Afilnet. O registro levará alguns minutos.
Solicite sua avaliação gratuita
Nossa empresa lhe oferecerá um balancete que lhe permitirá testar com a API que você precisa.
Integrar a API
Realize a integração da API usando a linguagem de programação de sua escolha. Se você tiver dúvidas ou sugestões sobre a API, entre em contato conosco
Bem vindo ao Afilnet!
Tudo pronto!, conseguiu melhorar as suas comunicações com a Afilnet. Estamos aqui para dar suporte à nossa API quando você precisar
Em caso de dúvidas, entre em contato com nossa equipe através dos meios de contato que oferecemos. Nossa equipe tentará lhe oferecer uma solução imediata e lhe ajudará na integração de nossa API em seu Software.