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:

Parâmetro	Descrição
apikey	Obrigatório Sua chave de API exclusiva.
recipients	Obrigatório Número de telefone do destinatário (o número deve estar disponível no WhatsApp). Digite o número de telefone começando com o código do país (sem '+' e sem '00'), seguido diretamente pelo restante do seu número. Exemplo: 191728660
message	Obrigatório A mensagem a ser enviada (várias linhas possíveis).
waonly	Obrigatório Deve ter o valor sim → Necessário para especificar que apenas uma mensagem do WhatsApp deve ser enviada.
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. Formatos suportados: Documentos: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz Imagens: jpg, jpeg, png
url_media_shorted	Se o valor for sim, e [pdf_with_image=yes] estiver definido, a exibição do link de download do PDF passa por um URL curto.
pdf_with_image	Se o valor for sim, uma pré-visualização da imagem do PDF será exibida para acompanhar a mensagem (somente se o arquivo for um PDF).
encrypt_message	sim = A mensagem será criptografada quando lida pelo destinatário. O destinatário precisará inserir uma chave exclusiva para descriptografar a mensagem. Saiba mais sobre criptografia de mensagens

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:

Parâmetro	Descrição
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:

Parâmetro	Descrição
apikey (required)	Obrigatório 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:

Parâmetro	Descrição
apikey	Obrigatório A chave de API que você tem ou receberá.
before	Passe o timestamp como parâmetro e exiba os registros abaixo desse timestamp.
date	(aaaa-mm-dd) Obter todos os registros com base na data.
message_type	Deixe em branco para ver todas (mensagens de texto e áudio) Usar `texto` para ver apenas mensagens de texto Usar `áudio` para ver apenas mensagens de áudio convertidas em texto

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

Recursos de SMS

Recursos do WhatsApp

Plugins gerais

Plugins de Loja Online

Documentação de API e desenvolvedor

Ferramentas e log de alterações

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`