DEVELOPER EXPERIENCE

Entenda a integração antes do código.

Acesse a referência técnica e prepare sua primeira integração.

Vá direto à referência.

Acesse a documentação técnica publicada pela equipe para consultar contratos e exemplos vigentes.

Acessar documentação técnica

Não teste endpoints por suposição. Este site não oferece um console conectado à API.

Enviar uma mensagem de texto

Contrato público v1. Execute no seu backend com uma instância conectada e acesso ativo. O retorno 202 aceita o processamento; não confirma entrega.

curl
curl --request POST "https://app.connect.mydev.com.br/api/v1/instances/INSTANCE_ID/messages" \
  --header "Authorization: Bearer $CONNECT_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{"to":"DESTINATARIO","text":"Olá!"}'
JavaScript (Node.js)
const response = await fetch(
  `https://app.connect.mydev.com.br/api/v1/instances/${process.env.CONNECT_INSTANCE_ID}/messages`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.CONNECT_TOKEN}`,
      Accept: 'application/json',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ to: process.env.CONNECT_TO, text: 'Olá!' }),
  },
);
if (!response.ok) throw new Error(`Connect: HTTP ${response.status}`);
const result = await response.json();
PHP (cURL)
$instance = rawurlencode(getenv('CONNECT_INSTANCE_ID'));
$ch = curl_init("https://app.connect.mydev.com.br/api/v1/instances/$instance/messages");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer '.getenv('CONNECT_TOKEN'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['to' => getenv('CONNECT_TO'), 'text' => 'Olá!']),
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($body === false || $status >= 400) throw new RuntimeException('Falha ao enviar pelo Connect');
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);

Substitua os placeholders. Nunca exponha tokens no navegador. Referência técnica e erros.

SEU CHECKLIST TÉCNICO

Antes da primeira chamada.

Acesso e segurança

Confirme autenticação, permissões e cuidados com credenciais. Mantenha segredos no backend da sua aplicação.

Contratos e limites

Verifique endpoints, formatos, códigos de resposta e limites no contrato vigente do produto.

Eventos e falhas

Valide a disponibilidade de webhooks e planeje o comportamento do seu sistema em caso de indisponibilidade.

Introdução

A API v1 usa a base https://app.connect.mydev.com.br/api/v1, JSON e autenticação Bearer. GET /health é público. Use a referência externa para os contratos completos.

Prepare a primeira integração

Consulte o plano, acesse a plataforma e siga a documentação para configurar a conexão. Endereços, credenciais e primeira chamada precisam ser os publicados pelo produto.

Jornada conceitual · siga as etapas da referência vigente
  1. 01Cadastro e chave
  2. 02Criar instância
  3. 03Conectar via QR
  4. 04Enviar texto

Autenticação

Mantenha credenciais no backend. Confirme como obtê-las, enviá-las e revogá-las na referência técnica; nenhum token deve ser inserido nos exemplos deste site.

Instâncias

Confira no plano a quantidade de conexões e na documentação os estados, o método de vinculação e as regras de reconexão.

Envio de mensagens

Valide destinatário, formatos, tamanho e significado da resposta antes de incorporar a chamada ao seu fluxo. Uma solicitação aceita não comprova entrega.

Recebimento de mensagens

Confirme os formatos de entrada e quais dados ficam disponíveis para relacionar uma mensagem ao contexto do seu sistema.

Webhooks e eventos

Configure webhook_url na instância e valide X-Connect-Signature com HMAC-SHA256 sobre o corpo bruto e webhook_secret. Use X-Connect-Delivery para deduplicação. Os eventos são message.received, message.status e instance.status.

Fluxo de eventos documentado na API v1
  1. 01WhatsApp
  2. 02Connect
  3. 03Webhook
  4. 04Seu sistema

Tratamento de erros

Use os códigos reais da documentação para distinguir falha de autenticação, dados inválidos, limites e indisponibilidade. Não repita envios sem entender o risco de duplicação.

Exemplos de integração

Os exemplos acima seguem o contrato público v1 de envio de texto. Configure token, instância conectada e destinatário no seu backend. Eles não foram executados com credenciais nesta auditoria. A referência externa contém os detalhes completos.

Limites e boas práticas

Compare os limites vigentes na página de planos. Planeje contingência para desconexões e restrições inerentes à integração não oficial.

Conferir recursos e evidências →

SEU PRÓXIMO BUILD COMEÇA AQUI

Você constrói.
A conversa continua.

Vamos encontrar o lugar da comunicação no seu produto.