Comandos

Comandos são operações especiais que você envia para controlar a sessão do WhatsApp conectada ao seu canal. Diferente de mensagens (que enviam conteúdo para contatos), comandos executam ações como consultar contatos, verificar o status da conexão, iniciar ou encerrar sessões, entre outros.

Como enviar um comando

Todos os comandos são enviados através do mesmo endpoint:

POST /api/v1/message/SendCommand

O corpo da requisição segue o formato padrão do Package:

{
  "channelId": "uuid-do-canal",
  "content": {
    "type": "TIPO_DO_COMANDO",
    "commandType": "TIPO_DO_COMANDO",
    ...campos_especificos
  }
}

Os campos type e commandType determinam qual comando será executado.

Resposta da API

A API retorna imediatamente um packageId confirmando que o comando foi recebido:

{
  "packageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

A resposta da API não contém o resultado do comando. O resultado real é entregue de forma assíncrona via webhook, associado ao packageId retornado.

Comandos disponíveis

Comando	type / commandType	Descrição
Status	`STATUS`	Consulta o estado da conexão
Iniciar Sessão	`SESSION_START_QR_CODE` / `SESSION_START_PAIR_CODE` / `SESSION_START_LINK`	Inicia a conexão com WhatsApp
Importar Sessão	`SESSION_IMPORT`	Importa uma sessão WhatsApp Web já autenticada
Confirmar Passkey	`PASSKEY_CONFIRM`	Confirma o pareamento por passkey do WhatsApp
Contatos	`CONTACTS`	Lista os contatos do dispositivo
Grupos	`GROUPS`	Lista os grupos do dispositivo
Info do Contato	`CONTACT_INFO`	Obtem detalhes de um contato
Info do Grupo	`GROUP_INFO`	Obtem detalhes de um grupo
Conversas	`GET_CHATS`	Lista as conversas recentes
Últimas Mensagens	`GET_LAST_MESSAGES`	Obtem mensagens de uma conversa
Marcar como Lido	`MARK_READ`	Marca mensagens como lidas
Presença	`PRESENCE_SUBSCRIPTION`	Inscreve-se para receber presença de um contato
Digitação	`START_TYPING` / `STOP_TYPING`	Simula indicador de digitação
Desconectar	`DISCONNECT`	Encerra a sessão do WhatsApp

Autenticação

Todas as requisicoes devem incluir o header X-API-KEY com sua chave de API valida.

curl -X POST https://api-dev.messagefy.io/api/v1/message/SendCommand \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sua-api-key" \
  -d '{
    "channelId": "uuid-do-canal",
    "content": {
      "type": "STATUS",
      "commandType": "STATUS"
    }
  }'

Certifique-se de configurar a URL de webhook no seu canal para receber as respostas dos comandos. Consulte a secao Webhooks para mais detalhes.

Início

Contas

API Keys

Canais

WhatsApp Oficial

Tipos de Mensagem

Operações de Mensagem

Sessão e Conexão

Consultas

Interação

Visão Geral dos Comandos

Comandos

Como enviar um comando

Resposta da API

Comandos disponíveis

Autenticação

​Comandos

​Como enviar um comando

​Resposta da API

​Comandos disponíveis

​Autenticação

Comandos

Como enviar um comando

Resposta da API

Comandos disponíveis

Autenticação