SDK oficial
Uma dependência, uma credencial e o contrato inteiro. É a camada oficial, e a única que esta documentação ensina.
const app = createApp();Primeiro AppPortal de desenvolvedores
Construa para o Trivo.
Este portal é onde você cria os seus Apps, guarda a credencial deles e lê a documentação da API. O App em si roda na sua infraestrutura, com o SDK oficial, que é o caminho suportado.
A conta é a mesma do aplicativo, sem cadastro separado. Para criar Apps é preciso ter o e-mail confirmado e os termos de uso aceitos; se faltar algum dos dois, o Trivo pede antes de trazer você de volta.
Comece por aqui
Do zero ao primeiro evento, em três passos. A documentação é pública: dá para ler tudo antes de decidir criar conta de App nenhuma.
Crie o App no painel
Nome, descrição e a credencial, que aparece uma vez só. É ela que o seu programa carrega para falar com o Trivo.
Entrar com TrivoInstale o SDK oficial
Ele lê a credencial do ambiente, assina o que precisa ser assinado, reconecta e respeita o ritmo sem você escrever nada disso.
A credencial e o SDKSuba o primeiro App
Um arquivo, uma conexão, e o primeiro evento do Trivo chegando na sua máquina.
Primeiro App
O que o SDK põe na sua mão
Quatro superfícies, um contrato só. Assinatura de entrega, reconexão, retomada, ritmo e ordenação são do SDK, e é por isso que existe um caminho oficial em vez de dois.
Comandos
O que aparece na barra de digitar do Trivo: o nome, as opções tipadas e a permissão que o comando exige de quem o aciona.
app.rest.createCommand(…)ComandosGateway
O Trivo empurra os eventos para você. Batimento, retomada e recuo são do SDK, e não do seu código.
app.on("message_create", …)Gateway e eventosInterações
Alguém aciona algo do seu App e você tem poucos segundos para responder. Chega pelo Gateway ou por um POST assinado, e o seu código é o mesmo.
app.onInteraction(…)Interações e componentesGerencie seus Apps
O painel guarda a credencial, o que o App declara precisar, o link de instalação e o endpoint de interações.
Entre com a sua conta do Trivo para criar o primeiro App. A documentação continua aberta a quem só quer ler.
Entrar com TrivoExplore a documentação por categoria
Tudo o que existe hoje, agrupado pelo assunto de quem procura. Nenhuma página exige sessão.
Introdução
O que é um App do Trivo, e o caminho até o primeiro evento.
Apps
A identidade do App: a credencial que ele carrega e o alcance que ele pede.
SDK
Instalar, configurar e chamar: o pacote que é o caminho oficial de construir App.
Gateway e eventos
Ouvir o que acontece: a conexão, o catálogo e o que cada intent abre.
Comandos e interações
Quando alguém aciona o seu App: o prazo, a resposta e o que se desenha.
Segurança
O que prova que a entrega é nossa, e até onde um App chega.
Referência
O que se consulta com pressa, no meio de uma depuração.