Como podemos ajudar?

03. SMS - Integração e Endereços de Rede (URL)
8 min
Criado por Humanz em 31/05/2022 19:19
Atualizado por Ligia Sarmento em 16/08/2023 13:44

O que é integração?

Integração é o meio onde o cliente utiliza do seu sistema interno autenticado com o serviço da Zenvia para disparos de mensagens. 

O que é Endereços de Rede(URL)?

São links que a Zenvia disponibiliza para possibilitar a conexão com o serviço. 

O que é autenticação?

É o conceito de validação dos dados de conta e senha para utilizar o serviço.

É possível usar meu próprio sistema para enviar SMS?

Sim. Qualquer sistema que realize chamadas HTTP/HTTPS ou Web Services está habilitado para se integrar à nossa plataforma. É necessário apenas que haja uma conta autenticada com uma senha, para que a configuração seja estabelecida e os disparos realizados.

Onde estão postados os manuais de integração?

Os manuais de integração REST e SOAP estão localizados no site http://docs.zenviasms.apiary.io/. Já o manual de integração 1.0 (HTTP) está contido no endereço http://desenvolvedores.zenvia.com/sms/documentacao/documentos-antigos/apilegada-1-0/envio-de-sms-unico-http-webservice/

Quais as URL's de envio?

As bibliotecas estão disponíveis em que local?

As bibliotecas relacionadas à API 2.0 (PHP, JS e JAVA) estão no localizadas no link https://zenviasms.docs.apiary.io/#reference/bibliotecas. As de API 1.0 podem ser acessadas por outro endereço http://desenvolvedores.zenvia.com/sms/documentacao/documentosantigos/api-legada-1-0/guias-integracao-api-legada-1-0/

A Zenvia disponibiliza um ambiente para teste?

Sim, você consegue testar com sua conta e senha de integração no próprio site da documentação: https://zenviasms.docs.apiary.io/#reference/servicos-da-api/envio-de-umunico-sms/testar-envio-de-um-unico-sms. Acesse Serviõs da API > Testar envio de um único SMS > Switch to Console > Complemente os Headers > Acesse e edite o Body > Call Resource. 

Onde são localizados os códigos de erros da API?

A tabela de statusCode e detailCode estão localizadas no site da documentação: https://zenviasms.docs.apiary.io/#introduction/tabela-de-status.

Quais são os headers (cabeçalhos) que preciso estabelecer na REST?

Todas as requisições devem incluir, além do cabeçalho de autenticação, os seguintes headers: Content-Type:application/json e Accept:application/json. 

Como estruturar uma chamada HTTP simples?

A estrutura para uma chamada HTTP deve seguir o padrão à seguir. Importante salientar que o cliente deve alterar as informações de ""X"" para os dados de sua conta e informações do envio: https://apihttp.zenvia.com/GatewayIntegration/msgSms.do?dispatch=send&account=XXXXXXXX&code=X XXXXXXX&to=XXXXXXXX&msg=teste". 

É possível enviar mensagem com acento?

Aconselhamos os cliente a não dispararem mensagens com acento pelo motivo de que muitos aparelhos não conseguem fazer a leitura dos caracteres de forma correta e acaba desconfigurando a mensagem na tela do celular. Visto também que muitas operadoras não processam corretamente esse conteúdo e acabam inserindo espaços, pontos de interrogações, acentos incorretos no lugar do caractere que deveria vir correto. 

Como eu troco minha senha de integração?

A senha de integração é alterada apenas pela equipe de Atendimento. Entre em contato através do atendimento.zenvia.com e solicite tal ação. Você pode solicitar a senha ou ela será gerada randomicamente pelo analista responsável.

O que é aggregateId? Onde configurar? Onde consultar?

O aggregateId é sinônimo de Agrupador dentro do ambiente da Zenvia. São marcadores que permitem que os envios realizados sejam identificados. A configuração do mesmo é realizada apenas pelo time de Atendimento por solicitação do cliente. Podem ser consultados através do gerenciador web pelo administrador da conta na aba Administração > Gerenciar Agrupador.

Como autenticar conta e senha na REST?

A autenticação é realizada através do Base64. É necessário concatenar a conta e senha de integração ligando-as por um dois pontos (:), para gerar um código e inserir no cabeçalho (header) da requisição. Você consegue verificar o processo no site da documentação: https://zenviasms.docs.apiary.io/#introduction/autenticacao.

Envio concatenado (long message) funciona por integração?

Sim. Para envio de mensagens longas é necessário entrar em contato com nossa equipe de Atendimento e solicitar que sua conta seja habilitada para esse tipo de envio.

A senha de integração é a mesma da web?

Você deve utilizar a senha destinada à integração recebida no e-mail (ela pode estar como "code" também). Caso não tenha recebido, por favor entrar em contato com o nosso time de Atendimento que poderão lhe reenviar as informações.

Qual limite de conexão simultânea por IP?

A Zenvia restringe em 100 conexões simultaneas por IP.

Quais IP's devem ser liberados para conexão segura?

É importante revisar as políticas de segurança de sua empresa, pois essas devem estar liberadas para a comunicação com os seguintes endereçamentos IP da Zenvia. IPv4: 201.150.94.192/27,200.203.125.24/29,200.203.125.64/28,45.233.20.0/22 e IPv6: 2804:4b80::/32. 
É bloqueado temporariamente para análise do conteúdo. No momento da verificação, o status da mensagem se estabelece como "Bloqueado - Em análise". Depois de alguns minutos de verificação automática o SMS é enviado para a Operadora entregar a mensagem. Caso o conteúdo não passe pela validação interna devido aos motivos de conteúdo, ele é bloqueado.

Há a possibilidade de enviar SMS de forma automática, após um retorno do meu cliente?

Sim. O único modo de você obter este tipo de recurso é desenvolvendo a aplicação interna do seu próprio sistema. A resposta deste cliente ao SMS irá ser absorvida pela sua URL de Callback (caso tenha configurado na conta) e o retorno deverá ser programado e desenvolvido do lado do cliente, realizando uma nova chamada para a nossa API, iniciando novamente um outro envio.

O que é callback?

É o termo dado à uma funcionalidade que a Zenvia permite que o cliente receba as informações de Status e Respostas em sua aplicação interna através de uma URL.

Como desenvolvo uma URL de Callback?

Onde cadastro ou edito a URL de Callback?

Você sempre deverá entrar em contato com o Atendimento da Zenvia via e-mail. Não há a possibilidade de inserir ou editar a informação em alguma página web, visto que a inserção é realizada diretamente no ambiente interno da Zenvia.
 
Este artigo resolveu sua dúvida?
Últimos artigos visitados