Início Rápido

Este guia rápido vai te ajudar a fazer sua primeira integração com o Triglit.

Pré-requisitos

Conta no Triglit (obtenha em triglit.com)
Chaves de API (pública e/ou secreta)
Node.js instalado (para usar o SDK JavaScript/TypeScript)

Passo 1: Obter suas Chaves de API

Acesse o Dashboard do Triglit
Navegue até Configurações → API Keys
Copie suas chaves:
- Chave Pública (pk_…) - Para uso no frontend
- Chave Secreta (sk_…) - Para uso no backend

Nunca exponha sua chave secreta no frontend ou em repositórios públicos. Use apenas a chave pública no frontend.

Passo 2: Instalar o SDK

Instale o SDK oficial do Triglit:

npm install triglit

Passo 3: Fazer sua Primeira Requisição

Vamos listar os triggers do seu tenant:

curl -X GET "https://api.triglit.com/v1/gateway/triggers" \
  -H "X-API-Key: pk_seu_token_aqui" \
  -H "Content-Type: application/json"

import Triglit from 'triglit';

const client = new Triglit({ apiKey: 'pk_seu_token_aqui' });
const triggers = await client.triggers.list();
console.log(triggers);

import requests

headers = {
    'X-API-Key': 'pk_seu_token_aqui',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.triglit.com/v1/gateway/triggers',
    headers=headers
)

triggers = response.json()
print(triggers)

Passo 4: Criar seu Primeiro Workflow

Vamos criar um workflow para processar pedidos:

curl -X POST "https://api.triglit.com/v1/gateway/workflows" \
  -H "X-API-Key: sk_seu_token_secreto_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Processar Pedido",
    "description": "Workflow para processar pedidos de clientes"
  }'

import Triglit from 'triglit';

const client = new Triglit({ apiKey: 'sk_seu_token_secreto_aqui' });
const workflow = await client.workflows.create({
  name: 'Processar Pedido',
  description: 'Workflow para processar pedidos de clientes'
});
console.log(workflow);

import requests

headers = {
    'X-API-Key': 'sk_seu_token_secreto_aqui',
    'Content-Type': 'application/json'
}

data = {
    'name': 'Processar Pedido',
    'description': 'Workflow para processar pedidos de clientes'
}

response = requests.post(
    'https://api.triglit.com/v1/gateway/workflows',
    headers=headers,
    json=data
)

workflow = response.json()
print(workflow)

Passo 5: Criar uma Versão do Workflow

Agora vamos criar uma versão do workflow com nodes e edges:

curl -X POST "https://api.triglit.com/v1/gateway/workflow-versions" \
  -H "X-API-Key: sk_seu_token_secreto_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowId": "workflow_id_aqui",
    "nodes": [
      {
        "id": "node-1",
        "type": "trigger_webhook",
        "config": {
          "path": "/pedido"
        }
      },
      {
        "id": "node-2",
        "type": "transform",
        "config": {
          "transformType": "expression",
          "expression": "{ ...input, status: \"processed\" }"
        }
      }
    ],
    "edges": [
      {
        "source": "node-1",
        "target": "node-2"
      }
    ]
  }'

import Triglit from 'triglit';

const client = new Triglit({ apiKey: 'sk_seu_token_secreto_aqui' });
const version = await client.workflows.versions.create({
  workflowId: 'workflow_id_aqui',
  nodes: [
    {
      id: 'node-1',
      type: 'trigger_webhook',
      config: {
        path: '/pedido'
      }
    },
    {
      id: 'node-2',
      type: 'transform',
      config: {
        transformType: 'expression',
        expression: '{ ...input, status: "processed" }'
      }
    }
  ],
  edges: [
    {
      source: 'node-1',
      target: 'node-2'
    }
  ]
});
console.log(version);

import requests

headers = {
    'X-API-Key': 'sk_seu_token_secreto_aqui',
    'Content-Type': 'application/json'
}

data = {
    'workflowId': 'workflow_id_aqui',
    'nodes': [
        {
            'id': 'node-1',
            'type': 'trigger_webhook',
            'config': {
                'path': '/pedido'
            }
        },
        {
            'id': 'node-2',
            'type': 'transform',
            'config': {
                'transformType': 'expression',
                'expression': '{ ...input, status: "processed" }'
            }
        }
    ],
    'edges': [
        {
            'source': 'node-1',
            'target': 'node-2'
        }
    ]
}

response = requests.post(
    'https://api.triglit.com/v1/gateway/workflow-versions',
    headers=headers,
    json=data
)

version = response.json()
print(version)

Passo 6: Criar um Trigger

Agora vamos criar um trigger para iniciar o workflow:

curl -X POST "https://api.triglit.com/v1/gateway/triggers" \
  -H "X-API-Key: sk_seu_token_secreto_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowVersionId": "workflow_version_id_aqui",
    "type": "webhook",
    "isActive": true
  }'

import Triglit from 'triglit';

const client = new Triglit({ apiKey: 'sk_seu_token_secreto_aqui' });
const trigger = await client.triggers.create({
  workflowVersionId: 'workflow_version_id_aqui',
  type: 'webhook',
  isActive: true
});
console.log(trigger);

import requests

headers = {
    'X-API-Key': 'sk_seu_token_secreto_aqui',
    'Content-Type': 'application/json'
}

data = {
    'workflowVersionId': 'workflow_version_id_aqui',
    'type': 'webhook',
    'isActive': True
}

response = requests.post(
    'https://api.triglit.com/v1/gateway/triggers',
    headers=headers,
    json=data
)

trigger = response.json()
print(trigger)

Próximos Passos

Conceitos Fundamentais

Aprenda sobre workflows, nodes e triggers

Referência da API

Explore todos os endpoints disponíveis

Guias de Integração

Veja exemplos práticos de integração

Custom Nodes

Crie nodes personalizados para seus workflows

Use a chave pública (pk_) no frontend e a chave secreta (sk_) no backend. A chave secreta tem mais permissões e deve ser mantida em segurança.

​Pré-requisitos

​Passo 1: Obter suas Chaves de API

​Passo 2: Instalar o SDK

​Passo 3: Fazer sua Primeira Requisição

​Passo 4: Criar seu Primeiro Workflow

​Passo 5: Criar uma Versão do Workflow

​Passo 6: Criar um Trigger

​Próximos Passos

Conceitos Fundamentais

Referência da API

Guias de Integração

Custom Nodes

Pré-requisitos

Passo 1: Obter suas Chaves de API

Passo 2: Instalar o SDK

Passo 3: Fazer sua Primeira Requisição

Passo 4: Criar seu Primeiro Workflow

Passo 5: Criar uma Versão do Workflow

Passo 6: Criar um Trigger

Próximos Passos