Skip to content

Sequência de Mensagens

Envia até 10 passos em sequência no mesmo chat (equivalente de atalho via API).

Endpoint

http
POST /api/{organizationId}/chat/{chatId}/message-sequence

Base URL: https://v1.api.interflow.chat

Autenticação

http
x-api-key: ak_sua_api_key

Body

CampoTipoObrigatórioDescrição
stepsarraySim1–10 passos
replyToMessageIdstring (UUID)NãoReply apenas no primeiro passo
auxiliaryChannelIdstring (UUID)NãoCanal auxiliar

Item de steps

CampoTipoDescrição
contentstringTexto (obrigatório se não houver anexos)
attachment_idsstring[]IDs de arquivos da org
url_attachmentsarrayAnexos por URL (legado)
delay_after_msnumberDelay após o passo (processamento assíncrono)
sign_message / signMessagebooleanAssinar mensagem (padrão efetivo depende das regras da org)
tempIdstringID temporário ecoado na resposta

Cada passo precisa de content ou anexos.

Exemplo

bash
curl -X POST "https://v1.api.interflow.chat/api/{organizationId}/chat/{chatId}/message-sequence" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ak_sua_api_key" \
  -d '{
    "steps": [
      { "content": "Olá! Bem-vindo." },
      {
        "content": "Segue nosso catálogo",
        "attachment_ids": ["file-uuid"],
        "delay_after_ms": 1000
      },
      { "content": "Qualquer dúvida, estamos à disposição." }
    ]
  }'

Resposta

Sucesso (201)

json
{
  "success": true,
  "sequenceId": "sequence-uuid",
  "messages": [
    { "id": "msg-1", "tempId": null, "sequenceIndex": 0 },
    { "id": "msg-2", "tempId": null, "sequenceIndex": 1 }
  ]
}

Erros

HTTPSituação
400steps inválido, vazio, > 10, ou passo sem conteúdo/anexo
401 / 403Auth / rota indisponível / IP negado

Relacionados

Documentación en constante actualización