Demo Page: https://demo-plugins-72655.bubbleapps.io/version-test/assemblyai_realtime_transcript
🇺🇸 Plugin Usage Instructions
🔧 Requirements

Create a free account at AssemblyAI → https://www.assemblyai.com

Generate an API key with Streaming v3 permission

🔐 Token Endpoint (Backend Required)

You must create a backend endpoint that returns a valid token to the plugin.

Step-by-step — Bubble

1️⃣ API Connector

Create a new GET request:

https://streaming.assemblyai.com/v3/token?expires_in_seconds=3600


Add header:

Authorization: YOUR_API_KEY


Initialize the call successfully

2️⃣ Backend Workflow

Create a new workflow endpoint

Add action: API Connector → Generate Token

Add action: Return data from API

Key: token

Value: token returned from the API Connector action

3️⃣ Copy the workflow URL
This URL will be used in the plugin as token_endpoint
Example:

https://yoursite.com/version-test/api/1.1/wf/aai-token

📦 Using the Plugin
Actions

Add these two actions in your workflow:

Start stream

Stop stream

Start stream configuration

token_endpoint → URL of the backend workflow created above

https://yoursite.com/version-test/api/1.1/wf/aai-token

Returned states

partial_text → real-time partial transcript

final_text → final transcript after speech ends

connected → indicates if session is active

error → error message if something fails

Stopping transcription

Run Stop stream to terminate the connection and release microphone access




🇧🇷 Instruções de Uso do Plugin
🔧 Pré-requisitos

Criar uma conta na AssemblyAI → https://www.assemblyai.com

Gerar uma API key com permissão de Streaming v3

🔐 Endpoint de Token (Backend Obrigatório)

É necessário criar um endpoint no backend que retorne um token válido para o plugin.

Passo a passo — Bubble

1️⃣ API Connector

Nova requisição GET:

https://streaming.assemblyai.com/v3/token?expires_in_seconds=3600


Header obrigatório:

Authorization: SUA_API_KEY


Inicializar a chamada com sucesso

2️⃣ Backend Workflow

Criar um novo endpoint de workflow

Adicionar ação: API Connector → Generate Token

Adicionar ação: Return data from API

Key: token

Value: token retornado pela chamada do API Connector

3️⃣ Copiar a URL do workflow
Essa URL será usada no plugin como token_endpoint
Exemplo:

https://meusite.com/version-test/api/1.1/wf/aai-token

📦 Usando o Plugin
Actions

Adicionar estas duas ações:

Start stream

Stop stream

Configuração do Start stream

token_endpoint → URL do workflow backend criado acima

https://meusite.com/version-test/api/1.1/wf/aai-token

Estados retornados

partial_text → texto parcial em tempo real

final_text → texto final

connected → sessão ativa

error → mensagem de erro, se ocorrer

Encerrando a transcrição

Executar Stop stream para finalizar e liberar o microfone