Dev DOC WhatsApp - SMSMobileAPI

Documentação do WhatsApp

Esta documentação é específica para enviar e receber mensagens do WhatsApp.

Clique aqui para saber mais sobre todos os recursos que nossa integração com o WhatsApp oferece.

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.

API REST

cURL

JavaScript

Pitão

Node.js

Rubi

WSDL

Autenticação

CHAVE API
OAuth2

Enviar API do WhatsApp

Este ponto de extremidade da API é usado para enviar mensagens do WhatsApp.

Ponto final:

GET POST https://api.smsmobileapi.com/sendsms

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).

- url_media: A URL direta do arquivo de mídia que você deseja enviar via WhatsApp. Deve começar com https:// e apontar para um válido PDF, doutor ou imagem arquivo. O arquivo deve ser acessível publicamente sem autenticação.
Suportado: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
jpg, jpeg, png, gif, bmp, tiff, svg, webp, ico, heic, jfif

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

Exemplo sem mídia:


        GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World

Exemplo com mídia:


        GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World&url_media=https://smsmobileapi.com/logo.png

Formatar texto no WhatsApp:

Itálico: Use sublinhados → _texto_
Audacioso: Use asteriscos → *texto*
Tachado: Use til → ~texto~
Monoespaço: Use acentos graves → ```texto```

Por exemplo: _Olá_ mundo, Como *vai* você ~hoje~ do ```SMSMobileAPI```

Reenviar mensagens não enviadas do WhatsApp

Este ponto de extremidade da API é usado para reenviar uma mensagem não enviada (somente se a mensagem tiver um status de erro)

Ponto final:

PEGAR PUBLICAR https://api.smsmobileapi.com/resendwa/

Parâmetro:

- guid: (obrigatório) GUID da mensagem a ser reenviada.

Exemplo:


        OBTENHA https://api.smsmobileapi.com/resendwa/?apikey=SUA_CHAVE_API&guid=GUID_DA_MENSAGEM

Sincronização para recuperar mensagem

Este ponto de extremidade da API é usado para enviar uma solicitação para sincronizar e recuperar mensagens do WhatsApp.
Esta etapa é obrigatória e deve ser executada antes de chamar o endpoint que recupera as mensagens.

Aviso: A sincronização é estritamente necessária apenas para a função de recuperação de mensagem. Não inicie uma sincronização para enviar uma mensagem.

Ponto final:

GET https://api.smsmobileapi.com/getwa/synchronisation/

Parâmetro:

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

Exemplo:


        GET https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY

Responder :



{


 "erro": "0",

   "mensagens": "sincronizadas",

  "expire_at ": "2025-03-11 12:27:00",

  "expire_at_unix": "1741692420",


 

}

Recuperar mensagem do WhatsApp

Este ponto de extremidade da API é usado para recuperar mensagens do WhatsApp recebidas.

Ponto final:

GET https://api.smsmobileapi.com/getwa

Parâmetro:

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

- before (optional): Passe o timestamp como parâmetro e exiba os registros abaixo desse timestamp.

- date (optional): (aaaa-mm-dd) obtém todos os registros com base na data.

Exemplo:


        GET https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY

Responder :



{


  "data": "2025-03-11",

  "hora": "12:27:00",

  "carimbo de data/hora": "1741692420",

  "número": "19176728660",

  "contato": "Smsmobileapi",

  "message": "Você pode me dizer quando receberei meu pedido?",

  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c",

  
  "mais": {

    "resposta_automática": "1",

    "transfert_to_email": "1",

    "chatgpt_reply": "1"

	
  },


  "chatgpt": {

    "prompt_tokens": "900",

    "tokens de conclusão": "10",

    "total_tokens": "910",

    "total_tokens_cost": "0,182"

	 "response": "Seu pedido #576 será enviado amanhã."

	
  }

    
  
}

Autenticação

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 de API

Para enviar ou recuperar mensagens do WhatsApp por meio de nossa API, é necessária autenticação usando uma chave de API. Isso garante acesso seguro e autorizado ao serviço de mensagens. Basta incluir sua chave de API na solicitação para autenticar e começar a enviar mensagens perfeitamente.

2. Autenticação OAuth2

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.

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 "Authorization: Bearer abc123xyz456" \

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

-d "recipients=+1234567890" \

-d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.

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.

Também é possível envie uma mensagem do WhatsApp e um SMS simultaneamente.

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

Documentação do WhatsApp

Enviar WhatsApp

Reenviar mensagem

Sincronização

Recuperar mensagens

Autenticação

Enviar API do WhatsApp

Ponto final:

Parâmetros:

Exemplo sem mídia:

Exemplo com mídia:

Formatar texto no WhatsApp:

Reenviar mensagens não enviadas do WhatsApp

Ponto final:

Parâmetro:

Exemplo:

Sincronização para recuperar mensagem

Ponto final:

Parâmetro:

Exemplo:

Responder :

Recuperar mensagem do WhatsApp

Ponto final:

Parâmetro:

Exemplo:

Responder :

Autenticação

1. Autenticação de chave de API

2. Autenticação OAuth2

Obtendo um Token de Acesso

Usando o Token de Acesso:

Which Method Should You Use?

Enviar mensagem do WhatsApp

URL do WSDL

Parâmetros:

Exemplo

Enviar WhatsApp

Comando básico cURL

Exemplo cURL em PHP

Enviar WhatsApp

Usando a biblioteca `requests`

Usando a biblioteca `http.client`

Enviar WhatsApp

Usando a API `fetch`

Usando `XMLHttpRequest`

Enviar WhatsApp

Usando a biblioteca `axios`

Enviar WhatsApp

Usando a biblioteca `Net::HTTP`