Meeto Widget: documentação para desenvolvedores

Escolha o seu stack, substitua YOUR_KEY pela sua chave e dê uma altura ao contêiner — o widget preenche 100% dele.

<div id="meeto-call" style="height: 520px"></div>
<script src="https://meeto.me/widget.js" data-key="YOUR_KEY" data-target="#meeto-call"></script>

Pacotes npm: @meeto/embed-core (sem dependências), @meeto/embed-react, @meeto/embed-vue, @meeto/embed-angular. O script comum widget.js funciona sem nenhuma etapa de build.

Atributos da tag <script src="https://meeto.me/widget.js"> (* — obrigatório). As mesmas opções existem na API JavaScript (key, container, room, name, lang, accent, autoJoin, baseUrl) e como atributos do web component <meeto-room>.

Os links das salas continuam válidos: qualquer sala do widget também pode ser aberta em meeto.me/<code>.

Inscreva-se via widget.on(type, handler) (retorna uma função de cancelamento), a opção onEvent, as props dos componentes de framework ou os CustomEvents meeto:* do elemento <meeto-room>.

const widget = new MeetoWidget({ key: "mk_live_…", container: "#call" });
const off = widget.on("joined", (e) => console.log(e.room));
widget.on("participants", (e) => console.log("in call:", e.count));

Métodos da instância do widget:

Em uma sala em que é preciso bater na porta, com senha ou bloqueada, join() mantém o visitante no lobby e o widget emite error com o código join_not_allowed — em vez disso, deixe o visitante entrar sozinho pelo lobby.

Para fluxos no lado do servidor (criar salas a partir do seu backend, enviar links por e-mail, decidir quem vira anfitrião) use a chave secreta mk_secret_… — ela é mostrada uma vez, quando você cria o embed:

curl -X POST https://api.meeto.me/api/embed/rooms \
  -H "Authorization: Bearer mk_secret_…"
# → 201 { "slug": "misty-fox-42", "hostSecret": "…" }

curl -X POST https://api.meeto.me/api/v1/meetings \
  -H "Authorization: Bearer mk_secret_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: appointment-872" \
  -d '{
    "title": "Project review",
    "startsAt": "2027-03-22T10:00:00+02:00",
    "durationMin": 45,
    "timezone": "Europe/Tallinn"
  }'
# → 201 { "meeting": { "id": "…", "joinUrl": "https://meeto.me/…?k=…" }, "hostSecret": "…" }

curl https://api.meeto.me/api/v1/meetings \
  -H "Authorization: Bearer mk_secret_…"

hostSecret torna quem a possui o anfitrião da sala: passe a sala ao widget via data-room e entregue hostSecret apenas à sua própria equipe. Requisições com a chave secreta pulam a verificação de domínio — nunca a exponha em código de navegador.

A API versionada (/api/v1) está disponível no plano Pro: solicitações com a chave de uma conta Free recebem 402 plan_required. O widget em si funciona em todos os planos.

Wrappers nativos incorporam o mesmo widget ao seu app: uma WebView com uma ponte tipada de eventos/comandos. Registre a origem do app app://<bundle-id> nos domínios da chave.

iOS (Swift Package, iOS 14+)

// Xcode → File → Add Package Dependencies…
https://github.com/meeto-app/meeto-widget-ios.git   // from: 0.1.2

import MeetoWidget

MeetoWidget(config: .init(key: "mk_live_…", roomName: "support")) { event in
    if event.type == "left" { /* close the screen */ }
}

Swift Package; adicione NSCameraUsageDescription e NSMicrophoneUsageDescription ao Info.plist.

Android (Kotlin, minSdk 24)

// settings.gradle.kts
dependencyResolutionManagement { repositories { maven("https://jitpack.io") } }

// module's build.gradle.kts
dependencies { implementation("com.github.meeto-app:meeto-widget-android:0.1.3") }

val widget = MeetoWidgetView(this)
widget.onEvent = { event -> if (event.type == "left") finish() }
container.addView(widget)
widget.load(MeetoWidgetConfig(key = "mk_live_…", roomName = "support"))

Módulo Gradle; declare CAMERA / RECORD_AUDIO / INTERNET e solicite as permissões em tempo de execução antes de exibir o widget.

Eventos (ready, joined, left, participants, error) e comandos (join, leave, setMicrophone, setCamera) são idênticos ao SDK web.

Código-fonte e lançamentos: meeto-app/meeto-widget-ios ↗meeto-app/meeto-widget-android ↗

Adicione o widget a um site WordPress sem escrever código: um botão de chamada flutuante em cada página ou uma chamada incorporada via shortcode.

1. No painel do WordPress, abra Plugins → Adicionar novo → Enviar plugin e faça o upload do zip.
2. Ative o plugin e abra Configurações → Meeto Widget.
3. Cole sua chave de incorporação (com o domínio do seu site adicionado a ela) — o botão de chamada está ativo.

Para um widget incorporado, desative a inserção automática nas configurações e coloque o shortcode em qualquer página: [meeto_widget room_name="support" height="600"]

As salas do widget seguem o plano do dono da chave:

• Free — até 10 participantes, chamadas em grupo de até 60 minutos, até 1080p.
• Pro — até 25 participantes, sem limite de tempo para 2 reuniões simultâneas e até 4K em desktops compatíveis. A marca Meeto continua visível.

• A chave pública não é um segredo: ela fica visível no código-fonte da sua página, e isso é proposital.
• O widget só funciona em domínios registrados para a chave. O navegador informa a origin do site que faz a incorporação de um jeito que as páginas não conseguem forjar (postMessage event.origin), e o backend do Meeto verifica isso.
• A chave secreta mk_secret_… é armazenada com hash e mostrada apenas uma vez. Use-a exclusivamente de servidor para servidor.
• Uma chave vazada ou sem uso pode ser revogada no painel a qualquer momento — o widget para na hora.