Solicitar Pair Code

dev

https://api-dev.messagefy.io

POST

/api/v1/message/sendcommand

Este método solicita um Pair Code (código numérico/alfanumérico) para autenticação da conta.

Diferente do QRCode, aqui você não precisa renderizar uma imagem. O usuário faz a vinculação inserindo o código de pareamento no próprio WhatsApp (fluxo equivalente a “Vincular dispositivo” / “Conectar com código” do WhatsApp).

Assim que o pareamento for concluído, o MessageFy envia os eventos automaticamente para o seu endpoint via webhook. Consulte a seção Recebendo webhooks.

Pair Code Expirado: Caso o código recebido pelo webhook leve muito tempo para ser utilizado, um novo Pair Code é gerado e enviado via webhook.

Sessão de Login Expirada: Após algum tempo (definido pela Meta), o MessageFy encaminha uma mensagem de desconexão, informando que a sessão de login terminou. Nesse caso, solicite um novo Pair Code e realize o pareamento novamente.

Requisição

Authorization

Adicionar parâmetro em header

api-key

Exemplo:

api-key: ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Sucesso

application/json

Você pode usar o originPackageId no result para relacionar o seu Request com o Result que foi entregue no WebHook

Body

🟢200WebHook PairCode

🟢200Conectado com Sucesso

🟠400Erro

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-dev.messagefy.io/api/v1/message/sendcommand' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channelId": "your-channel-id",
    "correlationId": "Meu correlation ID",
    "content": {
        "commandType": "SESSION_START",
        "type": "SESSION_START_PAIR_CODE",
        "mobileNumber": "5511987654321",
        "enableHistoryOnConnect": false
    }
}'

Response Example

200 - Exemplo

{
    "packageId": "6bfd910d-6247-6f46-471a-ae0692e7402e"
}

Modificado em 2026-03-20 17:41:46

Página anterior

Solicitar QRCode

Próxima página

Solicitar Desconectar o número