Consultar status

Descrição

Retorna o status da sessão associada a um referenceId para um agente com canal personalizado. Este endpoint é uma consulta controlada: exige a mesma assinatura HMAC que enviar interação. A autenticação credentials.auth do canal não é exigida aqui (aplica-se apenas às chamadas de saída para o seu webhook).

Endpoint

POST https://chatbot.jelou.ai/v1/custom-channel/{botId}/status

Parâmetros de rota

string

obrigatório

Identificador do agente.

Parâmetros do corpo

string

obrigatório

Mesmo identificador de usuário usado ao enviar a interação.

Autenticação / assinatura

Inclua o header obrigatório:

X-Jelou-Signature: sha256=<HMAC_HEX>

A assinatura é calculada sobre o raw body exato da requisição (HMAC-SHA256). Detalhes em Assinatura HMAC.

Valores de `status`

Valor	Significado
`running`	Há uma execução do fluxo em andamento.
`pending_input`	O agente aguarda uma resposta do usuário.
`idle`	Não há execução ativa nem espera de input.

Exemplo de solicitação

cURL

curl --request POST \
  --url https://chatbot.jelou.ai/v1/custom-channel/BOT_ID/status \
  --header 'Content-Type: application/json' \
  --header 'X-Jelou-Signature: sha256=HMAC_HEX' \
  --data '{
    "referenceId": "user-123"
  }'

Respostas

Código	Status	Descrição
200	OK	Status retornado.
400	Bad Request	Falta `referenceId`.
401	Unauthorized	Assinatura inválida, ausente ou chave não resolvida.
500	Internal Server Error	Não foi possível ler o status.

Exemplo de resposta

{
  "status": "pending_input"
}

⌘I

Referência de API

Enviar Mensagens

Campanhas

Conversações

Métricas

Usuários

Recursos

Widget

Datum

Painel de Atendimento Externo

Canal Personalizado

Gestão de Memória

Descrição

Endpoint

Parâmetros de rota

Parâmetros do corpo

Autenticação / assinatura

Valores de `status`

Exemplo de solicitação

Respostas

Exemplo de resposta

​Descrição

​Endpoint

​Parâmetros de rota

​Parâmetros do corpo

​Autenticação / assinatura

​Valores de status

​Exemplo de solicitação

​Respostas

​Exemplo de resposta

Descrição

Endpoint

Parâmetros de rota

Parâmetros do corpo

Autenticação / assinatura

Valores de `status`

Exemplo de solicitação

Respostas

Exemplo de resposta