Passar para o conteúdo principal

API e Webhooks

Como acessar, configurar e usar nossa API e Webhooks

Atualizado essa semana

Você já sabe que o tl;dv é tudo sobre economizar tempo e tornar o trabalho mais simplificado. Usar nossa API Pública e Webhooks tornará tudo ainda mais simples.

Aqui está como acessá-los, configurá-los e aliviar ainda mais o trabalho!

API Pública

Nossa API permite que você importe reuniões e crie fluxos de trabalho personalizados adaptados às suas necessidades. O acesso à API e webhooks está disponível somente no Plano Empresarial.

  • Plano Empresarial: Acesso à API incluído

  • Planos Pro ou Gratuito: Acesso à API não incluído ou disponível

Como usar a API Pública do tl;dv

Para começar, você precisará de:

  1. Chave da API: Você pode encontrá-la em suas Configurações da Conta se estiver no Plano Empresarial.

  2. Configuração técnica: A implementação geralmente requer um pouco de codificação, então um desenvolvedor da sua equipe pode precisar ajudar.

Inclui tudo o que você precisa para começar a integrar.

Precisa de ajuda ou quer fazer upgrade?

Se você não tem certeza se deveria ter acesso ou como usá-lo, estamos aqui para responder suas perguntas ou ajudar com o upgrade para o Plano Empresarial. Basta entrar em contato pelo support@tldv.io - estamos felizes em ajudar! 🙌


Webhooks

Como configurar Webhooks para receber dados de reuniões

Quer automatizar fluxos de trabalho recebendo dados de reuniões em tempo real? Podemos configurar um webhook para você! Uma vez configurado, enviaremos uma carga útil assim que uma reunião (ou sua transcrição) estiver pronta, sem a necessidade de consultar nossa API.

Como funciona

Os webhooks permitem que você receba uma notificação quando:

  • Uma reunião é processada com sucesso (MeetingReady)

  • Uma transcrição está disponível (TranscriptReady)

Cada webhook inclui metadados enriquecidos, ideal se você está construindo automações ou integrações personalizadas, e cada evento envia uma carga JSON que corresponde ao formato usado em nossa API Pública.

Aqui está como é:

{  "id": "webhook-job-id",  "event": "MeetingReady",  "executedAt": "2025-06-16T09:23:00Z",  "data": {    "id": "meeting-id",    "happenedAt": "2025-06-15T14:00:00Z",    "name": "Team Sync",    "organizer": {      "email": "organizer@example.com",      "name": "Alex Taylor"    },    "invitees": [      {        "email": "teammate@example.com",        "name": "Jordan Lee"      }    ],    "url": "https://app.tldv.io/meetings/meeting-id"  }}

Uma vez habilitado, acionaremos o webhook toda vez que você organizar uma reunião e ela for processada com sucesso. Se transcrições forem geradas posteriormente, você receberá um evento adicional TranscriptReady também.

O que precisamos de você

Como você não pode configurar os webhooks do seu lado, apenas nos envie as seguintes informações para que possamos configurá-los para você:

  1. URL do Webhook: O endpoint para o qual você deseja que enviemos dados.

  2. Email do Usuário: O endereço de email do usuário ao qual o webhook deve estar vinculado.

  3. Configuração de Cabeçalho Opcional: Qualquer configuração ou cabeçalhos extras (por exemplo, tokens de autenticação) que você deseja que incluamos na solicitação.

Envie isso para nós via chat ou email, e cuidaremos do resto. 🔮

Respondeu à sua pergunta?