> ## 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.

# Receba eventos no seu sistema

> Configure um aviso automático no seu sistema sempre que um atendimento for finalizado no 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 o webhook ativado, seu sistema recebe um aviso automático assim que uma conversa termina, sem precisar consultar o Tartini.

<Note>Quem configura: só o Administrador. Disponível no plano Scale.</Note>

***

## O que é o webhook de Finalização de Atendimento

Hoje o Tartini envia um evento: a finalização de um atendimento, em qualquer canal. O aviso chega com os dados do contato (incluindo o ID externo, se você usa um), o motivo do encerramento e, se você quiser, o resumo do Tino, o histórico de mensagens e a nota de satisfação.

Onde fica: **Configurações > Integrações > Webhooks > Finalização de Atendimento**.

***

## Cadastre a URL do seu sistema

Por padrão o webhook fica desligado.

<Steps>
  <Step title="Abra a tela">Vá em **Configurações > Integrações > Webhooks** e clique no card **Finalização de Atendimento**.</Step>
  <Step title="Informe a URL">Preencha **URL do webhook** com o endereço do seu sistema.</Step>
  <Step title="Gere o secret de assinatura">Clique em **Gerar novo secret** e copie o valor gerado. Compartilhe com quem cuida do seu sistema: ele confirma que o aviso realmente veio do Tartini.</Step>
  <Step title="Ative">Ative **Ativar webhook** e clique em **Salvar**.</Step>
</Steps>

<Note>
  O secret só passa a valer depois de clicar em **Salvar**. Gerar um novo secret invalida o anterior.
</Note>

***

## Escolha o que enviar

Conversa e contato sempre vão no aviso. Você decide o que mais incluir:

* **Resumo do Tino**: pode atrasar alguns minutos, o tempo de o Tino gerar o resumo.
* **Histórico de mensagens**: todas as mensagens trocadas na conversa.
* **Nota CSAT**: a avaliação de satisfação do cliente, quando coletada.

Ative também **Registrar apenas atendimentos relevantes** para não receber avisos de conversas triviais, como um cumprimento sem continuação.

***

## Teste o disparo

<Steps>
  <Step title="Salve a URL primeiro">Garanta que **URL do webhook** está preenchida e salva.</Step>
  <Step title="Dispare o teste">Clique em **Testar webhook**.</Step>
  <Step title="Confira no seu sistema">Veja se o seu sistema recebeu o aviso de teste.</Step>
</Steps>

<Note>
  Os detalhes técnicos do payload, como os campos exatos e os cabeçalhos de segurança, ficam com quem desenvolve o seu sistema.
</Note>

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quando exatamente o aviso é enviado?">
    Quando a conversa é finalizada de fato, seja por encerramento manual, pela pesquisa de satisfação ou pelo encerramento automático por inatividade.
  </Accordion>

  <Accordion title="Posso cadastrar mais de um endereço?">
    Hoje a tela aceita um endereço por vez para o evento de Finalização de Atendimento.
  </Accordion>

  <Accordion title="Trocar o secret afeta o que já está funcionando?">
    Sim. Ao gerar um novo secret, o anterior deixa de valer. Atualize o secret no seu sistema antes de trocar por aqui, ou os avisos deixam de ser confirmados como autênticos.
  </Accordion>
</AccordionGroup>

***

## Artigos relacionados

<Lista>
  <Artigo titulo="Use o Tartini como canal do seu sistema" href="/integracoes/conexao-via-api">Gere tokens para integrar seus sistemas.</Artigo>
  <Artigo titulo="Canais explicados" href="/canais/canais-explicados">Os canais disponíveis no Tartini.</Artigo>
</Lista>


## Related topics

- [Webhook de Atendimento](/desenvolvedores/webhook-de-atendimento.md)
- [Instale o Chat Widget no seu site](/canais/chat-widget.md)
- [Use o Tartini como canal do seu sistema](/integracoes/conexao-via-api.md)