> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tartini.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Use o Tartini como canal do seu sistema

> Gere tokens de acesso para integrar seus próprios sistemas diretamente com o Tartini.

export const Artigo = ({titulo, href, children}) => <a className="lista-artigos-item" href={href}>
    <span className="lista-artigos-texto">
      <span className="lista-artigos-nome">{titulo}</span>
      {children ? <span className="lista-artigos-desc">{children}</span> : null}
    </span>
    <svg className="lista-artigos-seta" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">
      <path d="M9 6l6 6-6 6" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
    </svg>
  </a>;

export const Lista = ({titulo, children}) => <div className="lista-artigos">
    {titulo ? <p className="lista-artigos-titulo">{titulo}</p> : null}
    <div className="lista-artigos-itens">{children}</div>
  </div>;

Com um token de API, o seu sistema conversa diretamente com o Tartini, sem precisar de ninguém abrindo a tela.

<Note>Quem gera e revoga tokens: só o Administrador. Disponível no plano Scale.</Note>

***

## Para que serve

Um token de API dá ao seu sistema acesso à API pública do Tartini, com funcionalidades de inteligência artificial e busca na base de conhecimento. Os detalhes técnicos de uso da API ficam com quem desenvolve o seu sistema.

Onde fica: **Configurações > Canais > Conexão via API**.

<Note>
  Mantenha seus tokens em segurança e nunca os compartilhe. Quem tiver o token consegue acessar sua conta pela API, do mesmo jeito que você.
</Note>

***

## Um token por sistema

É possível criar mais de um token, um para cada sistema integrado, com um nome que identifica onde cada um é usado, como "Integração ERP".

Cada token é revogado de forma independente: revogar o de um sistema não afeta os demais.

***

## Gere um token

Por padrão, uma conta nova não tem nenhum token criado.

<Steps>
  <Step title="Abra a tela">Vá em **Configurações > Canais > Conexão via API**.</Step>
  <Step title="Comece um novo token">Clique em **Criar Token**.</Step>
  <Step title="Nomeie o token">Preencha **Nome do Token**, para identificar depois onde ele é usado, e opcionalmente uma **Descrição**.</Step>
  <Step title="Crie">Clique em **Criar Token**.</Step>
  <Step title="Copie e guarde">Clique em **Copiar** e guarde o token em local seguro.</Step>
</Steps>

<Warning>
  O token só é exibido uma vez, no momento da criação. Se perder, não tem como recuperar: crie um novo e revogue o antigo.
</Warning>

***

## Acompanhe seus tokens

Cada token cadastrado mostra o nome, a descrição, quando foi criado e a última vez que foi usado, ou **Nunca**, se ainda não foi usado.

***

## Revogue um token

<Steps>
  <Step title="Abra a tela">Vá em **Configurações > Canais > Conexão via API**.</Step>
  <Step title="Exclua o token">Clique no ícone de lixeira no card do token.</Step>
  <Step title="Confirme">Clique em **Excluir**.</Step>
</Steps>

<Warning>
  Depois de revogado, o token deixa de funcionar e qualquer sistema que o usava perde o acesso.
</Warning>

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quem pode criar ou revogar tokens?">
    Só o Administrador.
  </Accordion>

  <Accordion title="Perdi o token antes de copiar. Como recupero?">
    Não é possível recuperar um token depois de fechar o modal. Crie um novo e revogue o antigo, se ele não estiver em uso.
  </Accordion>

  <Accordion title="Os tokens expiram sozinhos?" />

  <Accordion title="Preciso de um token diferente para cada sistema que eu integrar?">
    Não. Você pode usar um único token em vários sistemas ou criar um para cada um. Tokens separados facilitam identificar onde cada um é usado e permitem revogar o acesso de um sistema sem afetar os outros.
  </Accordion>
</AccordionGroup>

***

## Artigos relacionados

<Lista>
  <Artigo titulo="Receba eventos no seu sistema" href="/integracoes/webhooks">Avisos automáticos de atendimento finalizado.</Artigo>
  <Artigo titulo="Canais explicados" href="/canais/canais-explicados">Os canais disponíveis no Tartini.</Artigo>
</Lista>


## Related topics

- [Receba eventos no seu sistema](/integracoes/webhooks.md)
- [Dispare campanhas por webhook ou por mensagem recebida](/campanhas/webhook-e-inbound.md)
- [Canais explicados](/canais/canais-explicados.md)