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

# Visão geral

> Conceitos do Chat e como as mensagens são enviadas

A API de Chat permite enviar mensagens para contatos através das conexões da sua empresa.

## Conceitos

<AccordionGroup>
  <Accordion title="Conexão" icon="plug">
    Um canal ativo pelo qual as mensagens saem, hoje uma conta de WhatsApp vinculada ao Hust. Cada conexão tem um `id` e um `uuid`, e você identifica a conexão por qualquer um dos dois ao enviar uma mensagem.

    Só conexões ativas conseguem enviar. Consulte `GET /connection` para listar as conexões da sua empresa e verificar o campo `active` de cada uma.
  </Accordion>

  <Accordion title="Contato" icon="user">
    O destinatário da mensagem. Pode ser identificado pelo `id`, se o contato já existe no Hust, ou pelo `phone`, com DDI e DDD. Por exemplo: `5541988887777`.
  </Accordion>

  <Accordion title="Departamento" icon="users">
    Agrupamento interno de atendentes. É opcional no envio. Quando você informa um departamento, a mensagem fica associada a ele, e o usuário autenticado precisa pertencer ao departamento indicado.
  </Accordion>
</AccordionGroup>

## Fluxo de envio

<Steps>
  <Step title="Autentique-se">
    Obtenha um token em `POST /auth`. Veja [Autenticação](/autenticacao).
  </Step>

  <Step title="Descubra a conexão">
    Chame `GET /connection` e escolha uma conexão com `active: true`. Guarde o `uuid`, que é estável e pode ficar fixo na sua integração.
  </Step>

  <Step title="Envie a mensagem">
    Chame `POST /message/send` com a conexão, o contato e o texto. Veja [Enviar mensagem](/chat/enviar-mensagem).
  </Step>
</Steps>