Primeiros passos

api-zenvia1

 

Nossa API possui todas as funções necessárias para que você:

  • Envie SMS a partir de seu sistema
  • Receba SMS de seus contatos diretamente em seu sistema
  • Gerencie, controle e analise a comunicação realizada por SMS

 

Exemplo de um cenário de integração

exemplo-cenario-integracao1

Em seu sistema de agenda, você marca um compromisso com seu cliente e configura o campo “Lembrete por SMS”.

Um dia antes do compromisso, seu sistema identifica o cliente e envia a ele um SMS por meio da integração com a Zenvia.

Seu cliente responde por SMS “Sim, estarei presente”, essa resposta é enviada pela Zenvia ao seu sistema e você pode visualizar toda a conversa com aquele cliente.

Funcionalidades para diferentes necessidades

  1. Envio de SMS Seu sistema pode enviar SMS individualmente (um a um) ou em lotes (vários SMS em uma única chamada). Se desejar, pode também cancelar um envio agendado.
  2. Recebimento de SMS Nossa plataforma pode receber SMS de seus contatos. Após o recebimento, você pode consultar a lista de SMS recebidos ou então podemos encaminhar cada mensagem automaticamente para o seu sistema.
  3. Status de SMS Para cada SMS enviado, é possível consultar o status de entrega, ou então receber automaticamente no sistema uma chamada com a identificação do SMS e seu status de envio.
  4. Recebimento de informações A Zenvia pode enviar ao seu sistema informações de status e também SMS recebidos de seus contatos. Para isso, utilizamos chamadas HTTP GET a uma URL de sua escolha.

 

O que é preciso na prática?

Implementar os módulos para integração é muito simples, e ainda fornecemos uma documentação detalhada e tutoriais e bibliotecas completas.
> Como enviar SMS do seu sistema?   > Como receber SMS em seu sistema?

 

Formatos de integração

Existem diversas formas pelas quais você pode integrar seu sistema à plataforma da Zenvia:

Formato Descrição
HTTP A forma mais simples e completa para integrar os sistemas. Você configura chamadas HTTP(S) a uma URL da Zenvia e envia os parâmetros por GET ou POST.
WebServices Ideal para quem quer enviar SMS utilizando requisições SOAP/XML, padrões universais de integração.
Email Ideal para quem está acostumado com a simplicidade do email: seu sistema envia um email para um endereço da Zenvia e este email é convertido para um ou mais SMS.
FTP Para quem está acostumado a trabalhar com o intercâmbio de arquivos entre sistemas. Basta carregar um arquivo em uma pasta de FTP e o resto é conosco!
SMPP É ideal para quem já esta acostumado a utilizar este protocolo e precisa enviar diariamente grandes volumes de SMS de forma contínua.
  • Thiago Juliano

    existe alguma API REST passando jSon?

  • Dener Rodrigues

    Olá, gostaria de saber se vocês possuem alguma documentação da Integração via HTTP na linguagem Python.

    • Olá, Dener.

      Tudo bem?

      Vamos lhe enviar a documentação em questão por e-mail.
      Dentro de instantes você estará recebendo a mesma.

      Um abraço.

      • Dener Rodrigues

        Olá! Vocês tentaram enviar para qual e-mail?
        Ainda não recebi a documentação.

        Obrigado!

  • Olá, Jadson.

    Tudo bem?

    Estamos lhe enviando a documentação solicitada por e-mail.
    Dentro de instantes estará recebendo a mesma.

    Um abraço.

  • Gerson Mollo

    Bom dia, estou tentando fazer a integração com o PHP usando o método SOAP,Vocês teriam algum exemplo para me passar?

    • Boa tarde Gerson
      Entre em contato com nossa área de Atendimento através do e-mail atendimento@zenvia.com, para que possamos abrir um chamado e providenciar o envio das informações.
      Obrigado.

  • Eduardo Ribeiro

    Bom dia. Quero fazer a integração utilizando java, porém não vi exemplos práticos, teria como disponibilizar?

    • Olá, Eduardo.

      Tudo bem?

      Vamos lhe enviar por e-mail a biblioteca solicitada.
      Dentro de instantes você estará recebendo a mesma.

      Um abraço.

  • Gustavo Azevedo

    Boa noite.
    Estou precisando de enviar mensagens a partir de uma aplicação vba em excel.
    Vocês poderiam me auxiliar neste objetivo com documentação e exemplos.
    Att. Gustavo.

    • Olá, Gustavo.

      Tudo bem?

      Vamos enviar para seu e-mail a biblioteca solicitada.

      Um abraço.

  • Luiz Taborda Bukowski

    Olá, enviei o email ontem e ainda nada dos códigos de exemplo, “demora” assim mesmo?

    • Olá, Luiz.

      Tudo bem?

      Você chegou a verificar se o e-mail não ficou retido na caixa “spam” ou “lixeira”?
      Podemos lhe enviar a documentação novamente, para o mesmo e-mail? ( emaildotaborda@gmail.com )

      Um abraço.

  • Olá, Eduardo.

    Tudo bem?

    Possivelmente o e-mail foi bloqueado pelo Gmail, pois a biblioteca vai em anexo, na extensão .rar
    Você possui outro e-mail de contato?

    Um abraço.

    • Eduardo Ribeiro

      Não. Só possuo este. Não tem um local onde eu possa efetuar o download desta? E aproveitando, terei mais um projeto para utilização só que em php, gostaria do mesmo suporte. Aguardando com urgencia seu retorno.

      • Olá, Eduardo.

        Tudo bem?

        Compartilhei com você um link do Google Drive, com as duas bibliotecas.

        Um abraço.

  • Olá, Bruno.

    Tudo bem?

    Para integrar o seu sistema com a nossa plataforma, é necessário seu software conseguir realizar uma chamada http, e após nos passar os parâmetros de envios através de um pacote JSON.

    Um abraço.

  • Olá, Luiz.

    Tudo bem?

    Possivelmente o Gmail bloqueou o recebimento do e-mail, pois a biblioteca vai na extensão .rar
    Você possui outro e-mail de contato?
    Assim posso lhe enviar a biblioteca sem problemas.

    Um abraço.

    • Luiz Taborda Bukowski

      Favor enviar para nicolas@tracknme.com.br, ou me envie um link para baixar.

      • Olá, Luiz.

        Tudo bem?

        Acabamos de lhe enviar a biblioteca para o e-mail solicitado.

        Um abraço.

  • Olá, Edy.

    Tudo bem?

    Vamos lhe enviar uma biblioteca na linguagem em questão, para você verificar e implementar essa solução.
    Dentro de instantes estará recebo a biblioteca por e-mail.

    Um abraço.

  • Olá, Fabricio.

    Tudo bem?

    Encaminhei sua solicitação para nossa área comercial entrar em contato com você.
    Dentro de instantes você será acionado.

    Um abraço.

  • Olá, Jorge.

    Tudo bem?

    Vamos lhe enviar a documentação solicitada por e-mail.
    Dentro de instantes estará recebendo a mesma.

    Um abraço.

  • Theodoro

    Boa tarde

    Tentamos entrar em contato por email há alguns dias com algumas dúvidas mas ainda não obtivemos resposta (e o atendimento pelo 0800 também está indisponível), qual a estimativa de prazo para atendimento?

    Alternativamente deixo as perguntas aqui:
    1. Quais as credenciais que devem ser usadas na API Rest? O login Zenvia é composto por 3 partes – conta, email e senha – e nenhuma combinação desses 3 funcionou, de acordo com nossa equipe de desenvolvimento. A documentação só diz para usarmos conta e senha.
    2. Onde faríamos uma possível configuração dos callbacks? O Gerenciador Web não faz nenhuma menção a isso.

    • Bom dia Theodoro,
      Perdão pela demora no retorno. Seguem respostas à suas dúvidas:

      1. Na integração, você irá autenticar as chamadas à API da Zenvia através da conta e da senha da conta. No caso de integração via protocolo REST, estes dados precisam ser encapsulados em base64 e repassados na chamada no parâmetro Authentication.

      2. Se você deseja utilizar uma URL para que o serviço da Zenvia deposite so callbacks de status e de retorno, você pode nos passar para que possamos vinculá-la à conta que fará os envios.

      Reocmendo que abra conosco um chamado através do endereço atendimento @zenvia.com, demonstrando sua necessidade para que nossa equipe de Atendimento possa retornar.

      Obrigado.

  • Boa tarde Jorge,

    Segue o link para a documentação da API: docs.zenviasms.apiary.io/#

  • Plinio Almeida

    Boa tarde,

    Baixei na internet um exemplo em Delphi. Só que no exemplo utiliza a Indy 9 que é muito antiga. Estou desenvolvendo a integração no Delphi Seattle, só que utilizando o exemplo de vocês ele retorna a mensagem “Unknown Protocol”. Voces tem algum exemplo de como enviar SMS simples (unico) em Delphi ?

    • Olá Plinio, tudo bem?

      Enviei para o seu e-mail, através do chamado, a biblioteca de exemplo da linguagem solicitada.

      Qualquer dúvida estamos à disposição.

      • Plinio Almeida

        Boa tarde,

        Recebi os arquivos e efetuei os testes de acordo com a documentação fornecida.
        Deu tudo certo. Muito obrigado.

        • Olá, Plinio.

          Tudo bem?

          Ficamos a disposição para futuras dúvidas ou solicitações.
          Nossos canais de atendimento são:

          0800 6464 777
          atendimento@zenvia.com

          Um abraço.