Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt

Use this file to discover all available pages before exploring further.

El modulo de Consultas te permite ejecutar consultas SQL directamente sobre los datos sincronizados de tu workspace. Es una herramienta para analizar contactos, mensajes, oportunidades, campanas y mas, sin necesidad de herramientas externas.
Solo se permiten consultas de tipo SELECT. No es posible modificar, insertar o eliminar datos desde este modulo.

Interfaz del Editor

El modulo cuenta con las siguientes secciones:
  • Sidebar izquierdo: Lista de tablas disponibles y consultas guardadas
  • Editor SQL: Editor de codigo con resaltado de sintaxis SQL
  • Panel de resultados: Tabla con los resultados de la consulta
  • Barra de acciones: Botones para sincronizar datos, ejecutar y exportar

Atajos de teclado

AtajoAccion
Cmd + Enter (Mac)Ejecutar consulta
Ctrl + Enter (Windows)Ejecutar consulta

Tabs multiples

Puedes abrir multiples consultas en tabs separados. Haz doble clic en el nombre del tab para renombrarlo.

Consultas guardadas

Presiona el boton de guardar para almacenar una consulta. Las consultas guardadas aparecen en el sidebar izquierdo y se pueden cargar haciendo clic sobre ellas.

Sincronizacion de datos

Los datos se sincronizan desde la base de datos principal de Plazbot hacia una base de datos analitica. Para actualizar los datos:
  1. Haz clic en Sincronizar datos en la barra superior
  2. Espera a que el proceso termine (se muestra el progreso en tiempo real)
  3. Una vez completado, los datos estaran actualizados
Los mensajes se sincronizan de los ultimos 30 dias. Los contactos, oportunidades y demas datos se sincronizan completamente.

Tablas disponibles

El modulo expone 6 tablas para consultas:
TablaDescripcion
contactsContactos del workspace
messagesMensajes de conversaciones
conversationsEnvios de mensajes (campanas, individuales, API)
opportunitiesOportunidades de negocio
usersUsuarios/agentes del workspace
campaignsCampanas de envio masivo

Tabla: contacts

Contiene todos los contactos del workspace.
CampoTipoDescripcion
idtextID unico del contacto
nametextNombre
lastnametextApellido
fullnametextNombre completo
aliastextAlias del contacto
emailtextCorreo electronico
phonetextTelefono principal
phone2textTelefono secundario
phone3textTercer telefono
platform_idintegerPlataforma de origen (ver valores abajo)
platform_sender_idtextID del contacto en la plataforma externa
assigned_agent_idtextID del agente asignado
assigned_agent_nametextNombre del agente asignado
assigned_agent_datetimestampFecha de asignacion del agente
stage_idtextID de la fase/etapa
stage_nametextNombre de la fase
segmentation_idtextID de la segmentacion
segmentation_nametextNombre de la segmentacion
is_solvedbooleanSi esta resuelto
solved_by_agent_idtextID del agente que resolvio
solved_by_agent_nametextNombre del agente que resolvio
solved_datetimestampFecha de resolucion
is_readbooleanSi fue leido
is_archivedbooleanSi esta archivado
is_bot_enabledbooleanSi el bot esta habilitado
is_blockedbooleanSi esta bloqueado
is_show_in_chatbooleanSi se muestra en el chat
is_manually_addedbooleanSi fue agregado manualmente
tagsjsonbEtiquetas asignadas
variablesjsonbVariables del contacto
last_messagetextContenido del ultimo mensaje
last_message_datetimestampFecha del ultimo mensaje
first_messagetextContenido del primer mensaje
first_message_datetimestampFecha del primer mensaje
first_agent_message_datetimestampFecha del primer mensaje de un agente
document_numbertextNumero de documento (DNI, RUC, etc.)
business_nametextNombre de empresa
creation_datetimestampFecha de creacion
reject_reason_contenttextMotivo de rechazo
reject_reason_datetimestampFecha de rechazo
colortextColor asignado al contacto
sentimenttextSentimiento detectado
Valores de platform_id:
ValorPlataforma
1Webchat
2WhatsApp
3Facebook
4Instagram
5Telegram
6Portal
7Code
8Calls
9Facebook Leads
10Tickos

Tabla: messages

Contiene todos los mensajes de las conversaciones.
CampoTipoDescripcion
idtextID unico del mensaje
contact_idtextID del contacto asociado
contenttextContenido del mensaje
typetextTipo de contenido (TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT, etc.)
origin_messagetextOrigen del mensaje (ver valores abajo)
answer_typeintegerQuien respondio (ver valores abajo)
answer_type_texttextTexto descriptivo de answer_type
answer_agent_idtextID del agente que respondio
answer_agent_nametextNombre del agente que respondio
platform_idtextPlataforma
sentimenttextSentimiento detectado
template_codetextCodigo del template usado
campaign_nametextNombre de la campana asociada
campaign_idtextID de la campana asociada
f_typeintegerTipo de mensaje (ver valores abajo)
is_notebooleanSi es nota interna
message_status_idintegerEstado del mensaje
message_whatsapp_idtextID del mensaje en WhatsApp
content_urltextURL del archivo adjunto
content_typetextMIME type del contenido
content_filenametextNombre del archivo adjunto
sent_message_errortextError al enviar
sent_message_error_codetextCodigo de error al enviar
ia_providertextProveedor de IA (openai, claude, gemini)
ia_modeltextModelo de IA usado
ia_input_tokensintegerTokens de entrada consumidos
ia_output_tokensintegerTokens de salida generados
ia_estimated_cost_usddecimalCosto estimado en USD
ia_iterationsintegerIteraciones del agentic loop
ia_tool_calls_countintegerCantidad de llamadas a herramientas
ia_latency_msbigintLatencia en milisegundos
ia_agent_idtextID del agente IA
ia_agent_nametextNombre del agente IA
ia_feedback_ratingintegerRating: 1 = positivo, -1 = negativo
ia_tools_executedjsonbHerramientas ejecutadas por IA
automation_infojsonbInformacion de la automatizacion
context_message_idtextID del mensaje al que se responde (reply)
context_message_contenttextContenido del mensaje al que se responde
reference1textReferencia 1 (webhooks)
reference2textReferencia 2 (webhooks)
reference3textReferencia 3 (webhooks)
creation_datetimestampFecha de creacion
Valores de f_type (tipo de mensaje):
ValorSignificado
1Bot (mensaje del flujo/automatizacion)
2Contact (mensaje del contacto)
3InternalNote (nota interna)
4ChatEvent (evento de chat)
5CallResumen (resumen de llamada)
Valores de answer_type (quien respondio):
ValorSignificado
1FLOW (respondio la automatizacion)
2AGENT (respondio un agente humano)
3AGENT_IA (respondio un agente IA)
Valores de origin_message:
ValorSignificado
meEnviado por el negocio
contactEnviado por el cliente
automationEnviado por automatizacion
agentEnviado por un agente

Tabla: conversations

Registra los envios de mensajes (campanas, individuales y via API).
CampoTipoDescripcion
idtextID unico
contact_idtextID del contacto destinatario
template_codetextCodigo del template de WhatsApp
template_typetextTipo de template
send_typeintegerTipo de envio (ver valores abajo)
send_type_texttextTexto descriptivo de send_type
response_statusintegerEstado de respuesta (ver valores abajo)
response_status_texttextTexto descriptivo de response_status
campaign_nametextNombre de la campana
campaign_idtextID de la campana
agent_sender_idtextID del agente que envio
agent_sender_nametextNombre del agente que envio
platform_idtextPlataforma de envio
platform_sender_idtextID del sender en la plataforma
internal_whatsapp_numbertextNumero de WhatsApp del negocio
is_scheduledbooleanSi fue un envio programado
scheduled_attimestampFecha programada de envio
request_bodytextBody de la solicitud a la API
response_bodytextBody de respuesta de la API
response_status_bodytextStatus body de respuesta
sent_datetimestampFecha de envio
creation_datetimestampFecha de creacion
Valores de send_type:
ValorSignificado
1CAMPAIGN (envio de campana)
2INDIVIDUAL (envio individual)
3API (envio via API)
Valores de response_status:
ValorSignificado
1ACCEPTED (aceptado por WhatsApp)
2ERROR (error en el envio)
3PENDING (pendiente)

Tabla: opportunities

Contiene las oportunidades de negocio del pipeline.
CampoTipoDescripcion
idtextID unica
contact_idtextID del contacto asociado
nametextNombre de la oportunidad
opport_codetextCodigo de la oportunidad
amountdecimalMonto inicial
final_amountdecimalMonto final
currency_codetextCodigo de moneda (USD, PEN, etc.)
currency_symboltextSimbolo de moneda ($, S/, etc.)
stage_idtextID de la etapa en el pipeline
stage_nametextNombre de la etapa
pipeline_idtextID del pipeline
pipeline_nametextNombre del pipeline
assigned_agent_idtextID del agente asignado
assigned_agent_nametextNombre del agente asignado
statusintegerEstado (ver valores abajo)
close_datetimestampFecha de cierre
creation_datetimestampFecha de creacion
activitiesjsonbActividades asociadas
Valores de status:
ValorSignificado
0Sin definir
1Ganada
2Perdida

Tabla: users

Contiene los usuarios y agentes del workspace.
CampoTipoDescripcion
idtextID del usuario
nametextNombre
last_nametextApellido
emailtextCorreo electronico
roletextRol: owner, supervisor, agent
is_onlinebooleanSi esta en linea
statustextEstado: active, deactivated
timezonetextZona horaria

Tabla: campaigns

Contiene las campanas de envio masivo.
CampoTipoDescripcion
idtextID de la campana
nametextNombre
status_idintegerEstado (ver valores abajo)
status_texttextTexto descriptivo del estado
total_recordsintegerTotal de contactos
total_sendintegerTotal de mensajes enviados
total_errorsintegerTotal de errores
success_ratedecimalTasa de exito (%)
is_direct_sendbooleanSi es envio directo (sin programar)
scheduled_send_datetimestampFecha programada de envio
agent_sender_nametextNombre del agente que envio
user_creationtextUsuario que creo la campana
show_messages_in_chatbooleanSi los mensajes se muestran en chat
ia_agent_start_enabledbooleanSi el agente IA se activa al responder
random_agent_enabledbooleanSi se asigna agente aleatorio
cancellation_datetimestampFecha de cancelacion
error_summarytextResumen de errores
templatesjsonbTemplates usados
tagsjsonbEtiquetas asignadas a contactos
filtersjsonbFiltros aplicados para seleccionar contactos
creation_datetimestampFecha de creacion
last_updated_datetimestampUltima actualizacion
Valores de status_id:
ValorSignificado
1PENDING (pendiente)
2SCHEDULED (agendada)
3SENDING (enviando)
4COMPLETE (completada)
5ERROR (error)
6CANCELED (cancelada)

Ejemplos de consultas

Contactos creados en un rango de fechas

SELECT fullname, email, phone, creation_date
FROM contacts
WHERE creation_date >= '2025-01-01'
  AND creation_date < '2025-02-01'
ORDER BY creation_date DESC
LIMIT 100;

Buscar contacto por nombre

SELECT *
FROM contacts
WHERE fullname ILIKE '%nombre%'
LIMIT 50;

Mensajes de un contacto especifico

SELECT m.content, m.creation_date, m.f_type
FROM messages m
JOIN contacts c ON c.id = m.contact_id
WHERE c.fullname ILIKE '%nombre%'
ORDER BY m.creation_date DESC
LIMIT 100;

Campanas en envio

SELECT name, status_text, total_records, total_send,
       total_errors, success_rate
FROM campaigns
WHERE status_text = 'SENDING'
ORDER BY creation_date DESC;

Oportunidades por pipeline

SELECT name, amount, final_amount, pipeline_name,
       stage_name, assigned_agent_name, status
FROM opportunities
ORDER BY creation_date DESC
LIMIT 100;

Contactos con un tag especifico

SELECT fullname, email, tags
FROM contacts
WHERE tags::text ILIKE '%nombre_tag%'
LIMIT 100;

Contactos sin agente asignado

SELECT fullname, email, creation_date
FROM contacts
WHERE assigned_agent_name IS NULL
ORDER BY creation_date DESC
LIMIT 100;

Mensajes respondidos por agente IA

SELECT m.content, m.ia_agent_name, m.ia_model,
       m.ia_estimated_cost_usd, m.creation_date
FROM messages m
WHERE m.ia_agent_name IS NOT NULL
ORDER BY m.creation_date DESC
LIMIT 100;

JOIN contactos con oportunidades

SELECT c.fullname, c.email, o.name AS oportunidad,
       o.amount, o.stage_name, o.pipeline_name
FROM contacts c
JOIN opportunities o ON o.contact_id = c.id
ORDER BY o.creation_date DESC
LIMIT 100;

Conversaciones de una campana

SELECT campaign_name, agent_sender_name,
       response_status_text, sent_date
FROM conversations
WHERE campaign_name IS NOT NULL
ORDER BY sent_date DESC
LIMIT 100;

Costo total de IA por agente

SELECT ia_agent_name,
       COUNT(*) AS total_mensajes,
       SUM(ia_estimated_cost_usd) AS costo_total_usd,
       AVG(ia_latency_ms) AS latencia_promedio_ms
FROM messages
WHERE ia_agent_name IS NOT NULL
GROUP BY ia_agent_name
ORDER BY costo_total_usd DESC;

Exportacion de resultados

Los resultados pueden exportarse en multiples formatos desde el boton Export:
FormatoDescripcion
Copy as MarkdownCopia la tabla en formato Markdown al portapapeles
Copy as JSONCopia los datos como JSON al portapapeles
Copy as CSVCopia los datos como CSV al portapapeles
Download CSVDescarga un archivo .csv
Download .sqlDescarga la consulta como archivo .sql