Atividades
Endpoints para registro de interações e atividades com clientes.
Registrar Atividade de Cliente
POST /api/activities
Cria uma nova atividade (ex: interação por email, SMS ou WhatsApp) para um cliente e atualiza suas informações de último contato.
Casos de uso:
- Registrar follow-up após feedback negativo
- Documentar comunicações de campanha
- Manter histórico de interações com cliente
Corpo da Requisição
json
{
"client_id": "ef9fa264-3850-4bd2-875e-2b40a4dd432f",
"name": "Envio de mensagem de boas-vindas",
"description": "Foi enviado um WhatsApp com informações do programa de fidelidade",
"type": "whatsapp"
}| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
client_id | string | Sim | ID do cliente (formato UUID) |
name | string | Sim | Nome da atividade (3-250 caracteres) |
description | string | Sim | Descrição da atividade (3-250 caracteres) |
type | string | Sim | Tipo da atividade: whatsapp, email ou sms |
Tipos de Atividade
| Tipo | Descrição |
|---|---|
whatsapp | Mensagem via WhatsApp |
email | Email enviado |
sms | SMS enviado |
Exemplo de Requisição
bash
curl -X POST "https://api-b2s.experienciab2s.com/api/activities" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"client_id": "ef9fa264-3850-4bd2-875e-2b40a4dd432f",
"name": "Envio de mensagem de boas-vindas",
"description": "Foi enviado um WhatsApp com informações do programa de fidelidade",
"type": "whatsapp"
}'Resposta de Sucesso (201)
json
{
"message": "Activity created with success"
}Códigos de Resposta
| Código | Descrição |
|---|---|
| 201 | Atividade criada com sucesso |
| 400 | Erro de validação |
| 403 | Token inválido ou usuário não autorizado |
| 404 | Token ou cliente não encontrado |