Conectar-se à verificação da caixa de entrada

SDK convidado: JavaScript e Python

Baixe o cliente mantido diretamente. Node.js 18+ ou Python 3.9+; nenhum gerenciador de pacotes, dependências ou chave de API é necessário.

SDK JavaScript (.mjs) · SDK Python (.py)

JavaScript

curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check.mjs -o inbox-check.mjs

// Save as check.mjs, replace the sender address, then run: node check.mjs
import { InboxCheck } from './inbox-check.mjs';
const client = new InboxCheck();
const test = await client.createTest({ email: 'you@example.com' });
console.log(test); // Keep token, send_to and results_url.
// Send your own email to ALL send_to addresses before waiting.
// Save the returned token; use the separate read script below.

Pitão

curl -fsS https://check.live-direct-marketing.online/sdk/inbox_check.py -o inbox_check.py

# Save as check.py, replace the sender address, then run: python3 check.py
from inbox_check import InboxCheck
client = InboxCheck()
test = client.create_test('you@example.com')
print(test)  # Keep token, send_to and results_url.
# Send your own email to ALL send_to addresses before waiting.
# Save the returned token; use the separate read script below.

Continue com o token salvo — não crie outro teste

Após enviar a mensagem, execute um script separado usando o MESMO token. A nova execução do script de criação cria outro teste com endereços iniciais diferentes.

// Save as read.mjs, replace YOUR_TEST_TOKEN, then: node read.mjs
import { InboxCheck } from './inbox-check.mjs';
const client = new InboxCheck();
const report = await client.waitForResult('YOUR_TEST_TOKEN');
console.log(report);

# Save as read.py, replace YOUR_TEST_TOKEN, then: python3 read.py
from inbox_check import InboxCheck
client = InboxCheck()
report = client.wait_for_result('YOUR_TEST_TOKEN')
print(report)

waitForResult / wait_for_result retorna o primeiro instantâneo medido do provedor ou um resultado de terminal. Pode ser parcial: inspecione o status e os resultados e continue chamando getTest / get_test com o mesmo token até que o status seja concluído ou expire se você precisar do relatório final completo. Um tempo limite pode ser retomado com esse token.

Esses clientes usam /api/tests públicos. As ferramentas convidadas remotas do MCP também funcionam sem chave: use as instruções do MCP. Todas as opções de configuração atuais estão listadas em /sdk/integration.json.

Webhooks sem registro: retransmissão SDK local

Sua IA pode baixar e configurar esse relé em seu próprio ambiente Node.js. Ele lê um token de teste SAVED, aguarda o instantâneo final concluído/expirado e, em seguida, envia um evento check.completed assinado para o seu receptor. Mantenha o processo em execução. Esta não é uma assinatura de webhook hospedada do Check.

curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check.mjs -o inbox-check.mjs
curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check-webhooks.mjs -o inbox-check-webhooks.mjs

Substitua SAVED_TEST_TOKEN e YOUR_RECEIVER pelo token já criado e pelo seu próprio receptor HTTPS. Configure grava um novo arquivo privado com um segredo de assinatura aleatório; ele se recusa a substituir um arquivo existente.

node inbox-check-webhooks.mjs configure --token SAVED_TEST_TOKEN --url https://YOUR_RECEIVER/hook --config ./inbox-check-webhook.json
node inbox-check-webhooks.mjs run --config ./inbox-check-webhook.json

Configure seu receptor com o mesmo segredo privado antes de executar. Verifique o corpo da solicitação bruta, X-Inbox-Check-Timestamp e X-Inbox-Check-Signature. A assinatura é sha256=HMAC-SHA256(secret, timestamp + "." + rawBody). Rejeite carimbos de data/hora obsoletos e desduplicar event.id.

import { verifyWebhook } from './inbox-check-webhooks.mjs';
// Receiver: use your privately configured shared secret and RAW request body.
const valid = verifyWebhook({
  body: rawBody, secret: privateSharedSecret,
  timestamp: request.headers['x-inbox-check-timestamp'],
  signature: request.headers['x-inbox-check-signature']
});
// Reject invalid signatures before parsing/acting on the event.
// Deduplicate JSON.parse(rawBody).id before processing a valid event.

A retransmissão nunca cria um teste ou envia um email de teste. Ele não tenta novamente POSTs de retorno de chamada nem segue redirecionamentos. Se a entrega do retorno de chamada for incerta, o erro inclui eventId: verifique seu receptor antes de executar novamente. Se a votação expirar, retenha o token/config e retome o mesmo teste. Um resultado expirado sem mensagens recebidas permanece um resultado expirado.