WS - Manual de Integração - Jan-2021 - v3.15 - WS1 PT

Webservices – site 1
Manual de integração
Version 3.15 – Jan 2021
sinch.com
Webservices – site 1. Manual de integração – Version 3.15.
1 Integration guide
Todas as informações disponíveis nesse documento são confidenciais. Esse
documento pode incluir falhas técnicas ou erros tipográficos. A Sinch não é
responsável por quaisquer danos, que possam ser causados pela utilização desse
documento. A Sinch se reserva o direito de alterar esse documento e os sistemas
descritos nele a qualquer tempo e sem aviso prévio.
1.1 Integração Unimessage
Existem várias formas de integração ao sistema Sinch Unimessage, através de

vários meios de comunicação como: Linha telefônica discada, links de dados
dedicados e internet.
O sistema Sinch Unimessage provê comunicação interativa de forma fácil, com

qualidade e alta disponibilidade oferecendo todos os protocolos padrões da indústria
de telecomunicações: TAP, TNPP, SMTP, FTP e, XML (Web Services), além de
grande maleabilidade quando é necessária a comunicação via protocolos
proprietários e customizados. Neste caso, a Sinch oferece todo o suporte
necessário à equipe de desenvolvimento do cliente para uma integração tranquila.
As mensagens são enviadas diretamente para o número do celular de destino, e

todas as mensagens processadas ficam armazenadas e contabilizadas no registro
(ID) do cliente.
1.1.1 Integração Unimessage CAP
A integração com o sistema Sinch Unimessage CAP é feita através de XML “Web
Services”, via internet ou link dedicado.
No endereço https://webservices.twwwireless.com.br/reluzcap/ está a lista de

comandos disponíveis para comunicação com o sistema.
1 Author: Carlos A A Moura – Sinch Copyright © 2021 Sinch. All rights reserved. NDA Confidential.
A visualização dos detalhes, exemplos de métodos GET, POST e, SOAP, além da

possibilidade de execução de testes, pode ser feita através de navegadores MS
Internet Explorer ou Mozilla Firefox.
O WSDL com a descrição dos métodos pode ser baixado através da URL:
https://webservices.twwwireless.com.br/reluzcap/wsreluzcap.asmx?WSDL
• O endereço IP da máquina do cliente, que acessará os webservices deve ser

informado préviamente à Sinch para liberação no firewall.
• O acesso deve ser feito através de login (ID do cliente ) e senha.
• O cadastro deve ser solicitado através do departamento comercial da Sinch.
• O endereço IP da máquina do cliente, que acessará os webservices poderá
ser informado previamente à Sinch para liberação no firewall caso necessite.
1.1.1.1 Endereço de acesso
URL: https://webservices.twwwireless.com.br/reluzcap/
IP: 200.143.186.161 - Porta: 443
Página de Serviços WEB Sinch Unimessage CAP:
1.1.1.2 Available Commands
AlteraSenha - Altera a senha de usuário. A senha pode ter no máximo 18

caracteres. Retorna um boolean indicando o sucesso da operação. Campos
necessários:
NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos,no
sistema Unimessage, fornecido pela Sinch.
SenhaAntiga
SenhaNova
BuscaSMSAgenda - Retorna um DataSet chamado OutDataSet com uma

mensagem agendada com o SEUNUM informado.
Campos necessários:
NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos, no sistema
Unimessage, fornecido pela Sinch.
Senha – Com até 18 caracteres alfanuméricos.
SeuNum – Número ou cadeia de caracteres gerado pelo cliente e informado
no momento da postagem no sistema Unimessage.
Exemplo de dataset de retorno:

<?xml version="1.0" encoding="utf-8" ?>
- <DataSet xmlns="https://www.twwwireless.com.br/reluzcap/wsreluzcap">
- <xs:schema id="OutDataSet" xmlns=""
xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-
microsoft-com:xml-msdata">
- <xs:element name="OutDataSet" msdata:IsDataSet="true"
msdata:UseCurrentLocale="true">
- <xs:complexType>
- <xs:choice minOccurs="0" maxOccurs="unbounded">
- <xs:element name="BuscaSMSAgenda">
- <xs:complexType>
- <xs:sequence>
<xs:element name="seunum" type="xs:string" minOccurs="0" />
<xs:element name="celular" type="xs:string" minOccurs="0" />
<xs:element name="mensagem" type="xs:string" minOccurs="0" />
<xs:element name="status" type="xs:string" minOccurs="0" />
<xs:element name="datarec" type="xs:dateTime" minOccurs="0" />
<xs:element name="dataenv" type="xs:dateTime" minOccurs="0" />
<xs:element name="datastatus" type="xs:dateTime" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
- <diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"
xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
- <OutDataSet xmlns="">
- <BuscaSMSAgenda diffgr:id="BuscaSMSAgenda1" msdata:rowOrder="0">
<seunum>ABC123</seunum>
<celular>551181115323</celular>
<mensagem>Teste agendamento ws</mensagem>
<status>OK</status>
<datarec>2008-10-24T14:55:45.61-02:00</datarec>
<dataenv>2008-10-25T10:00:00-02:00</dataenv>
<datastatus>2008-10-24T14:55:45.61-02:00</datastatus>
</BuscaSMSAgenda>
</OutDataSet>
</diffgr:diffgram>
</DataSet>
*Nota - Após fazer uma consulta, aguardar 1 minuto para fazer uma nova consulta
BuscaSMSAgendaDataSet - Retorna um DataSet chamado OutDataSet contendo

uma Tabela chamada BuscaSMSAgenda com as mensagens agendadas. Retorna
Nothing em caso de erro.
Exemplos do método SOAP na interface web.
NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos, no
*Nota - Após fazer uma consulta, aguardar 1 minuto para fazer uma nova consulta.
BuscaSMSMONaoLido - Retorna um DataSet chamado OutDataSet contendo uma

Tabela chamada SMSMO com no máximo 400 linhas, com as mensagens SMS MO
não lidas, recebidas nos últimos 4 dias como resposta a SMS enviados
anteriormente, e marca esses MOs COMO LIDOS. Se houverem 400 linhas na
tabela, podem haver mais MOs não lidos, e estes devem ser lidos usando
chamadas subsequentes à função. Retorna Nothing em caso de erro.
*Nota - Após fazer uma consulta, aguardar 1 minuto para fazer uma nova consulta.
*Nota – Para realizar a mesma consulta neste método, deve-se primeiro fazer o resete e em seguida aguardar 1
minuto.
BuscaSMSMONaoLidoQuant – Retorna uma estrutura MONLIDOQUANT,

contendo um DataSet DS, chamado OutDataSet, com uma Tabela chamada
SMSMO com o máximo de linhas definido pelo parâmetro de entrada Quant. O valor
de Quant deve ser entre 400 e 2000, sendo ajustado caso especificado fora desse
intervalod. A tabela contém as mensagens SMS MO não lidas, recebidas nos
últimos 4 dias como resposta a SMS enviados anteriormente e marca esses MOs
COMO LIDOS. A estrutura contém, além do DataSet um inteiro QUANTNL que
indica quantos SMS MO NÃO LIDOS ainda existem no banco de dados, depois da
presente execução. Estes MOs devem ser lidos usando chamadas subsequentes à
função. Retorna Nothing em caso de erro.
sistema
Quant – O valor do Quant deve ser entre 400 e 2000, sendo ajustado caso
especificado fora desse intervalo.
DelSMSAgenda - Deleta uma mensagem agendada. Retorna OK ou NOK em casos

de usuário e/ou senha incorretos, pendências financeiras ou campos inválidos e/ou
vazios.
Agendamento - Do tipo DATETIME, que deve ser preenchido no formato
ANSI: “YYYY-MM-DD HH:MM:SS”.
SeuNum - Este campo é um número ou cadeia de caracteres alfanuméricos
com até 10 caracteres que é gerado pelo usuário e, armazenado junto com a
mensagem, para ser utilizado no retorno em pesquisas, sendo que pode ser
utilizado na busca de mensagens individuais. Não é obrigatoriamente seqüencial, e
pode ser repetido.
EnviaSMS - Para envio de mensagens individuais. Os campos necessários para o

envio individual são:
utilizado na busca de mensagens individuais. Não é obrigatoriamente
seqüencial, e pode ser repetido.
Celular – (55DDNNNNNNNN) – Número do celular de destino da mensagem,

onde D = Código de área e N = Número do celular
Mensagem – Texto ASCII com até 160 caracteres
Retornos possíveis:
OK – Mensagem aceita para transmissão
NOK – Usuário e/ou senha incorretos, pendências financeiras ou campos
inválidos e/ou vazios.
Erro
NA (não disponível) – Sistema não disponível
EnviaSMS2SN - Envia uma mensagem para um celular, usando 2 campos de

referência NUMÉRICOS (SeuNum1 e SeuNum2) de no máximo 20 dígitos cada.
Retorna OK, NOK em casos de usuário e/ou senha incorretos, pendências
financeiras ou campos inválidos e/ou vazios, Erro ou NA (não disponível).
SeuNum1 - Este campo é um campo numérico com até 20 posições que é
gerado pelo usuário e, armazenado junto com a mensagem, para ser
utilizado no retorno em pesquisas, sendo que pode ser utilizado na busca de
mensagens individuais. Não é obrigatoriamente seqüencial, e pode ser
repetido.
repetido.
Celular - (55DDNNNNNNNN) – Número do celular de destino da mensagem,
Mensagem – Texto ASCII com até X caracteres
EnviaSMSAge – Envia uma mensagem para um celular com agendamento.

financeiras ou campos inválidos e/ou vazios, Erro ou NA (não disponível)
sequencial, e pode ser repetido.
Mensagem – Texto ASCII com até X caracteres
EnviaSMSAgeQuebra - Envia uma mensagem para um celular com agendamento.

Se essa mensagem for mais longa que 140 caracteres, ela será dividida em várias
mensagens de até 140 caracteres, com "..." separando as mensagens. O tamanho
máximo do texto é de 4096 caracteres. Retorna OK n (n é o número de SMS
enviados pela operação), NOK em casos de usuário e/ou senha incorretos,
pendências financeiras ou campos inválidos e/ou vazios, Erro ou NA (não
disponível).
Mensagem – Texto ASCII. Se for maior do que 140 caracteres a mensagem

será dividida em várias mensagens de até 140 caracteres com "..." incluídos
no fim e no inicio de mensagens subsequentes. O tamanho máximo do texto
é de 4096 caracteres.
ANSI:“YYYY-MM-DD HH:MM:SS”.
EnviaSMSAlt – Envia uma mensagem para um celular utilizando url alternativa.

*Nota – Função descontinuada, favor usar função EnviaSMS
EnviaSMSConcatenadoComAcento - Envia uma mensagem de texto concatenado

com acento para um celular. O campo Serie deve conter um número entre 0 e 255 e
deve ser único para cada SMS concatenado enviado, sendo acrescido de 1 a cada
envio, e quando atinge 255, comece com 0 (zero) novamente. Se essa mensagem
for mais longa que 70 caracteres, ela será dividida em várias mensagens de até 70
caracteres e enviada de forma a chegar concatenada, em uma única mensagem, no
celular de destino, desde que a operadora suporte concatenação. Se não houver
suporte da operadora, a mensagem será enviada separadamente com + separando
as mensagens.
Tamanho máximo da mensagem = 4096 caracteres. Retorna OK n (n é o número de

SMS enviados pela operação), NOK em casos de usuário e/ou senha incorretos,
pendências financeiras ou campos inválidos e/ou vazios, Erro ou NA (não
disponível).
Série - O campo Serie deve conter um número entre 0 e 255 e deve ser
único para cada SMS concatenado enviado, sendo acrescido de 1 a cada
envio, e quando atinge 255, comece com 0 (zero) novamente.
no fim e no início de mensagens subsequentes.
EnviaSMSConcatenadoComAcento2N - Envia uma mensagem de texto

concatenado com acento para um celular com 2 campos de referência. O campo
Serie deve conter um número entre 0 e 255 e deve ser único para cada SMS
concatenado enviado, sendo acrescido de 1 a cada envio, e quando atinge 255,
comece com 0 (zero) novamente. Se essa mensagem for mais longa que 70
caracteres, ela será dividida em várias mensagens de até 70 caracteres e enviada
de forma a chegar concatenada, em uma única mensagem, no celular de destino,
desde que a operadora suporte concatenação. Se não houver suporte da
operadora, a mensagem será enviada separadamente com + separando as
mensagens. Tamanho máximo da mensagem = 4096 caracteres. Retorna OK n (n é
o número de SMS enviados pela operação), NOK (usuário ou senha inválidos,
mensagem maior que 2048 caracteres ou pendências financeiras ou campos
inválidos e/ou vazios), Erro ou NA (não disponível).
SeuNum1 - Este campo é um número ou cadeia de caracteres alfanuméricos

no fim e no início de mensagens subsequentes.
EnviaSMSConcatenadoSemAcento - Envia uma mensagem de texto concatenado

sem acento para um celular. O campo Serie deve conter um número entre 0 e 255 e
deve ser único para cada SMS concatenado enviado, sendo acrescido de 1 a cada
envio, e quando atinge 255, comece com 0 (zero) novamente. Se essa mensagem
for mais longa que 140 caracteres, ela será dividida em várias mensagens de até
140 caracteres e enviada de forma a chegar concatenada, em uma única
mensagem, no celular de destino, desde que a operadora suporte concatenação. Se
não houver suporte da operadora, a mensagem será enviada separadamente com +
separando as mensagens. Tamanho máximo da mensagem = 4096 caracteres.
Retorna OK n (n é o número de SMS enviados pela operação), NOK (usuário ou
senha inválidos, mensagem maior que 4096 caracteres ou pendências financeiras
ou campos inválidos e/ou vazios), Erro ou NA (não disponível).

no fim e no inicio de mensagens subsequentes.
EnviaSMSConcatenadoSemAcento2N - Envia uma mensagem de texto

concatenado sem acento para um celular com 2 campos de referência. O campo
Serie deve conter um número entre 0 e 255 e deve ser único para cada SMS
concatenado enviado, sendo acrescido de 1 a cada envio, e quando atinge 255,
comece com 0 (zero) novamente. Se essa mensagem for mais longa que 140
caracteres, ela será dividida em várias mensagens de até 140 caracteres e enviada
de forma a chegar concatenada, em uma única mensagem, no celular de destino,
desde que a operadora suporte concatenação. Se não houver suporte da
operadora, a mensagem será enviada separadamente com + separando as
mensagens. Tamanho máximo da mensagem = 4096 caracteres. Retorna OK n (n é
o número de SMS enviados pela operação), NOK (usuário ou senha inválidos,
mensagem maior que 4096 caracteres ou pendências financeiras ou campos
inválidos e/ou vazios), Erro ou NA (não disponível).
SeuNum1 - Este campo é um número ou cadeia de caracteres
alfanuméricos com até 20 caracteres que é gerado pelo usuário e,
armazenado junto com a mensagem, para ser utilizado no retorno em
pesquisas, sendo que pode ser utilizado na busca de mensagens individuais.
Não é obrigatoriamente seqüencial, e pode ser repetido.
no fim e no inicio de mensagens subsequentes.
EnviaSMSDataSet - Para envio de mensagens em lote. Recebe um DataSet com

mensagens SMS a serem enviadas, com os seguintes campos:
SeuNum - Este campo é um número ou cadeia de caracteres akfanuméricos
utilizado na busca de mensagens individuais. Não é obrigatóriamente
seqëncial, e pode ser repetido.
Celular (55DDNNNNNNNN) – Número do celular de destino da mensagem,
Mensagem – Texto ASCII com até X caracteres. São aceitos caracteres
ASCII entre ASCII-32 e ASCII-126, os caracteres acetuados serão
substituídos pelos mesmos, sem acento.
ANSI:“YYYY-MM-DD HH:MM:SS”.
Retorna uma string com um dos valores abaixo:

inválidos e/ou vazios
Erro
Exemplos do método SOAP e formato de preenchimento dos campos, na interface

web.

Senha – Com até 18 caracteres alfanuméricos
EnviaSMSESMDCS – Envia uma mensagem para um celular. O campo ESM, DCS

e Header devem estar no formato OTA 8 bit, com um número par de caracteres
hexadecimais. O campo Mensagem deve estar formatado como uma string de texto.
financeiras ou campos inválidos e/ou vazios, Erro ou NA (não disponível).
Senha – Com até 18 caracteres alfanuméricos
ESM - Formato OTA 8 bit, com número par de caracteres hexadecimal
DCS - Formato OTA 8 bit, com número par de caracteres hexadecimal
Header - Formato OTA 8 bit, com número par de caracteres hexadecimal
Mensagem - Texto ASCII. Se for maior do que 140 caracteres a mensagem
EnviaSMSOta8Bit - Envia uma mensagem binária para um celular. Tanto o campo

Header como o Data devem estar no formato OTA 8 bit, com um número par de
caracteres hexadecimais. Retorna OK, NOK em casos de usuário e/ou senha
incorretos, pendências financeiras ou campos inválidos e/ou vazios, Erro ou NA
(não disponível).

Header – Neste campo são passadas as informações de significado do SMS,
como envio para diferentes portas lógicas do celular, quebra de texto longo
em múltiplos SMSs entre outras funções. ( Para maiores detalhes consulte o
documento 3GPP TS 23.040 V6.5.0 (2004-09) ). Se a necessidade é de
somente transportar dados binários, deixar o header em branco.
Data – Conteúdo dos dados binários úteis a serem transmitidos.
Tanto no campo Header como no Data, cada byte a ser transmitido deve ser
transformado em 2 caracteres representando o código hexadecimal do byte.
De 00 à FF.
Como cada byte se transforma em 2 caracteres, o texto do campo Header mais o

campo Data não podem ser maiores que 280 caracteres.
EnviaSMSQuebra - Envia uma mensagem de texto para um celular. Se essa

mensagem for mais longa que 140 caracteres, ela será dividida em várias
mensagens de até 140 caracteres, com ... separando as mensagens. Tamanho
máximo da mensagem = 4096 caracteres. Retorna OK n (n é o número de SMS
enviados pela operação), NOK (usuário ou senha inválidos, mensagem maior que
4096 caracteres ou pendências financeiras ou campos inválidos e/ou vazios), Erro
ou NA (não disponível).
NumUsu – Login ( ID ), com até 10 caracteres alfanuméricos, no sistema

EnviaSMSTIM - Recebe uma String com um XML no mesmo formato usado para
enviar SMS a operadora TIMSUL, para facilitar a integração com sistemas já
desenvolvidos.
EnviaSMSTemplate - O uso dessa função é somente para clientes que utilizam a

feature de templates do WebCorp. Por favor refira-se a documentação pertinente do
WebCorp.
EnviaSMSXML - Recebe um XML com mensagens SMS a serem enviadas, com os

seguintes campos:
Mensagem – Texto ASCII com até X caracteres. São aceitos caracteres
ASCII entre ASCII-32 e ASCII-126, os caracteres acetuados serão
substituídos pelos mesmos, sem acento.
Retorna uma string com um dos valores abaixo:

inválidos e/ou vazios
Erro
InsBL - Insere um número de celular na black list. Retorna 1 em caso de sucesso, 0

caso o celular já esteja na black list, -1 em caso de erro.
ResetaMOLido - Reseta o status de LIDO dos SMS MO desde 1 dia atrás até o
momento atual. Retorna OK ou NOK em casos de usuário e/ou senha incorretos,
pendências financeiras ou campos inválidos e/ou vazios.
ResetaStatusLido - Reseta o status de LIDO dos SMS MO desde 1 dia atrás até o
momento atual. Retorna OK ou NOK em casos de usuário e/ou senha incorretos,
pendências financeiras ou campos inválidos e/ou vazios.
StatusSMS2SN - Retorna um DataSet chamado OutDataSet contendo a tabela

StatusSMS com o status de uma mensagem SMS já transmitida através do método
EnviaSMS2SN, que utiliza dois identificadores. Retorna Nothing em caso de erro.

repetido.
repetido.
StatusSMSDataset - Recebe um DataSet com os campos: SeuNum, e retorna um

DataSet chamado OutDataSet contendo a tabela StatusSMSDS com várias
mensagens já transmitidas. Retorna Nothing em caso de erro.
Exemplos do método SOAP na interface web. Campos necessários:
StatusSMSNaoLido - Retorna um DataSet chamado OutDataSet contendo a tabela

StatusSMS com no máximo 400 linhas, contendo somente os status de SMS dos
últimos 4 dias que ainda não tenham sido lidos, e os MARCA COMO LIDOS. Se
houverem 400 linhas na tabela, podem haver mais status não lidos, e estes devem
ser lidos usando chamadas subsequentes à esta função. Retorna Nothing em caso
de erro.

*Nota – Para realizar a mesma consulta neste método, deve-se primeiro fazer o resete e em seguida aguardar 1
minuto.
VerBL - Retorna um DataSet com os celulares incluidos na black list. Retorna

Nothing em caso de erro.
VerCredito - Verifica os créditos de um Usuário Pré-Pago. Utiliza os seguintes

campos:
Senha – Com até 18 caracteres alfanuméricos.Retorna o número de créditos
ou -1 se o Usuário não for do tipo Pré-Pago ou -2 em caso de erro nos
parâmetros
VerValidade - Retorna a data de validade dos créditos de um Usuário Pré-Pago.

Retorna NOTHING se o Usuário não for do tipo Pré-Pago ou caso haja erro nos
parâmetros.
1.1.1.3 Integração para retorno automático Unimessage
Além da comunicação através de webservices, onde é possível efetuar todas as

transações de envio de mensagens e consultas de status e relatórios, é possível
também automatizar a atualização de status e recebimento de Mos, através dos
métodos HTTPS GET, HTTPS POST e, SMTP.
Nesse caso, assim que acontece a atualização do status para uma mensagem
enviada pelo cliente, o sistema Unimessage o envia para uma URL pré
estabelecida, através do método GET ou POST, ou através de SMTP para um
endereço de email pré cadastrado.
O mesmo acontece para o recebimento de mensagens de resposta ( Mos ) a

mensangens enviadas pelo cliente através dos UNIMESSAGE Web Services.
Para os MOs o caminho de retorno permanece ativo durante um período de 7 dias.
Após esse período, as mensagens de resposta são descartadas. O servidor deve
ser configurado para receber os eventos onde serão passados os parâmetros
necessários. O formato da URL, para o método GET, deve conter, a URL do cliente
seguido pelos parâmetros:
Parâmetros para URL de STATUS:

SeuNum - %u (número do cliente)
Celular - %c (Celular)
Status - %s (2 letras, como CL)
TextoStatus - %t (descrição do status, veja abaixo*)
Data do status - %d (aaaa-mm-ddThh:mm:ss)
Operadora - %o (nosso código numérico, 1 - Claro, 2 - TIM, 3 - Vivo, etc.)
Exemplo de URL de Status (ST):

URL Parameters
www.urldocliente.com.br/?SeuNum=%u&Celular=%c&status=%s&TxtStatus=%t&Da
ta=%d&Operadora=%o
Descrição de Status
Caso "CL"
textoStatus = "SMS entregue ao celular de destino"
Caso "E0"
TextoStatus = "Numero de celular invalido/sem operadora"
Caso "E1"
textoStatus = "Blacklist" (Celular na blacklist)
Caso "E3"
textoStatus = "Duplicada" (Mensagem rejeitada devido a excessivas repetições)
Caso "E4"
textoStatus = "SMS recusado pela operadora"
Caso "E6"
textoStatus = "SMS expirado conforme informe da operadora"
Caso "E7"
textoStatus = "SMS rejeitado por falta de créditos ou conta bloqueada"
Caso "DP"
textoStatus = "SMS com conteúdo de fraude”
Parâmetros disponíveis para URL MO:

Operadora - %o – (Operadora código numérico, 1 – Claro, 2 – TIM, 3 – Vivo,
etc.)
Menesagem - %m – (Texto do SMS MO)
Celular - %c – (Número do celular originador do SMS MO)
Shnum - %s – (Short number de destino do SMS MO)
SeuNum - %u – (Número identificador da mensagem MT gerado pelo cliente,
ao qual esse SMS MO responde)
Data - %d – (Data do SMS MO)
URL MO example:
URL Parameters
www.urldocliente.com.br/?Operadora=%o&Mensagem=%m&Celular=%c&Shnum=%
s&SeuNum=%u&Data=%d
Tabela de Status de mensagens

Status de SMS:
OK: mensagem recebida, na fila para envio à operadora OP: mensagem enviada à
operadora
CL: Celular confirmou o recebimento
E0: Celular não pertence a nenhuma operadora E1: mensagem rejeitada, celular no
blacklist
E3: mensagem rejeitada devido a excessivas repetições
E4: mensagem rejeitada pela operadora antes de transmitir. (Número cancelado ou

com restrições)
E6: mensagem expirada conforme informação da operadora (expirada após
sequência de tentativas)
E7: mensagem rejeitada por falta de crédito.
DP: mensagem com conteúdo de fraude.
Quanto ao campo OP, corresponde à operadora de celular:

0 - Nenhuma operadora (mensagem sem número de celular ou com número
incorreto)
1: Claro
2: TIM
3: Vivo
5: Oi
6: Nextel
8: Sercomtel
9: CTBC
10: Porto Conecta 11 – Vodafone
12: Surf Telecom
13: Gospel iCel
14: Maga+
15: AmericaNet
16: Cinco
257: Outras
OBS: Os status podem ser alterados em até 48 horas após a postagem nos
sistemas das operadoras.
--------------------------------------------------------------------------------------------------------------
Para maiores informações, comandos não descritos e solucionar quaisquer dúvidas
por favor entre em contato com:
+55 (11) 3444 5000 (atendimento – horário comercial)
relacionamento@sinch.com (atendimento – horário comercial)

WS - Manual de Integração - Jan-2021 - v3.15 - WS1 PT

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

WS - Manual de Integração - Jan-2021 - v3.15 - WS1 PT

Enviado por

Direitos autorais:

Formatos disponíveis

Webservices – site 1

1.1 Integração Unimessage

Existem várias formas de integração ao sistema Sinch Unimessage, através de

O sistema Sinch Unimessage provê comunicação interativa de forma fácil, com

As mensagens são enviadas diretamente para o número do celular de destino, e

1.1.1 Integração Unimessage CAP

No endereço https://webservices.twwwireless.com.br/reluzcap/ está a lista de

A visualização dos detalhes, exemplos de métodos GET, POST e, SOAP, além da

• O endereço IP da máquina do cliente, que acessará os webservices deve ser

1.1.1.1 Endereço de acesso

1.1.1.2 Available Commands

AlteraSenha - Altera a senha de usuário. A senha pode ter no máximo 18

BuscaSMSAgenda - Retorna um DataSet chamado OutDataSet com uma

Exemplo de dataset de retorno:

<xs:element name="celular" type="xs:string" minOccurs="0" />

<xs:element name="mensagem" type="xs:string" minOccurs="0" />

<xs:element name="status" type="xs:string" minOccurs="0" />

<xs:element name="datarec" type="xs:dateTime" minOccurs="0" />

<xs:element name="dataenv" type="xs:dateTime" minOccurs="0" />

<xs:element name="datastatus" type="xs:dateTime" minOccurs="0" />

<mensagem>Teste agendamento ws</mensagem>

BuscaSMSAgendaDataSet - Retorna um DataSet chamado OutDataSet contendo

BuscaSMSMONaoLido - Retorna um DataSet chamado OutDataSet contendo uma

BuscaSMSMONaoLidoQuant – Retorna uma estrutura MONLIDOQUANT,

DelSMSAgenda - Deleta uma mensagem agendada. Retorna OK ou NOK em casos

EnviaSMS - Para envio de mensagens individuais. Os campos necessários para o

Celular – (55DDNNNNNNNN) – Número do celular de destino da mensagem,

EnviaSMS2SN - Envia uma mensagem para um celular, usando 2 campos de

EnviaSMSAge – Envia uma mensagem para um celular com agendamento.

EnviaSMSAgeQuebra - Envia uma mensagem para um celular com agendamento.

Mensagem – Texto ASCII. Se for maior do que 140 caracteres a mensagem

EnviaSMSAlt – Envia uma mensagem para um celular utilizando url alternativa.

EnviaSMSConcatenadoComAcento - Envia uma mensagem de texto concatenado

Tamanho máximo da mensagem = 4096 caracteres. Retorna OK n (n é o número de

EnviaSMSConcatenadoComAcento2N - Envia uma mensagem de texto

utilizado na busca de mensagens individuais. Não é obrigatoriamente

EnviaSMSConcatenadoSemAcento - Envia uma mensagem de texto concatenado

Celular - (55DDNNNNNNNN) – Número do celular de destino da mensagem,

EnviaSMSConcatenadoSemAcento2N - Envia uma mensagem de texto

EnviaSMSDataSet - Para envio de mensagens em lote. Recebe um DataSet com

Retorna uma string com um dos valores abaixo:

Exemplos do método SOAP e formato de preenchimento dos campos, na interface

NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos, no

EnviaSMSESMDCS – Envia uma mensagem para um celular. O campo ESM, DCS

EnviaSMSOta8Bit - Envia uma mensagem binária para um celular. Tanto o campo

NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos, no sistema

Como cada byte se transforma em 2 caracteres, o texto do campo Header mais o

EnviaSMSQuebra - Envia uma mensagem de texto para um celular. Se essa

SeuNum - Este campo é um número ou cadeia de caracteres alfanuméricos

EnviaSMSTemplate - O uso dessa função é somente para clientes que utilizam a

EnviaSMSXML - Recebe um XML com mensagens SMS a serem enviadas, com os

Retorna uma string com um dos valores abaixo:

InsBL - Insere um número de celular na black list. Retorna 1 em caso de sucesso, 0

StatusSMS2SN - Retorna um DataSet chamado OutDataSet contendo a tabela

NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos, no sistema

StatusSMSDataset - Recebe um DataSet com os campos: SeuNum, e retorna um

StatusSMSNaoLido - Retorna um DataSet chamado OutDataSet contendo a tabela

NumUsu – Login ( ID ), com até 10 caracteres alfa-numéricos, no sistema

VerBL - Retorna um DataSet com os celulares incluidos na black list. Retorna

VerCredito - Verifica os créditos de um Usuário Pré-Pago. Utiliza os seguintes

VerValidade - Retorna a data de validade dos créditos de um Usuário Pré-Pago.

1.1.1.3 Integração para retorno automático Unimessage

Além da comunicação através de webservices, onde é possível efetuar todas as