Follow-ups

Agende mensagens de acompanhamento automaticas em conversas. Configure templates reutilizaveis, automacoes baseadas em triggers e regras de follow-up por estagio do pipeline.

Escopos de Follow-up

Follow-ups podem ser criados por conversa (scoped) ou gerenciados globalmente na conta. Templates e automacoes permitem escalar o processo de acompanhamento.

Follow-ups da Conversa

GET/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups

Lista follow-ups de uma conversa.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/conversations/42/follow-ups" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de follow-ups

json

{
  "data": [
    {
      "id": 1,
      "status": "pending",
      "scheduled_at": 1771596000,
      "message": "Ola! Gostaria de saber se teve chance de avaliar nossa proposta.",
      "title": null,
      "inbox_id": 1,
      "conversation_id": 42,
      "created_at": 1771212000
    }
  ]
}

GET/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups/count

Retorna contagem de follow-ups pendentes.

POST/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups

Agenda um novo follow-up para a conversa.

Body

Nome	Tipo	Obrigatorio	Descricao
`content`	`string`	Sim	Conteudo da mensagem de follow-up
`scheduled_at`	`string`	Sim	Data/hora de envio (ISO 8601)
`inbox_id`	`integer`	Sim	ID do inbox para envio
`title`	`string`	Nao	Titulo do follow-up
`follow_up_template_id`	`integer`	Nao	ID do template a usar

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/conversations/42/follow-ups" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Ola! Vi que ainda nao respondeu. Posso ajudar?",
    "scheduled_at": "2026-02-20T10:00:00Z",
    "inbox_id": 1
  }'

GET/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups/{id}

Retorna detalhes de um follow-up.

PATCH/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups/{id}

Atualiza um follow-up pendente.

DELETE/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups/{id}

Remove um follow-up.

POST/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups/{id}/cancel

Cancela um follow-up pendente sem remove-lo do historico.

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/conversations/42/follow-ups/1/cancel" \
  -H "api_access_token: YOUR_TOKEN"

POST/api/v1/accounts/{account_id}/conversations/{conversation_id}/follow-ups/{id}/retry_send

Reenvia um follow-up que falhou.

Apenas Follow-ups Falhados

So e possivel reenviar follow-ups com status "failed".

Follow-ups da Conta

GET/api/v1/accounts/{account_id}/follow-ups

Lista todos os follow-ups de toda a conta (todas as conversas).

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/follow-ups" \
  -H "api_access_token: YOUR_TOKEN" | jq .

Templates de Follow-up

Templates reutilizaveis com variaveis dinamicas para padronizar mensagens de acompanhamento.

GET/api/v1/accounts/{account_id}/follow-up-templates

Lista todos os templates.

200Lista de templates

json

{
  "data": [
    {
      "id": 3,
      "name": "Acompanhamento pos-proposta",
      "content": "Template de acompanhamento",
      "active": true,
      "items": [
        {
          "id": 1,
          "item_type": "text",
          "content": "Ola {{contact.name}}! Enviei a proposta ontem, teve chance de avaliar?",
          "position": 1,
          "delay_seconds": 0
        },
        {
          "id": 2,
          "item_type": "text",
          "content": "{{contact.name}}, gostaria de agendar uma call para discutir a proposta?",
          "position": 2,
          "delay_seconds": 86400
        }
      ],
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

GET/api/v1/accounts/{account_id}/follow-up-templates/variables

Lista variaveis disponiveis para uso nos templates.

200Variaveis disponiveis

json

{
  "data": {
    "contact": ["name", "email", "phone_number", "company"],
    "conversation": ["id", "status", "inbox_name"],
    "agent": ["name", "email"],
    "account": ["name"]
  }
}

POST/api/v1/accounts/{account_id}/follow-up-templates

Cria um novo template.

Body (follow_up_template)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome do template (unico por conta)
`content`	`string`	Sim	Conteudo do template (suporta variaveis como {{contact_name}})
`active`	`boolean`	Nao	Se o template esta ativo (padrao: true)

PATCH/api/v1/accounts/{account_id}/follow-up-templates/{id}

Atualiza um template.

DELETE/api/v1/accounts/{account_id}/follow-up-templates/{id}

Remove um template (soft delete).

Itens do Template

POST/api/v1/accounts/{account_id}/follow-up-templates/{template_id}/items

Adiciona um item (mensagem) ao template.

Body

Nome	Tipo	Obrigatorio	Descricao
`content`	`string`	Sim	Conteudo da mensagem (suporta variaveis como {{contact_name}})
`item_type`	`string`	Sim	Tipo do item: text, image, audio, video, document
`position`	`integer`	Sim	Posicao do item na sequencia (1, 2, 3...)
`delay_seconds`	`integer`	Nao	Delay em segundos apos o item anterior (padrao: 0). Ex: 86400 = 24h

PATCH/api/v1/accounts/{account_id}/follow-up-templates/{template_id}/items/{item_id}

Atualiza um item do template.

DELETE/api/v1/accounts/{account_id}/follow-up-templates/{template_id}/items/{item_id}

Remove um item do template.

POST/api/v1/accounts/{account_id}/follow-up-templates/{template_id}/items/reorder

Reordena itens do template.

Body

Nome	Tipo	Obrigatorio	Descricao
`item_ids`	`array`	Sim	IDs dos itens na nova ordem

POST/api/v1/accounts/{account_id}/follow-up-templates/{id}/preview

Pre-visualiza o template com variaveis substituidas.

Body

Nome	Tipo	Obrigatorio	Descricao
`contact_id`	`integer`	Sim	ID do contato para substituir variaveis

Automacoes de Follow-up

Configure triggers automaticos para iniciar sequencias de follow-up baseados em eventos.

GET/api/v1/accounts/{account_id}/follow-up-automations

Lista automacoes de follow-up.

POST/api/v1/accounts/{account_id}/follow-up-automations

Cria uma automacao de follow-up.

Body (follow_up_automation)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome da automacao (unico por conta)
`follow_up_template_id`	`integer`	Sim	ID do template a executar
`trigger_type`	`string`	Sim	Tipo de gatilho: label_added, label_removed, contact_created, conversation_created, conversation_resolved
`enabled`	`boolean`	Nao	Se a automacao esta ativa (padrao: true)
`delay_minutes`	`integer`	Nao	Delay em minutos antes de executar (padrao: 0)
`conditions`	`object`	Nao	Condicoes adicionais para filtrar quando a automacao dispara

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/follow-up-automations" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "follow_up_automation": {
      "name": "Follow-up pos-resolucao",
      "follow_up_template_id": 3,
      "trigger_type": "conversation_resolved",
      "enabled": true
    }
  }'

PATCH/api/v1/accounts/{account_id}/follow-up-automations/{id}

Atualiza uma automacao.

DELETE/api/v1/accounts/{account_id}/follow-up-automations/{id}

Remove uma automacao.

Regras de Follow-up por Pipeline

Configure follow-ups automaticos baseados na movimentacao de cards entre estagios do pipeline.

GET/api/v1/accounts/{account_id}/pipelines/{pipeline_id}/follow-up-rules

Lista regras de follow-up de um pipeline.

POST/api/v1/accounts/{account_id}/pipelines/{pipeline_id}/follow-up-rules

Cria uma regra de follow-up para o pipeline.

Body (pipeline_follow_up_rule)

Nome	Tipo	Obrigatorio	Descricao
`to_stage`	`string`	Sim	ID do estagio destino que aciona a regra (ex: "755_entrada_de_lead")
`follow_up_template_id`	`integer`	Sim	ID do template a executar
`from_stage`	`string`	Nao	ID do estagio de origem (opcional, filtra apenas cards vindos deste estagio)
`delay_minutes`	`integer`	Nao	Delay em minutos apos entrar no estagio (padrao: 0)
`enabled`	`boolean`	Nao	Se a regra esta ativa (padrao: true)

PATCH/api/v1/accounts/{account_id}/pipelines/{pipeline_id}/follow-up-rules/{id}

Atualiza uma regra.

DELETE/api/v1/accounts/{account_id}/pipelines/{pipeline_id}/follow-up-rules/{id}

Remove uma regra.