simpla.fydocs

Create SDR interaction

Cria uma nova interação SDR e atualiza a tabela sell com informações de contato e qualificação. **Identificação do Contato:** O agente SDR deve fornecer **UM** dos seguintes campos para identificar o lead: - `phone`: Número de telefone do lead (formato brasileiro, com ou sem código 55) - Exemplo: `"5511999999999"` ou `"11999999999"` - `session_id`: UUID da sessão web (formato: Lia-{uuid}) - Exemplo: `"Lia-2a08196b-ac9a-4984-9f78-a681cf3653c3"` - Use quando o contato veio do chat web (sem telefone disponível) **Campos Obrigatórios:** - `phone` OU `session_id` (um dos dois) - `channel`: Canal usado ('whatsapp', 'sms', 'email') - `result`: Resultado da interação ('interested', 'not_interested', 'no_response', 'callback_requested', 'converted') **Comportamento:** - Busca pessoa existente pelo telefone (com matching flexível) ou cria pessoa mínima se não existir - Para UUIDs web, cria pessoa mínima automaticamente - Cria/atualiza registro em `sdr_interactions` - Atualiza tabela `sell` com informações de contato e qualificação - Sincroniza dados entre ambas as tabelas automaticamente - Evita duplicatas (atualiza se houver interação recente para o mesmo telefone/pessoa) **Exemplos de Uso:** 1. **Contato por telefone - Lead interessado:** - Fornece `phone` - Define `contact: true` e `result: "interested"` 2. **Contato por telefone - Lead qualificado:** - Fornece `phone` - Define `contact: true`, `sent: true`, `sent_to`, `converted_to_lead: true` 3. **Contato web (UUID) - Lead interessado:** - Fornece `session_id` (formato: Lia-{uuid}) - Define `contact: true` e `result: "interested"` 4. **Contato web (UUID) - Lead qualificado:** - Fornece `session_id` - Define `contact: true`, `sent: true`, `sent_to`, `converted_to_lead: true`

POST
/sdr/interactions

Cria uma nova interação SDR e atualiza a tabela sell com informações de contato e qualificação.

Identificação do Contato:

O agente SDR deve fornecer UM dos seguintes campos para identificar o lead:

  • phone: Número de telefone do lead (formato brasileiro, com ou sem código 55)
    • Exemplo: "5511999999999" ou "11999999999"
  • session_id: UUID da sessão web (formato: Lia-{uuid})
    • Exemplo: "Lia-2a08196b-ac9a-4984-9f78-a681cf3653c3"
    • Use quando o contato veio do chat web (sem telefone disponível)

Campos Obrigatórios:

  • phone OU session_id (um dos dois)
  • channel: Canal usado ('whatsapp', 'sms', 'email')
  • result: Resultado da interação ('interested', 'not_interested', 'no_response', 'callback_requested', 'converted')

Comportamento:

  • Busca pessoa existente pelo telefone (com matching flexível) ou cria pessoa mínima se não existir
  • Para UUIDs web, cria pessoa mínima automaticamente
  • Cria/atualiza registro em sdr_interactions
  • Atualiza tabela sell com informações de contato e qualificação
  • Sincroniza dados entre ambas as tabelas automaticamente
  • Evita duplicatas (atualiza se houver interação recente para o mesmo telefone/pessoa)

Exemplos de Uso:

  1. Contato por telefone - Lead interessado:

    • Fornece phone
    • Define contact: true e result: "interested"
  2. Contato por telefone - Lead qualificado:

    • Fornece phone
    • Define contact: true, sent: true, sent_to, converted_to_lead: true
  3. Contato web (UUID) - Lead interessado:

    • Fornece session_id (formato: Lia-{uuid})
    • Define contact: true e result: "interested"
  4. Contato web (UUID) - Lead qualificado:

    • Fornece session_id
    • Define contact: true, sent: true, sent_to, converted_to_lead: true
x-api-key<token>

In: header

Request Body

application/json

Dados da interação SDR. Use phone para contatos por telefone ou session_id para contatos web (UUID).

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/sdr/interactions" \  -H "Content-Type: application/json" \  -d '{    "phone": "5511999999999",    "channel": "whatsapp",    "result": "interested",    "contact": true,    "interaction_notes": "Cliente respondeu positivamente e demonstrou interesse em seguro"  }'
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "message": "SDR interaction created successfully"
}
{
  "statusCode": 400,
  "message": "Either phone or session_id must be provided",
  "error": "Bad Request"
}
{
  "statusCode": 401,
  "message": "Unauthorized"
}