Como enviar sua primeira mensagem

Introdução

Este guia irá orientá-lo passo a passo no processo de enviar sua primeira mensagem através da WPP-API. Ao final, você terá uma instância conectada ao WhatsApp e será capaz de enviar mensagens de forma programática.

Pré-requisitos

Antes de começar, certifique-se de que você possui:

✅ Chave de API válida: Se ainda não possui, consulte Como obter uma chave de API
✅ Número de telefone: Um número de celular com WhatsApp instalado para conectar à instância
✅ Ferramenta HTTP: Como cURL, Postman, Insomnia ou qualquer cliente HTTP de sua preferência

Dica

Mantenha sua chave de API em um local seguro. Você precisará dela em todas as requisições.

Passo 1: Criar uma instância

O primeiro passo é criar uma instância. Uma instância representa uma conexão única com o WhatsApp. Cada instância pode estar conectada a apenas um número de telefone por vez.

Endpoint utilizado

POST https://wpp.api.br/instance

Requisição

cURL
JavaScript
Python
PHP

curl -X POST https://wpp.api.br/instance \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE_DE_API_AQUI"

const response = await fetch("https://wpp.api.br/instance", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "SUA_CHAVE_DE_API_AQUI",
  },
});

const data = await response.json();
console.log("Instance ID:", data.id);
console.log("QR Code:", data.qr_code);

import requests

response = requests.post(
    'https://wpp.api.br/instance',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'SUA_CHAVE_DE_API_AQUI'
    }
)

data = response.json()
print('Instance ID:', data['id'])
print('QR Code:', data['qr_code'])

<?php
$ch = curl_init('https://wpp.api.br/instance');

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'x-api-key: SUA_CHAVE_DE_API_AQUI'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

echo 'Instance ID: ' . $data['id'] . PHP_EOL;
echo 'QR Code: ' . $data['qr_code'] . PHP_EOL;

curl_close($ch);

Resposta

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}

Importante

Guarde o id da instância retornado. Você precisará dele para todas as operações futuras com esta instância.

Passo 2: Conectar ao WhatsApp

Após criar a instância, você receberá um QR Code que precisa ser escaneado com o aplicativo WhatsApp.

Como escanear o QR Code

Abra o WhatsApp no seu celular
Vá em Menu (⋮) ou Configurações
Selecione Aparelhos conectados
Toque em Conectar um aparelho
Escaneie o QR Code retornado pela API

Dica sobre o QR Code

O QR Code retornado pela API está no formato base64 com prefixo data:image/png;base64,. Você pode:

Exibir diretamente em uma tag <img> HTML
Decodificar e salvar como arquivo PNG
Usar bibliotecas para renderizar na linha de comando

Exemplo: Exibir QR Code em HTML

<!DOCTYPE html>
<html>
  <head>
    <title>Conectar WhatsApp</title>
  </head>
  <body>
    <h1>Escaneie o QR Code com seu WhatsApp</h1>
    <img id="qrcode" alt="QR Code" />

    <script>
      // Substitua pelo QR Code retornado da API
      const qrCode = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...";
      document.getElementById("qrcode").src = qrCode;
    </script>
  </body>
</html>

Verificando o status da conexão

Você pode verificar se a instância foi conectada com sucesso usando o endpoint GET /instance/{id}:

curl -X GET https://wpp.api.br/instance/123e4567-e89b-12d3-a456-426614174000 \
  -H "x-api-key: SUA_CHAVE_DE_API_AQUI"

Quando conectado com sucesso, o status da instância será connected.

Eventos de Webhook

Se você configurou webhooks, receberá notificações automáticas sobre mudanças no status da conexão:

client.qr_code - Quando um novo QR Code é gerado
client.paired - Quando o celular é pareado
client.connected - Quando a conexão é estabelecida

Passo 3: Enviar sua primeira mensagem

Agora que sua instância está conectada, você pode enviar mensagens!

Endpoint utilizado

POST https://wpp.api.br/instance/{id}/send

Requisição: Mensagem de texto simples

cURL
JavaScript
Python
PHP

curl -X POST https://wpp.api.br/instance/123e4567-e89b-12d3-a456-426614174000/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE_DE_API_AQUI" \
  -d '{
    "to": ["5511999999999"],
    "contents": [
      {
        "content_type": "text",
        "content": "Olá! Esta é minha primeira mensagem usando a WPP-API! 🚀"
      }
    ]
  }'

const instanceId = "123e4567-e89b-12d3-a456-426614174000";

const response = await fetch(`https://wpp.api.br/instance/${instanceId}/send`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "SUA_CHAVE_DE_API_AQUI",
  },
  body: JSON.stringify({
    to: ["5511999999999"],
    contents: [
      {
        content_type: "text",
        content: "Olá! Esta é minha primeira mensagem usando a WPP-API! 🚀",
      },
    ],
  }),
});

const result = await response.json();
console.log("Mensagem enviada:", result);

import requests

instance_id = '123e4567-e89b-12d3-a456-426614174000'

response = requests.post(
    f'https://wpp.api.br/instance/{instance_id}/send',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'SUA_CHAVE_DE_API_AQUI'
    },
    json={
        'to': ['5511999999999'],
        'contents': [
            {
                'content_type': 'text',
                'content': 'Olá! Esta é minha primeira mensagem usando a WPP-API! 🚀'
            }
        ]
    }
)

result = response.json()
print('Mensagem enviada:', result)

<?php
$instanceId = '123e4567-e89b-12d3-a456-426614174000';
$url = "https://wpp.api.br/instance/{$instanceId}/send";

$data = [
    'to' => ['5511999999999'],
    'contents' => [
        [
            'content_type' => 'text',
            'content' => 'Olá! Esta é minha primeira mensagem usando a WPP-API! 🚀'
        ]
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'x-api-key: SUA_CHAVE_DE_API_AQUI'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
$result = json_decode($response, true);

echo 'Mensagem enviada: ' . print_r($result, true);

curl_close($ch);

Resposta

{
  "success": true
}

Sucesso!

Se você recebeu "success": true, sua mensagem foi enviada com sucesso! 🎉

Formato do número de telefone

O número de telefone deve estar no formato internacional sem símbolos:

✅ Correto: 5511999999999 (código do país + DDD + número)
❌ Incorreto: +55 (11) 99999-9999
❌ Incorreto: 11999999999 (sem código do país)

Enviando para múltiplos destinatários

Você pode enviar a mesma mensagem para vários números ao mesmo tempo:

{
  "to": ["5511999999999", "5521888888888", "5531777777777"],
  "contents": [
    {
      "content_type": "text",
      "content": "Mensagem para todos!"
    }
  ]
}

Próximos passos

Agora que você enviou sua primeira mensagem, explore mais funcionalidades:

Precisa de ajuda?

Se você tiver dúvidas ou encontrar problemas, entre em contato com nosso suporte:

📧 suporte@wpp.api.br

Como enviar sua primeira mensagem

Introdução​

Pré-requisitos​

Passo 1: Criar uma instância​

Endpoint utilizado​

Requisição​

Resposta​

Passo 2: Conectar ao WhatsApp​

Como escanear o QR Code​

Exemplo: Exibir QR Code em HTML​

Verificando o status da conexão​

Passo 3: Enviar sua primeira mensagem​

Endpoint utilizado​

Requisição: Mensagem de texto simples​

Resposta​

Formato do número de telefone​

Enviando para múltiplos destinatários​

Próximos passos​

Precisa de ajuda?​

Introdução

Pré-requisitos

Passo 1: Criar uma instância

Endpoint utilizado

Requisição

Resposta

Passo 2: Conectar ao WhatsApp

Como escanear o QR Code

Exemplo: Exibir QR Code em HTML

Verificando o status da conexão

Passo 3: Enviar sua primeira mensagem

Endpoint utilizado

Requisição: Mensagem de texto simples

Resposta

Formato do número de telefone

Enviando para múltiplos destinatários

Próximos passos

Precisa de ajuda?