O Wiring Lab

O Wiring Lab é onde você conecta um persona a um engine. Essa conexão se chama link — ela emparelha exatamente um persona com um engine, para que o engine rode com a voz daquele persona. Cada link recebe seu próprio api_slug, um identificador único para aquele wiring específico, para que a plataforma sempre saiba a qual combinação de persona-e-engine uma requisição pertence.

Para conectar um link:

Abra o Wiring Lab e escolha o persona que você quer colocar online.
Arraste um engine da biblioteca para a tela para vinculá-lo àquele persona.
Clique em Salvar (o botão Confirmar Wiring) para persistir o link. Até você confirmar, o wiring não é salvo.

Você pode conectar vários links persona-engine em uma conta — cada um é sua própria conexão com seu próprio api_slug.

Chaves API

Uma chave API é como um bot ou integração externa se autentica no FluidTalk. Existem duas formas de criá-la:

Criar — gere uma chave simples, válida para toda a conta que ainda não está vinculada a nenhum persona ou engine.
Provisionar — gere uma chave que já está vinculada a um persona e engine específicos em uma única etapa. Este é o caminho recomendado , pois uma chave já vinculada está pronta para atender tráfego ao vivo.

Você gerencia as chaves no Wiring Lab:

Vincular / escopo de uma chave — associe uma chave de conta existente a um persona e engine (e opcionalmente renomeie-a). Uma chave nunca vinculada não pode atender chamadas ao vivo.
Listar — veja todas as chaves da conta.
Revogar — exclua uma chave para que não possa mais ser usada.

Atenção

O segredo de uma chave API é exibido apenas uma vez, no momento em que é criada. Copie-o naquele momento e guarde em um lugar seguro — se você perdê-lo, não poderá vê-lo novamente. Basta revogar essa chave e criar uma nova.

Atenção

Uma chave deve estar vinculada a um persona (e engine) antes de poder atender tráfego ao vivo. Uma chave não vinculada e válida para toda a conta é rejeitada em chamadas ao vivo — provisione uma chave vinculada, ou associe uma existente, primeiro.

Checklist para ir ao vivo

Quando os quatro forem verdadeiros, você está no ar:

Persona pronto — identidade e fotos configuradas.
Engine vinculado — o engine conectado ao persona e confirmado no Wiring Lab.
Uma chave API vinculada — provisionada (ou associada) exatamente a aquele persona e engine.
Aponte seu bot para o handshake — sua integração envia cada mensagem recebida para o endpoint de handshake ao vivo, passando a chave no header X-API-Key . O FluidTalk responde com a próxima mensagem e ação a executar.

Para os endpoints exatos, campos de requisição e respostas, veja a Referência da API de desenvolvedor.

Dica

Você não precisa ir ao vivo para experimentar. Execute a conversa inteira no simulador integrado primeiro — mesmo engine, sem chave e sem tráfego real — depois conecte quando ele se comportar da forma que você quer.

Atenção

O atendimento ao vivo requer um plano pagoativo. Uma conta gratuita ou expirada é recusada no handshake, então seu bot para de funcionar no momento em que o plano encerra. Veja Cobrança e planos.

Guias relacionados

Engine builder — projete a conversa antes de conectá-la.
Testes no simulador — teste o engine de ponta a ponta sem chave.
Referência da API de desenvolvedor — as chamadas e headers exatos do handshake.
Cobrança e planos — o que um plano pago desbloqueia para o atendimento ao vivo.