Documentação - Sistema de Automação

Entenda como funciona o sistema de links de automação do PriveCall

API v1 — Connect with PriveCall

Conta do user via OAuth2 ou API Key. Upload de vídeos, automações e salas.

Prefira a v1 se a outra plataforma tiver botão Conectar PriveCall. Fluxo completo em docs/API_V1.md e keys em /developer.

  • GET /oauth/authorize → consent → POST /api/oauth/token
  • Authorization: Bearer priv_at_… ou priv_sk_…
  • /api/v1/videos/* · /api/v1/automations/* · /api/v1/rooms/* · /api/v1/me

Abaixo: API legada por secret de automação (ainda funciona).

Visão Geral (legado)

O sistema de automação permite que você crie links privados reutilizáveis que geram automaticamente novas salas de vídeo chat quando acessados. Isso é ideal para vendedores que querem compartilhar um único link que cria múltiplas sessões personalizadas.

Fluxo de funcionamento:

  1. Você cria uma automação em /automations
  2. O sistema gera um link privado com uma chave secreta
  3. Você compartilha esse link com seus clientes
  4. Cada vez que o link é acessado (via POST), uma nova sala é criada
  5. O cliente recebe um link único para acessar a sala

API: Gerar Sala de Chat

Endpoint para criar uma nova sala a partir de uma automação

POST
/api/automation/[secret]

Onde [secret] é a chave privada da automação.

Parâmetros

secret
Obrigatório

Tipo: string

Localização: URL Path

Chave privada da automação. É gerada automaticamente ao criar a automação e deve ser mantida em segredo.

Resposta de Sucesso (200)

success- Indica que a sala foi criada com sucesso
chatUrl- URL completa para acessar a sala criada
chatId- ID único da sala gerada

Respostas de Erro

400 - Bad Request

Ocorre quando o parâmetro secret não é fornecido na URL.

404 - Not Found

Ocorre quando:

  • A chave secreta não corresponde a nenhuma automação
  • A automação existe mas está desativada (isActive: false)
500 - Internal Server Error

Erro inesperado do servidor. Entre em contato com o suporte se persistir.

Exemplos de Uso

cURL

JavaScript (fetch)

Python (requests)

Fluxo Completo de Uso

1

Criar Automação

Acesse /automations e crie uma nova automação com:

  • Nome único (ex: "apresentacao-produto")
  • Título da apresentação
  • URL do vídeo
  • Duração do vídeo em segundos
2

Obter Link Privado

Após criar, você receberá algo como:

https://chamadaprivada.com/api/automation/abc123xyz
3

Compartilhar Link

Compartilhe o link privado com seus clientes através de:

  • Página de vendas (botão que faz POST para o link)
  • Email marketing
  • Integração com CRM
  • Automação de marketing
4

Cliente Acessa

Quando o cliente clica no botão/link, sua aplicação faz um POST para o endpoint. O sistema cria uma nova sala e retorna o link único.

5

Redirecionar Cliente

Redirecione o cliente para o chatUrl retornado. Cada cliente terá sua própria sala isolada.

Informações Importantes