Como usar a Pendly

O Pendly transforma pendências que você manda no Discord em código pronto pra revisar no GitHub. Você descreve o ajuste num canal do servidor; o Pendly lê o repositório, prepara a alteração e abre um Pull Request pra você aprovar.

Ele foi feito pra servidores de FiveM e comunidades de roleplay que vivem de pequenas mudanças no código — mexer num preço dentro do config.lua, corrigir o comportamento de um script, ajustar uma permissão. Em vez de esperar o scripter aparecer, a equipe registra a pendência onde já conversa todo dia: o Discord.

O problema que ele resolve

• O scripter some. Você manda a pendência às 23h e a resposta vem só dias depois.
• As pendências empilham. São dezenas de mensagens num canal e ninguém sabe ao certo o que já foi feito e o que ficou pra trás.
• Sobra pra você. A noite vira uma sessão de editar config.lua e dar push no braço.

Como funciona, em alto nível

1. 1

   Você descreve a pendência num canal cadastrado

   Basta escrever no Discord o que precisa ser ajustado, como você já faria pro seu scripter. Sem comandos especiais.
2. 2

   O Pendly captura e analisa o repositório

   Assim que vê a mensagem, ele reage com 👀 pra sinalizar que assumiu a pendência. Em seguida, lê o código do repositório conectado e prepara a alteração.
3. 3

   Ele abre um Pull Request no GitHub

   A mudança entra num branch próprio e vira um Pull Request, com um resumo do que foi feito e um link de volta pro Pendly.
4. 4

   Você revisa e faz o merge

   Você confere o diff no GitHub e decide quando o ajuste entra no servidor. Quando o Pull Request é aberto, a reação na mensagem original vira ✅.

Pra quem é

O Pendly é pensado pra servidores de FiveM e RP que querem agilizar os ajustes do dia a dia sem depender da disponibilidade de um scripter. Ele entende os stacks mais comuns desse mundo — Lua, vRP, QBCore, Qbox e ESX.

Pra abrir Pull Requests no seu repositório, o Pendly precisa de acesso ao GitHub. Esse acesso é dado por um Personal Access Token (PAT) — uma credencial que você gera na sua conta do GitHub e cola no painel do Pendly.

O Pendly aceita os dois tipos de token do GitHub: o clássico e o fine-grained. O passo a passo abaixo usa o token clássico, que é o caminho mais direto.

1. Gerar o token no GitHub

1. 1

   Abra as configurações de desenvolvedor

   No GitHub, clique na sua foto (canto superior direito) e vá em Settings. No menu lateral, role até o fim e abra Developer settings.
2. 2

   Crie um novo token clássico

   Acesse Personal access tokens → Tokens (classic) e clique em Generate new token (classic).
3. 3

   Dê um nome e uma validade

   Em Note, escreva algo como Pendly pra lembrar pra que serve. Em Expiration, escolha um prazo — tokens com validade são mais seguros, e quando expirar basta gerar outro e rotacionar no Pendly.
4. 4

   Marque a permissão de repositório

   Marque o escopo repo. Ele cobre tudo o que o Pendly faz: ler o código, criar o branch da mudança e abrir o Pull Request. Se o seu repositório é privado, esse escopo é o que garante o acesso.
5. 5

   Gere e copie o token

   Clique em Generate token e copie o valor (ele começa com ghp_). O GitHub mostra o token uma única vez — copie antes de sair da página.

Alternativa: token fine-grained com permissão mínima

Se você prefere dar o mínimo de acesso possível, gere um fine-grained token em Developer settings → Personal access tokens → Fine-grained tokens. Ele permite limitar o acesso a um único repositório e escolher permissões específicas — é a opção recomendada pra quem quer escopo mínimo por repositório.

Em Repository access, escolha Only select repositories e selecione o repositório que vai conectar ao Pendly. Em Repository permissions, conceda:

• Contents — Read and write: pra clonar o repositório, criar o branch da mudança e commitar.
• Pull requests — Read and write: pra abrir o Pull Request com o ajuste.
• Metadata — Read-only: o GitHub concede sozinho, é obrigatório em qualquer fine-grained token.

O resto é igual ao token clássico: gere, copie o valor (ele começa com github_pat_) e cole no painel do Pendly.

2. Colar o token no Pendly

1. 1

   Abra a tela de conectar repositório

   No painel, vá em Repositórios e clique em Conectar.
2. 2

   Preencha o repositório e cole o token

   Informe um nome, o repositório no formato owner/repo (ex: minha-org/meu-servidor) e cole o PAT no campo indicado.
3. 3

   O Pendly valida na hora

   Ao salvar, o Pendly consulta o GitHub pra confirmar que o token tem acesso ao repositório. Se algo estiver errado, ele avisa na hora: token inválido ou expirado, token sem permissão pro repositório, ou repositório não encontrado.

Pra capturar as pendências, o Pendly precisa estar no seu servidor do Discord. O convite leva poucos segundos e usa o fluxo de autorização oficial do Discord — você não instala nada.

Convidar o Pendly

1. 1

   Abra o convite do Pendly

   Use o link de convite do Pendly. Se você já conectou um repositório, dá pra abrir o mesmo convite pelo card Convidar Pendly dentro do repositório, no painel.
2. 2

   Escolha o servidor

   No menu do Discord, selecione o servidor onde o Pendly vai trabalhar. O Discord só lista servidores onde você tem a permissão Gerenciar Servidor — então faça isso logado na conta de dono ou admin do servidor.
3. 3

   Autorize

   O convite já vem com as permissões que o Pendly precisa pré-selecionadas. É só revisar e clicar em Autorizar.
4. 4

   Confirme que ele entrou

   O Pendly passa a aparecer na lista de membros do servidor. Ele fica quieto até você conectar um canal a um repositório — nenhuma mensagem é lida antes disso.

O que o Pendly faz no servidor

As permissões do convite cobrem só o necessário pra ele trabalhar nos canais que você conectar:

• Ver os canais e ler as mensagens dos canais conectados, pra captar as pendências que a equipe escreve.
• Reagir nas mensagens com 👀, ✅, ❌, 🔒 e ❓, que é como ele te dá o status de cada pendência.
• Responder e abrir threads, usado quando ele precisa tirar uma dúvida sobre o que você pediu.

Com o bot no servidor, faltam duas ligações: dizer ao Pendly qual repositório ele cuida e qual canal do Discord alimenta esse repositório. São dois passos rápidos no painel.

1. Conectar o repositório

1. 1

   Abra a tela de repositórios

   No painel, vá em Repositórios e clique em Conectar.
2. 2

   Preencha os dados

   Informe um nome pra identificar o repositório, o caminho no formato owner/repo (ex: minha-org/meu-servidor) e cole o PAT do GitHub. Se ainda não gerou o token, veja o tópico Conectar o GitHub.
3. 3

   O Pendly valida na hora

   Ao salvar, ele consulta o GitHub pra confirmar que o token tem acesso ao repositório. Se algo estiver errado — token inválido, sem permissão ou repositório não encontrado — ele avisa na mesma tela.

2. Conectar o canal do Discord

Abra o repositório que você acabou de criar e adicione o canal onde a equipe vai escrever as pendências. O Pendly identifica o canal pelo ID dele — um número longo que o Discord chama de snowflake.

1. 1

   Ative o Modo de Desenvolvedor no Discord

   No Discord, vá em Configurações do Usuário → Avançado e ligue o Modo de Desenvolvedor. Ele libera a opção de copiar IDs.
2. 2

   Copie o ID do canal

   Clique com o botão direito no canal desejado e escolha Copiar ID do Canal. O painel também tem um atalho Como pegar IDs do Discord que repete esse passo a passo.
3. 3

   Cole no repositório

   No detalhe do repositório, adicione o canal colando o ID. Pronto: a partir daí, toda pendência escrita nesse canal vira trabalho pro Pendly.

Antes de testar, confira o básico: o Pendly está no servidor, o canal que você conectou existe nesse mesmo servidor e o bot consegue ver esse canal. Com tudo certo, mande uma pendência e o Pendly reage com 👀.

• O número de repositórios que você pode conectar depende do seu plano — veja Billing.
• Dá pra ligar mais de um canal ao mesmo repositório, se a equipe usa canais separados que apontam pro mesmo código.

O Pendly resolve bem o que está bem descrito. Uma pendência boa é específica e acionável: ela diz o que mudar, onde e qual o resultado esperado. Uma pendência vaga, no melhor caso, faz o Pendly parar pra perguntar; no pior, sai diferente do que você queria.

O que faz uma boa pendência

• Aponta o alvo. O arquivo, o script ou o recurso — quanto mais perto do código, melhor (ex: o item, o comando, o config.lua de um recurso).
• Diz o de/para. O valor ou comportamento atual e o que você quer no lugar.
• Descreve o resultado. O que deve acontecer no jogo depois do ajuste.

Exemplos lado a lado

Mudar um valor.

arruma o preço da água

no shop de comida, muda o preço do item water de 50 pra 35

Corrigir um comportamento.

o inventário tá bugado

no inventário, quando o player solta um item no chão a quantidade não diminui no slot. deveria descontar a quantidade solta.

Quando uma pendência é ambígua ou falta uma informação importante, o Pendly prefere perguntar a chutar. Ele abre uma thread na sua própria mensagem e faz as perguntas que precisa pra entregar o ajuste certo.

Como funciona

1. 1

   Ele troca a reação por ❓

   Em vez do 👀 de costume, a mensagem recebe ❓: é o sinal de que o Pendly está esperando você responder antes de continuar.
2. 2

   Abre uma thread com as perguntas

   Na mesma mensagem, ele cria uma thread e escreve o que precisa saber — no máximo quatro perguntas, sempre as mais objetivas possíveis.
3. 3

   Você responde na thread

   Responda dentro da thread, não no canal. Pode quebrar em várias mensagens — o Pendly espera alguns segundos depois da sua última resposta pra juntar tudo e seguir.
4. 4

   Ele reprocessa com o que você disse

   Com as respostas, o Pendly refaz a análise já com o contexto que faltava e, dando tudo certo, a reação vira ✅ com o PR pronto.

Se você não responder

• O Pendly espera 24 horas pela sua resposta na thread.
• Passado esse prazo, a pendência é marcada como erro, a thread é arquivada e você vê um aviso ⏰ no canal.
• Nada se perde: é só mandar a pendência de novo, de preferência já com a informação que faltava.

Quanto mais específica a pendência, menor a chance de cair em clarificação — na maioria dos casos, uma boa descrição já leva direto ao Pull Request.

Quando a reação na sua mensagem vira ✅, o Pendly terminou o ajuste. No modo padrão, ele abre um Pull Request no seu GitHub pra você revisar — e, a partir daí, o controle é todo seu: você decide quando entra.

O que o Pendly entrega

• Um branch próprio. No fluxo padrão, a mudança fica num branch separado — no padrão pendly/pendency-<id> — em vez de ir direto pra sua branch principal.
• Um Pull Request. Com título, um resumo do que foi alterado e um link de volta pro Pendly. O commit é assinado como Pendly, então fica fácil rastrear o que veio dele.
• O diff completo. A aba de arquivos do PR mostra exatamente o que mudou, linha por linha.

Como revisar e aprovar

Abra o PR pelo link da reação ou direto no GitHub. Leia o resumo, confira o diff na aba Files changed e, se estiver tudo certo, faça o merge como em qualquer outro Pull Request. Quem decide quando o ajuste entra no servidor é você.

No painel, em Pendências, cada pendência concluída guarda o resumo do que foi feito, a lista de arquivos alterados, o branch, o commit e — quando a entrega foi por PR — o link do Pull Request, útil pra acompanhar o histórico sem sair do Pendly.

Quando uma pendência não gera nenhuma alteração de código (porque o que foi pedido já estava resolvido, por exemplo), o Pendly também marca ✅, mas sem criar PR nem commit — não há o que mudar.

O Pendly é bom no que se propõe a fazer: transformar pendências de código em Pull Requests. Ser honesto sobre o que ele não faz é parte de manter essa confiança — então aqui vai a lista.

Fora do escopo, de propósito

• Não mexe em UI/NUI. Telas e interfaces de jogo (HTML/CSS/JS de NUI) são trabalho pra um dev humano. O Pendly foca em lógica de servidor — Lua, configs e scripts.
• Não faz merge sozinho. No modo padrão, toda mudança chega como Pull Request e quem aprova e coloca no servidor é você. Se o repositório estiver no modo push direto, o commit vai direto na branch — mas isso é uma configuração que você escolheu, não uma decisão do Pendly.
• Uma rodada de clarificação. Se a pendência continua ambígua depois das suas respostas, ele marca erro em vez de ficar perguntando.
• Não responde dúvidas no canal. Ele age sobre pendências que viram código — não funciona como um chat de perguntas e respostas sobre o projeto.

Limites técnicos

• Só GitHub. Por enquanto não há suporte a GitLab nem Bitbucket.
• Mensagens até 2.000 caracteres. Acima disso a pendência é rejeitada — quebre pedidos enormes em pendências menores.
• Sem trial gratuito. O uso depende de uma assinatura ativa. Veja os planos no tópico de Billing.

Esta lista é viva: conforme o produto evolui, alguns destes pontos mudam. Sentiu falta de algo? Fala com a gente no Discord — boa parte do roadmap nasce de pedido de cliente.

Cada plano inclui um número de pendências por mês. É a sua quota: o quanto o Pendly trabalha no ciclo antes de você precisar de mais. Ela é simples de acompanhar e reseta sozinha a cada mês.

Quanto cada plano inclui

• Starter — 100 pendências por mês.
• Pro — 300 pendências por mês.
• Scale — 500 pendências por mês.
• Enterprise — pendências ilimitadas.

O que conta como uma pendência

Conta toda pendência que o Pendly aceita pra processar — ou seja, a mensagem passou pelos filtros e virou trabalho de verdade. Coisas que não consomem quota:

• Mensagens ignoradas pelos filtros (muito curtas, só emoji, só link ou só menção).
• Mensagens acima de 2.000 caracteres, que são rejeitadas.
• Pendências bloqueadas por billing (quando a assinatura não está em dia).

O que acontece ao atingir o limite

Ao bater o teto do plano, o Pendly para de aceitar novas pendências até o próximo ciclo. As mensagens enviadas depois disso não viram trabalho, e ele avisa no canal — uma vez por dia, pra não poluir — sugerindo o upgrade do plano. As pendências que já estavam em andamento seguem normalmente.

Você acompanha o consumo do ciclo a qualquer momento na página de Billing do painel, com o número de pendências usadas e o total do plano.

São quatro planos, do servidor pequeno ao que roda em alto volume. Você gerencia tudo — assinatura, upgrade, downgrade e recibos — na página de Billing do painel.

Os planos

• Starter — R$ 150/mês. 100 pendências por mês, 1 repositório.
• Pro — R$ 300/mês. 300 pendências, 2 repositórios. É o mais popular.
• Scale — R$ 500/mês. 500 pendências, 4 repositórios.
• Enterprise — a combinar. Pendências e repositórios ilimitados. Falar com vendas pelo Discord.

Pagamento e renovação

A assinatura é paga no cartão, com renovação mensal automática: a cada ciclo, a quota de pendências zera e a cobrança se repete enquanto a assinatura estiver ativa. Cobranças avulsas, como o ajuste proporcional de um upgrade no meio do ciclo, são feitas à parte via PIX.

Upgrade

O upgrade vale na hora. Você paga só a diferença proporcional aos dias que faltam no ciclo atual — uma cobrança avulsa via PIX, com o valor calculado e mostrado antes de confirmar. O ciclo de renovação continua o mesmo; muda o teto do plano.

Downgrade

O downgrade é agendado pro fim do ciclo: você continua no plano atual até lá, sem cobrança extra, e o plano menor passa a valer no próximo ciclo (com a nova quota). Mudou de ideia? Dá pra cancelar o downgrade agendado antes de ele entrar em vigor, direto no painel.

Cancelamento

Quer encerrar a assinatura? Fale com o suporte pelo Discord e a nossa equipe cuida do cancelamento com você.

Na maioria das vezes a reação na sua mensagem já diz o que aconteceu. Aqui estão os tropeços mais comuns e como resolver cada um.

O Pendly não reagiu à minha mensagem

Se não apareceu nem o 👀, a mensagem provavelmente nem chegou a virar pendência. Verifique, em ordem:

• O canal está conectado? O Pendly só lê canais vinculados a um repositório. Veja Conectar repositório e canal.
• O bot está no servidor? Confira se o Pendly aparece na lista de membros.
• A mensagem foi filtrada? Textos com menos de 10 caracteres, só com emoji, só com link ou só com menção são ignorados de propósito.
• A quota acabou? Ao bater o limite do plano, novas pendências param de ser aceitas até o próximo ciclo. Veja Quotas.

Apareceu o 🔒

O cadeado é sempre billing: a assinatura está aguardando pagamento, suspensa ou cancelada. Regularize em Billing e o Pendly volta a processar normalmente.

Apareceu o ❌

O ❌ marca um erro no processamento. As causas mais comuns:

• PAT inválido ou expirado. O token do GitHub perdeu a validade ou foi revogado. Gere um novo e rotacione o PAT na tela do repositório.
• Token sem permissão. O PAT não tem acesso de escrita ao repositório. Revise os escopos no tópico Conectar o GitHub.
• Repositório não encontrado. O caminho owner/repo está errado ou o token não enxerga esse repositório.
• Clarificação sem resposta. Se o Pendly abriu uma thread e ninguém respondeu em 24h, a pendência vira erro. Veja Como o bot pede clarificação.

O detalhe de cada pendência em Pendências traz a mensagem de erro específica. Depois de corrigir a causa, é só reenviar a pendência. Pendências em erro também podem ser marcadas como resolvidas manualmente no painel, pra organizar o quadro.

Respostas curtas e diretas pras dúvidas que mais aparecem. Não achou a sua? Manda no Discord.

Preciso saber programar?

Pra criar pendências, não — você escreve em português, como explicaria a um scripter. Ajuda ter noção básica do GitHub na hora de revisar e fazer o merge do Pull Request, mas o ajuste em si é o Pendly que prepara.

O Pendly faz merge sozinho?

Não. No modo padrão, toda mudança chega como Pull Request pra você revisar e aprovar — nada entra sem o seu merge. Se preferir agilidade, dá pra configurar o repositório no modo push direto, em que o commit vai direto na branch; mas é uma escolha sua, não uma decisão do Pendly. Veja Como ler o PR gerado.

É seguro dar meu PAT?

Sim. O token é guardado cifrado com AES-256-GCM, nunca é exibido de volta depois de salvo e você pode revogá-lo no GitHub a qualquer momento. Se quiser dar o mínimo de acesso possível, use um token fine-grained limitado a um repositório, como mostra o tópico Conectar o GitHub.

Com quais linguagens o Pendly trabalha?

Ele é feito pro mundo FiveM: Lua e os frameworks mais usados — vRP, QBCore, Qbox e ESX — além de configs e scripts de servidor.

Funciona com GitLab ou Bitbucket?

Por enquanto, só GitHub.

O Pendly garante que o código não vai quebrar?

Nenhuma ferramenta garante isso sozinha — e é por isso que o modo padrão entrega via Pull Request: você revisa o diff e testa antes que qualquer coisa entre no servidor. Se algo não ficou bom, é só não fazer o merge. No modo push direto a mudança vai direto pra branch, então use-o quando já confia no fluxo e tem como testar depois.

Tem trial gratuito?

Não. O uso depende de uma assinatura ativa — veja os planos em Billing.

O que acontece se eu estourar a quota?

O Pendly para de aceitar novas pendências até o próximo ciclo e avisa no canal. Pra liberar na hora, faça upgrade do plano — o teto maior vale imediatamente. Detalhes em Quotas.

Posso usar em mais de um servidor ou repositório?

Pode. A quantidade de repositórios conectados depende do seu plano, e um mesmo repositório pode receber pendências de mais de um canal do Discord.