Dev DOC WhatsApp - SMSMobileAPI

Esta documentação é específica para enviar uma mensagem do WhatsApp apenas. Também é possível envie uma mensagem do WhatsApp e um SMS simultaneamente.

Na SMSmobileAPI, nos esforçamos para tornar nossa API o mais compatível possível com qualquer arquitetura ou plataforma.
Quer você esteja usando REST, SOAP, cURL ou várias linguagens de programação como Python, JavaScript, PHP e mais, nossa API foi projetada para se integrar perfeitamente aos seus projetos.

Também temos plugins prontos para uso para soluções e software de comércio eletrônico. Clique aqui para descobri-los.

Se você tiver alguma dúvida, sugestão ou precisar de ajuda, nossa equipe está aqui para ajudar.
Sinta-se à vontade para entrar em contato conosco em api@smsmobileapi.com

API REST

cURL

JavaScript

Pitão

Node.js

Rubi

WSDL

Enviar API do WhatsApp

A API do SMSMobile oferece suporte a dois métodos de autenticação: usando uma chave de API simples ou o protocolo OAuth2 com um ID de cliente e um segredo de cliente.

1. Autenticação de chave API para enviar SMS

Este método requer uma API Key que pode ser incluída como um parâmetro em uma solicitação GET ou POST. É uma maneira direta de autenticar suas solicitações de API.

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

Parâmetros:

- apikey: Sua chave de API exclusiva.

- recipients: O número de telefone do destinatário (O número deve estar disponível no WhatsApp). Insira o número de telefone começando com o código do país (sem '+' e sem '00'), seguido diretamente pelo resto do seu número. Exemplo 191728660

- message: A mensagem a ser enviada (várias linhas possíveis).

- waonly: deve ter o valor sim -> Necessário especificar que apenas uma mensagem do WhatsApp deve ser enviada

Exemplo:


        OBTENHA https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEYY&waonly=yes&recipients=191728660&message=HelloWorld

2. Autenticação OAuth2 para enviar SMS

O OAuth2 fornece um método de autenticação mais seguro e escalável.
Você precisará usar um ID de cliente e um segredo de cliente para obter um token de acesso, que deve ser incluído em suas solicitações de API usando o Autorização cabeçalho.

O client_id e o client_secret estão disponíveis no seu painel, acessíveis após instalar o aplicativo e criar uma conta no seu dispositivo móvel.
Baixe o aplicativo móvel agora ou acesse seu painel.

Obtendo um Token de Acesso

Para obter um token de acesso, envie uma solicitação POST ao ponto de extremidade do token com seu ID de cliente e segredo do cliente.


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

Usando o Token de Acesso:

Depois de ter o token de acesso, inclua-o no Autorização cabeçalho das suas solicitações de API:


curl -X POST https://api.smsmobileapi.com/sendsms?waonly=yes \

-H "Autorização: Portador abc123xyz456" \

-H "Tipo de conteúdo: aplicação/x-www-form-urlencoded" \

-d "destinatários=+1234567890" \

-d "mensagem=Olá"

Qual método você deve usar?

- Usar Autenticação de chave API para integrações rápidas e diretas.

- Usar Autenticação OAuth2 para maior segurança e escalabilidade em suas integrações.

Para mais detalhes, consulte a documentação completa.

Enviar mensagem do WhatsApp

URL do WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parâmetros:

- recipients: O número de celular do destinatário.

- message: A mensagem a ser enviada.

- apikey: A chave de API que você tem ou receberá.

- waonly: deve ter o valor sim -> Obrigatório especificar que apenas uma mensagem do WhatsApp deve ser enviada.

Exemplo


                require_once "lib/nusoap.php";

                

                $client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

                $error  = $client->getError();

                

                $result = $client->call("sendSms", array("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

Enviar WhatsApp

Comando básico cURL

Você pode usar o seguinte comando cURL para enviar uma mensagem do WhatsApp via SMSmobileAPI:


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

Exemplo cURL em PHP

Se você estiver usando PHP, veja como enviar uma mensagem do WhatsApp usando cURL:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'


        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

Este exemplo PHP demonstra como enviar uma solicitação POST usando cURL para o SMSmobileAPI, passando os parâmetros necessários como uma matriz associativa.

Enviar WhatsApp

Use nosso módulo Python oficial: https://smsmobileapi.com/python/
ou use o método manual...

Usando a biblioteca `requests`

A biblioteca `requests` é uma biblioteca HTTP popular e simples para Python. Veja como você pode usá-la para enviar uma mensagem do WhatsApp via SMSmobileAPI:


        import requests



        url = "https://api.smsmobileapi.com/sendsms/waonly=yes"



        payload = {

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        }



        response = requests.post(url, data=payload)



        print(response.text)

Este exemplo demonstra uma solicitação POST simples para o SMSmobileAPI, enviando uma mensagem do WhatsApp para um número de telefone específico.

Usando a biblioteca `http.client`

A biblioteca `http.client` está incluída na biblioteca padrão do Python e também pode ser usada para interagir com sua API:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/?waonly=yes", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

Este exemplo mostra como usar a biblioteca `http.client` para enviar uma solicitação POST para a API. Os parâmetros são codificados em URL e enviados com os cabeçalhos apropriados.

Enviar WhatsApp

Usando a API `fetch`

A API `fetch` é uma maneira moderna e versátil de fazer solicitações HTTP em JavaScript. Veja como você pode usá-la para enviar uma mensagem do WhatsApp via SMSmobileAPI:


        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = {

            recipients: "PHONE_NUMBER",

            message: "YOUR_MESSAGE",

            apikey: "YOUR_API_KEY"

        };



        fetch(url, {

            method: "POST",

            headers: {

                "Content-Type": "application/x-www-form-urlencoded"

            },

            body: new URLSearchParams(data)

        })

        .then(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

Este exemplo demonstra como enviar uma solicitação POST usando a API `fetch`, que é suportada na maioria dos navegadores modernos.

Usando `XMLHttpRequest`

Se precisar de suporte a navegadores mais antigos, você pode usar o objeto `XMLHttpRequest`:


        const xhr = new XMLHttpRequest();

        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

Este exemplo mostra como usar `XMLHttpRequest` para enviar uma solicitação POST, fornecendo compatibilidade com navegadores mais antigos que podem não suportar `fetch`.

Enviar WhatsApp

Usando a biblioteca `axios`

A biblioteca `axios` é um cliente HTTP popular para Node.js. Veja como você pode usá-la para enviar uma mensagem do WhatsApp via SMSmobileAPI:


        const axios = require('axios');



        const url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

Este exemplo demonstra como enviar uma solicitação POST usando `axios` no Node.js para interagir com o SMSmobileAPI.

Enviar WhatsApp

Usando a biblioteca `Net::HTTP`

Você pode usar a biblioteca `Net::HTTP` em Ruby para enviar uma mensagem do WhatsApp via SMSmobileAPI:


        require 'net/http'

        require 'uri'



        uri = URI.parse("https://api.smsmobileapi.com/sendsms/?waonly=yes")

        request = Net::HTTP::Post.new(uri)

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

Este exemplo demonstra como enviar uma solicitação POST usando `Net::HTTP` em Ruby para o SMSmobileAPI.