API do Sitto

Junte contactos às suas listas a partir de qualquer site, loja, CRM ou app. Crie a chave em Integrações na área de cliente e envie-a no cabeçalho Authorization: Bearer sk_sitto_…. Base: https://sitto.app/api/v1. Respostas em JSON.

Listas

GET /lists: as listas da conta, com o id que usa nos pedidos.

curl https://sitto.app/api/v1/lists -H "Authorization: Bearer sk_sitto_…"

Juntar ou atualizar um contacto

POST /contacts com email, name (opcional), lists (ids) e doubleOptIn (opcional: manda o email de confirmação antes de ativar). Se o contacto já existe, só é junto às listas.

curl -X POST https://sitto.app/api/v1/contacts \
  -H "Authorization: Bearer sk_sitto_…" -H "Content-Type: application/json" \
  -d '{"email":"ana@exemplo.pt","name":"Ana","lists":["ID_DA_LISTA"],"doubleOptIn":true}'

Vários de uma vez (até 1000): {"contacts":[{"email":"…","lists":["…"]}, …]}.

// JavaScript (servidor)
await fetch('https://sitto.app/api/v1/contacts', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.SITTO_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ email, name, lists: ['ID_DA_LISTA'] }),
})

<?php // PHP
$r = wp_remote_post('https://sitto.app/api/v1/contacts', [
  'headers' => ['Authorization' => 'Bearer ' . SITTO_KEY, 'Content-Type' => 'application/json'],
  'body' => json_encode(['email' => $email, 'lists' => ['ID_DA_LISTA']]),
]);

Consultar um contacto

GET /contacts?email=ana@exemplo.pt: estado (active, pending, unsubscribed, bounced, complained) e listas.

Cancelar ou tirar de uma lista

DELETE /contacts/ana@exemplo.pt cancela a subscrição (deixa de receber da conta). Com ?list=ID só o tira dessa lista.

Regras

Só envie contactos que deram consentimento. Endereços que cancelaram não voltam a ficar ativos pela API: têm de se inscrever eles próprios num formulário.
Endereços que devolveram ou se queixaram são recusados (422).
Nunca ponha a chave no código do browser: use-a no servidor. A chave dá acesso aos contactos da conta.

Formulário sem programar

Cada lista tem uma página de inscrição e um formulário HTML pronto a colar (em Listas → a lista → Formulário). Para WordPress/WooCommerce, Shopify e PrestaShop há ligações prontas em Integrações.