Manual del panel · AUTOMAÇÕES

Webhooks en "Automações" (Automatizaciones): avisos que llegan desde su sistema y avisos que la plataforma envía a él

Webhooks reúne, en dos pestañas, los avisos que el sistema de la empresa envía al panel (Entrada, con reglas del tipo cuando llegue X, haga Y) y los avisos firmados que el panel envía al sistema de la empresa ("Saída" (Salida)).

Cuándo aparece: Aparece en el grupo "Automações" (Automatizaciones) cuando la liberación de "Fluxos" (Flujos) y Webhooks está activada para la cuenta; una cuenta nueva ya nace con las Automatizaciones activadas, excepto "Anúncios" (Anuncios). La pestaña Entrada depende de la "Base de conhecimento avançada" (Base de conocimiento avanzada): sin el módulo activo, invita a conocerlo; "Saída" (Salida) existe en toda cuenta con la liberación.

Quién puede usarlo

Rol	Qué ve y qué hace
Propietario	Ve las dos pestañas, crea webhooks de entrada y de salida, usa todo en "Saída" (Salida) y, en Entrada, cambia el secreto, invalida el anterior, crea una dirección nueva, elimina reglas y archiva lo que tiene historial.
Administrador	Ve y usa la pestaña Entrada (crea eventos y reglas, prueba, muestra el secreto). La pestaña "Saída" (Salida) es solo del dueño: el administrador ve el aviso de que queda con el dueño de la cuenta.
Agente	No ve el ítem en el menú; quien abre la dirección directamente vuelve al inicio del panel.

Pantallas

Webhooks

La pantalla Webhooks sirve para registrar la dirección por la cual el sistema de la empresa avisa al panel, dar reglas para cada aviso y registrar las direcciones del sistema de la empresa que reciben los avisos del panel.

Dirección en el panel: /app/automacoes/webhooks

Cómo llegar: Desde el menú "Automações" (Automatizaciones) › Webhooks. La dirección anterior de "Integrações" (Integraciones) lleva hasta aquí; cada pestaña tiene su propia dirección, así que se puede enviar el enlace de una pestaña específica.

Encabezado y pestañas

El título, el botón de crear y las dos pestañas.

Botones y acciones

"Novo webhook" (Nuevo webhook): Abre el asistente de creación, ya en la dirección de la pestaña abierta. Solo aparece para quienes pueden crear.
Entrada: Pestaña de los avisos que el sistema de la empresa envía al panel. El número al lado es la cantidad de eventos.
"Saída" (Salida): Pestaña de las direcciones que reciben los avisos del panel. El número al lado es la cantidad de webhooks.

Un cuadro recuerda que Entrada estaba en la "Base avançada" (Base avanzada) y "Saída" (Salida) en "Integrações" (Integraciones).
Las pestañas se mueven con las flechas del teclado.
Cuando la cuenta no tiene Entrada, solo aparece la pestaña "Saída" (Salida).

Pestaña Entrada: dirección y secreto

La dirección firmada que el sistema de la empresa llama para avisar al panel.

Botones y acciones

"Copiar o endereço" (Copiar la dirección): Copia la dirección para registrarla en el sistema de la empresa.
Mostrar: Revela el secreto de la firma para copiarlo (queda registrado).
Ocultar: Vuelve a enmascarar el secreto.
"Copiar o segredo" (Copiar el secreto): Copia el secreto revelado.
"Trocar" (Cambiar)Propietario: Pregunta "Trocar o segredo?" (¿Cambiar el secreto?): el nuevo vale de inmediato y el actual sigue vigente por 24 horas.
"Trocar agora" (Reemplazar ahora): Confirma el cambio y muestra el secreto nuevo.
"Invalidar o antigo agora" (Invalidar el anterior ahora)Propietario: Con el secreto anterior aún vigente, pregunta y lo corta de inmediato (úselo si se filtró).
"Invalidar agora" (Invalidar ahora): Confirma: los avisos firmados con el secreto antiguo pasan a ser rechazados.
"Mais ações do endereço" (Más acciones de la dirección): Abre el menú de la dirección.
"Arquivar endereço" (Archivar dirección): Cuando ya hay entregas en el historial: la dirección pasa al archivo.
"Excluir endereço" (Eliminar dirección): Cuando nunca llegó un aviso: la elimina definitivamente.
"Criar endereço novo" (Crear dirección nueva)Propietario: Con la dirección archivada, genera otra dirección y otro secreto. Los eventos con nombre y las reglas (desactivadas) permanecen.

"Situação" (Estado): "Recebendo" (Recibiendo), "Último há tanto tempo" (Último hace tanto tiempo), "Sem avisos ainda" (Aún sin avisos) o "Arquivado" (Archivado).
Un aviso por lead cada 7 días, como máximo.
Una sugerencia con los encabezados de la firma de cada aviso.

Pestaña Entrada: eventos, entregas y reglas

Lo que el sistema ya envió, cada evento con nombre en portugués, y la regla de cada uno.

Campos y filtros

"Chave do evento" (Clave del evento)obligatorio: Lo que va en el campo evento del cuerpo (letras, números, punto, guion o guion bajo).
"Nome em português" (Nombre en portugués)obligatorio: Cómo se muestra el evento en la pantalla.
"Etiqueta do CRM" (Etiqueta del CRM): Los leads con esta etiqueta en la "Base de contatos" (Base de contactos) reciben el aviso.
"Modelo aprovado da Meta" (Plantilla aprobada por Meta): Fuera de las 24 horas, la plantilla usada; sin plantilla, el aviso no se envía fuera de la ventana.
"No máximo 1 aviso por lead a cada" (Máximo 1 aviso por lead cada): 7, 14 o 30 días.
"Corpo de exemplo" (Cuerpo de ejemplo): El JSON del aviso simulado, completado con el último aviso recibido.

Botones y acciones

"Regra" (Regla): Abre una regla nueva (requiere al menos un evento).
Evento: Abre "Cadastrar um evento" (Registrar un evento), para registrar la clave antes de que el sistema la envíe.
"nomear" (nombrar): En el evento que todavía no tiene nombre, abre "Nomear o evento" (Nombrar el evento).
Editar: Abre la regla para editarla.
"Excluir regra" (Eliminar regla)Propietario: Pregunta "Excluir esta regra?" (¿Eliminar esta regla?); los avisos ya enviados quedan registrados.
"Regra ativa" (Regla activa): Interruptor que activa o desactiva la regla; la regla nace desactivada.
"Enviar evento de teste" (Enviar evento de prueba): Simula el aviso con un cuerpo de ejemplo y muestra la firma, cuántos leads lo recibirían y el hecho propuesto. No se envía nada.

Cada evento muestra cuántos llegaron en el mes; al hacer clic en él, se muestra la regla a la derecha.
Últimas entregas: cada llamada a la dirección como aceptada, rechazada o repetida, con la hora y, cuando algún lead no lo recibió, el motivo.
La regla tiene "Quando" (Cuándo), "Para os leads de uma etiqueta" (Para los leads con una etiqueta) y los pasos de "Faça" (Haga): proponer un hecho para aprobar, enviar un mensaje al lead, quitar de la lista y marcar un campo del lead.
Dentro de las 24 horas, la IA escribe con la persona de la cuenta; fuera de ellas, usa la plantilla aprobada.

Pestaña Salida: tarjeta del webhook

Una tarjeta por dirección del sistema de la empresa. Solo el dueño ve la pestaña.

Botones y acciones

"Ativo" (Activo): Interruptor que pausa o activa el webhook. Pausado, no se envía nada, y los eventos de ese período no quedan en la cola.
"Reativar" (Reactivar): En el aviso de pausa automática, vuelve a enviar los próximos avisos.
"Ver as falhas" (Ver las fallas): En el aviso de pausa automática, abre el panel lateral de entregas ya en "Falharam" (Fallidos).
Entregas: Abre el panel lateral con las entregas de este webhook.
"Testar" (Probar): Abre el diálogo "Enviar evento de teste" (Enviar evento de prueba).
"Editar webhook ‹endereço›" (Editar webhook ‹dirección›): Abre el formulario de edición.
"Excluir webhook ‹endereço›" (Eliminar webhook ‹dirección›): Abre la confirmación de eliminación.

Sello "Ativo" (Activo), "Pausado" (Pausado) o "Pausado automaticamente" (Pausado automáticamente), y "Com dados pessoais" (Con datos personales) o "Sem dados pessoais" (Sin datos personales).
Los eventos que recibe la dirección y el estado de los últimos 7 días, con el porcentaje entregado, las fallas y el último envío.
La tarjeta "Para quem vai programar o recebimento" (Para quien va a programar la recepción) trae los encabezados de la firma y cómo debe responder el sistema, con el botón "Documentação dos webhooks" (Documentación de los webhooks).
Cada aviso sale firmado; la documentación sigue en "Integrações" (Integraciones) › "Documentação" (Documentación).

Asistente "Novo webhook" (Nuevo webhook)

Paso 1 de 2: elegir la dirección y completar los datos. Después, la pantalla "Webhook criado" (Webhook creado).

Campos y filtros

"Nome" (Nombre)obligatorio: En Entrada: un nombre que diga de dónde viene el aviso, como "Pedido pago" (Pedido pagado). La clave del evento sale del nombre.
"Endereço do seu sistema" (Dirección de su sistema)obligatorio: En "Saída" (Salida): la dirección completa que comience con https:// y que recibirá los avisos.
Eventosobligatorio: En "Saída" (Salida): elija al menos un evento del catálogo.

Botones y acciones

"Entrada: o seu sistema avisa" (Entrada: su sistema avisa): Dirección en la que el sistema de la empresa avisa al panel. Queda deshabilitada sin acceso a Entrada.
"Saída: a plataforma avisa" (Salida: la plataforma avisa): Dirección en la que el panel avisa al sistema de la empresa. Solo el dueño.
"Criar webhook" (Crear webhook): Crea el webhook y muestra la pantalla "Webhook criado" (Webhook creado).
Cancelar: Se cierra sin crear.
"Copiar o endereço" (Copiar la dirección): En "Webhook criado" (Webhook creado) (Entrada), copia la dirección para el sistema de la empresa.
"Copiar o segredo" (Copiar el secreto): En "Webhook criado" (Webhook creado) ("Saída" (Salida)), copia el secreto de la firma, que se muestra una sola vez.
"Pronto" (Listo): Cierra la pantalla "Webhook criado" (Webhook creado).

En Entrada, después de crear, usted escribe la regla: qué mensaje envía la IA y a quién. El estado es "Escutando" (Escuchando) y pasa a activo cuando llega el primer aviso.
En "Saída" (Salida), el secreto aparece una sola vez; se puede generar otro en cualquier momento.

Estados de la pantalla

Cargando: Bloques de esqueleto mientras cargan "Saída" (Salida) y Entrada.
Aún sin datos: "Nenhum webhook de entrada" (Ningún webhook de entrada) (con "Criar webhook de entrada" (Crear webhook de entrada)) y "Nenhum webhook de saída" (Ningún webhook de salida) (con "Criar webhook de saída" (Crear webhook de salida)).
Si hay un error: "Não foi possível abrir os webhooks" (No fue posible abrir los webhooks), indicando que nada cambió, con el botón de intentar de nuevo.
Entrada sin el módulo de la "Base avançada" (Base avanzada): Los webhooks de entrada pertenecen a la "Base avançada" (Base avanzada), con el botón "Conhecer a Base avançada" (Conocer la Base avanzada).
Administrador en "Saída" (Salida): El aviso de que la pestaña queda con el dueño de la cuenta.
"Atendente" (Agente) o gestor sin acceso a Entrada: Los webhooks de entrada quedan con la gestión de la cuenta; pida a una de esas personas que abra la pestaña.
Dirección de entrada archivada: El sistema ya no puede avisar; las reglas quedan desactivadas hasta crear una dirección nueva.
Dominio del panel aún no configurado: La dirección de entrada solo aparece después de que el dominio esté listo.

Paso a paso

Cómo recibir avisos de su sistema (webhook de entrada)

En "Automações" (Automatizaciones) › Webhooks, haga clic en "Novo webhook" (Nuevo webhook) y elija "Entrada: o seu sistema avisa" (Entrada: su sistema avisa).
Póngale un nombre que diga de dónde viene el aviso y haga clic en "Criar webhook" (Crear webhook).
Haga clic en "Copiar o endereço" (Copiar la dirección) y regístrela en el sistema de la empresa; use Mostrar para copiar el secreto de la firma.
Cuando llegue el primer aviso, el estado cambia de "Escutando" (Escuchando) a "Recebendo" (Recibiendo).

Cómo avisar a los leads cuando su sistema envía un webhook

En la pestaña Entrada, haga clic en "Regra" (Regla) y elija el evento.
En "Escolha a lista" (Elija la lista), elija la etiqueta de los leads que deben recibirlo.
En "Adicione o que fazer" (Agregue qué hacer), agregue los pasos, como enviar un mensaje al lead.
Elija la "Modelo aprovado da Meta" (Plantilla aprobada por Meta) para quienes están fuera de las 24 horas y ajuste los límites.
Haga clic en "Salvar" (Guardar), pruebe con "Enviar evento de teste" (Enviar evento de prueba) y active el interruptor "Regra ativa" (Regla activa).

Cómo enviar los avisos del panel a su sistema (webhook de salida)

Haga clic en "Novo webhook" (Nuevo webhook) y elija "Saída: a plataforma avisa" (Salida: la plataforma avisa) (solo el dueño).
Escriba la "Endereço" (Dirección) de su sistema, que empiece con https://, y marque los Eventos.
Haga clic en "Criar webhook" (Crear webhook) y guarde el secreto con "Copiar o segredo" (Copiar el secreto): aparece una sola vez.
En la tarjeta, use "Testar" (Probar) para enviar un evento de ejemplo y verifíquelo en Entregas.

Cómo cambiar el secreto de un webhook de entrada

En la pestaña Entrada, haga clic en "Trocar" (Cambiar) y confirme con "Trocar agora" (Reemplazar ahora); el nuevo vale de inmediato y el anterior sigue vigente por 24 horas.
Actualice el secreto en el sistema de la empresa.
Si el anterior se filtró, haga clic en "Invalidar o antigo agora" (Invalidar el anterior ahora) para cortarlo de inmediato.

Preguntas frecuentes

¿Cuál es la diferencia entre un webhook de entrada y uno de salida?

En el de entrada, el sistema de la empresa avisa al panel y la IA habla con el lead correcto. En el de salida, el panel avisa al sistema de la empresa, con cada aviso firmado.

¿Por qué no veo la pestaña Entrada?

Depende de la "Base de conhecimento avançada" (Base de conocimiento avanzada). Sin el módulo activo, la pestaña invita a conocerlo; y quien no es gestor de la cuenta ve que queda con la gestión.

¿El administrador puede crear un webhook de salida?

"Não" (No). La pestaña "Saída" (Salida) es solo del dueño de la cuenta. El administrador usa Entrada.

¿Un lead puede recibir el mismo aviso varias veces?

"Não" (No). Cada lead recibe como máximo un aviso cada 7 días, y la regla además tiene su propio límite de 7, 14 o 30 días.

¿Qué ocurre si mi sistema deja de responder?

La plataforma lo intenta de nuevo algunas veces y, después de muchas fallas seguidas, pausa el webhook y avisa por correo electrónico y en la campana. Las fallas quedan en el registro de entregas para reenviarlas.

¿Qué es el secreto de la firma?

Es la clave que prueba que el aviso es verdadero. En el de salida aparece una sola vez al crearlo; en el de entrada se puede mostrar, cambiar e invalidar el anterior.