/partner

A API do programa Whitelabel. O parceiro cria o espaço do cliente dentro do próprio produto, gera a chave daquele espaço e lê o consumo, sem passar pelo painel.

É o que transforma "eu uso a Wevichat" em "eu embuto a Wevichat": o seu cliente contrata no seu site, e o espaço dele nasce por uma chamada sua.

Exige o escopo partner:manage e que a organização da chave seja parceira. Se você ainda não é, fale com a gente.

Endpoints

Método	Rota	O que faz
GET	/partner/clients	Lista os seus clientes, com o consumo do mês
POST	/partner/clients	Cria um cliente
GET	/partner/clients/{id}	Um cliente, com consumo
PATCH	/partner/clients/{id}	Muda nome, cor, logotipo e domínio
POST	/partner/clients/{id}/keys	Gera uma chave dentro do cliente
GET	/partner/usage	Consumo de todos os clientes

Criar um cliente

curl -X POST https://api.wevi.chat/functions/v1/partner/clients \
  -H "Authorization: Bearer wevi_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Clínica Bem Estar","plan":"pro","primary_color":"#B5F03F"}'

Sem plan, o cliente nasce em teste de 15 dias. Com plan, nasce ativo e entra na sua cobrança na hora, o que exige a sua assinatura de parceiro ativa.

A resposta traz invite_url. Mande esse link para o cliente: é por ele que alguém do lado dele assume o espaço como administrador. Sem isso, o espaço existe mas não tem dono humano.

Gerar a chave do cliente

curl -X POST https://api.wevi.chat/functions/v1/partner/clients/{id}/keys \
  -H "Authorization: Bearer wevi_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"integração","scopes":["contacts:read","messages:send"]}'

A chave vale só naquele cliente: não enxerga os seus outros clientes nem a sua organização parceira. O token aparece uma vez só, nesta resposta.

É com ela que o seu sistema opera o espaço do cliente, com as permissões que você escolher.

Trocar de plano

Ainda passa pelo painel, porque mexe na sua cobrança no Stripe. Mandar plan no PATCH devolve 409 explicando isso. Os outros campos podem ser alterados pela API.

Consumo

curl https://api.wevi.chat/functions/v1/partner/usage \
  -H "Authorization: Bearer wevi_SUA_CHAVE"

Devolve o total, a divisão por plano e o consumo de cada cliente. É o número que fecha com a sua fatura de licenças no fim do mês.

Isolamento

Cliente de outro parceiro responde 404, não 403: para a sua chave, ele não existe. A sua chave de parceiro também não lê conversas nem contatos dos seus clientes; para isso, gere a chave daquele cliente.