curl https://api.whaapy.com/team/v1 \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch('https://api.whaapy.com/team/v1', {
headers: {
'Authorization': 'Bearer wha_TU_API_KEY'
}
});
const data = await response.json();
console.log(data.agents);
import requests
response = requests.get(
'https://api.whaapy.com/team/v1',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
{
"agents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Juan Pérez",
"email": "juan@empresa.com",
"role": "admin",
"is_available": true,
"assigned_conversations": 5
},
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "María García",
"email": "maria@empresa.com",
"role": "agent",
"is_available": true,
"assigned_conversations": 3
},
{
"id": "770e8400-e29b-41d4-a716-446655440002",
"name": "Carlos López",
"email": "carlos@empresa.com",
"role": "agent",
"is_available": false,
"assigned_conversations": 0
}
]
}
Equipo
Listar Agentes
Obtén la lista de agentes humanos de tu equipo con su disponibilidad y conversaciones asignadas
GET
/
team
/
v1
curl https://api.whaapy.com/team/v1 \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch('https://api.whaapy.com/team/v1', {
headers: {
'Authorization': 'Bearer wha_TU_API_KEY'
}
});
const data = await response.json();
console.log(data.agents);
import requests
response = requests.get(
'https://api.whaapy.com/team/v1',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
{
"agents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Juan Pérez",
"email": "juan@empresa.com",
"role": "admin",
"is_available": true,
"assigned_conversations": 5
},
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "María García",
"email": "maria@empresa.com",
"role": "agent",
"is_available": true,
"assigned_conversations": 3
},
{
"id": "770e8400-e29b-41d4-a716-446655440002",
"name": "Carlos López",
"email": "carlos@empresa.com",
"role": "agent",
"is_available": false,
"assigned_conversations": 0
}
]
}
Retorna todos los miembros del equipo (agentes humanos) asociados a tu negocio. Útil para obtener IDs de agentes antes de asignarlos a contactos.
Al asignar un agente a un contacto:
Scope requerido:
team:readRespuesta
array
Show Propiedades de cada agente
Show Propiedades de cada agente
string
UUID del agente. Usa este valor para asignar el agente a un contacto.
string | null
Nombre del agente
string
Email del agente
string
Rol en el equipo:
super_admin, admin, o agentboolean
Si el agente está disponible para recibir asignaciones
number
Cantidad de conversaciones activas asignadas actualmente
Ejemplos
curl https://api.whaapy.com/team/v1 \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch('https://api.whaapy.com/team/v1', {
headers: {
'Authorization': 'Bearer wha_TU_API_KEY'
}
});
const data = await response.json();
console.log(data.agents);
import requests
response = requests.get(
'https://api.whaapy.com/team/v1',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
{
"agents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Juan Pérez",
"email": "juan@empresa.com",
"role": "admin",
"is_available": true,
"assigned_conversations": 5
},
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "María García",
"email": "maria@empresa.com",
"role": "agent",
"is_available": true,
"assigned_conversations": 3
},
{
"id": "770e8400-e29b-41d4-a716-446655440002",
"name": "Carlos López",
"email": "carlos@empresa.com",
"role": "agent",
"is_available": false,
"assigned_conversations": 0
}
]
}
Uso con Asignación de Contactos
Una vez que tengas el ID del agente, puedes asignarlo a un contacto usando PATCH /contacts/v1/:id o al crear un contacto:curl -X PATCH https://api.whaapy.com/contacts/v1/CONTACT_ID \
-H "Authorization: Bearer wha_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "assigned_agent_id": "550e8400-e29b-41d4-a716-446655440000" }'
- Todas las conversaciones activas del contacto se asignan automáticamente al agente
- Las conversaciones futuras del contacto también se asignarán al agente automáticamente
Crear Contacto
Crea un contacto con agente asignado
Actualizar Contacto
Asigna un agente a un contacto existente
Was this page helpful?