Manual del panel · Cuenta

Integraciones: recibir leads por API, avisar a su CRM por webhook y devolver conversiones a Meta

El área Integraciones del panel sirve para conectar el panel con los demás sistemas de la empresa: recibir leads por API con primer contacto automático por WhatsApp, avisar a su CRM por webhook en cada paso del lead, devolver las conversiones del embudo a los anuncios de Meta y recibir los pedidos de venta.

Cuándo aparece: El elemento "Integrações" (Integraciones) aparece para el Propietario y para el Administrador de la cuenta. "Entrada de leads", Webhooks, Entregas y Pedidos existen en toda cuenta; el primer contacto automático requiere una cuenta de WhatsApp conectada y una plantilla de mensaje aprobada por Meta. La pestaña "Conversões" (Conversiones) puede avisar que aún no está disponible en la cuenta. El acceso directo a los webhooks de entrada solo aparece con el módulo "Base avançada" (Base avanzada) activo.

Quién puede usarlo

RolQué ve y qué hace
PropietarioHace todo: crea, edita, pausa, reactiva y elimina integraciones, genera claves, envía un lead de prueba, ajusta y guarda el primer contacto, crea y prueba webhooks, ve y reenvía entregas, conecta y activa las conversiones de Meta y genera la clave de pedidos.
AdministradorVe las integraciones, los números, el registro de entradas, el panel lateral de cada entrada y la pantalla del primer contacto, pero sin los botones de crear, editar, pausar, generar clave o enviar prueba, y sin la barra de guardar en el primer contacto. En las pestañas Webhooks y Entregas ve el aviso de que quedan a cargo del Propietario de la cuenta. En Conversiones ve la configuración y el registro, pero no activa el envío, no cambia el token ni envía una prueba.
AgenteNo ve Integraciones en el menú: los datos de esta área están cerrados para el rol de agente, y la pantalla del primer contacto lleva a la pantalla de acceso denegado.

Pantallas

"Integrações" (Integraciones)

La pantalla Integraciones sirve para reunir, en cinco pestañas, todo lo que conecta el panel con otros sistemas: Entrada de leads, Webhooks, Entregas, Conversiones y Pedidos.

Dirección en el panel: /app/integracoes

La pantalla "Integrações" (Integraciones) en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: Mediante el elemento "Integrações" (Integraciones) del grupo CUENTA en el menú lateral. Cada pestaña tiene su propia URL: abrir Integraciones con la pestaña al final de la URL (entrada, webhooks, entregas, conversoes o pedidos) muestra la pestaña correcta, y al actualizar la página se vuelve a la misma pestaña. El aviso de la campana sobre un webhook en pausa también lleva directo a la pestaña Webhooks.

Encabezado de la pantalla

El título, la frase de apoyo y los botones que cambian según la pestaña abierta.

Botones y acciones

"Documentação da API" (Documentación de la API)
En la pestaña "Entrada de leads", abre la documentación de la API de entrada de leads para entregársela a quien programa su sistema. Según la URL del panel, se abre en una pestaña nueva o dentro del propio panel.
"Nova integração" (Nueva integración)Propietario
En la pestaña "Entrada de leads", abre el asistente de cuatro pasos que crea una integración y muestra su clave una única vez.
"Como receber" (Cómo recibir)Propietario
En la pestaña Webhooks, se desplaza hasta la tarjeta "Para quem vai programar o recebimento" (Para quien va a programar la recepción); sin ningún webhook creado, abre la guía de webhooks en el "Central de ajuda" (Centro de ayuda).
"Novo webhook" (Nuevo webhook)Propietario
En la pestaña Webhooks, abre el formulario para registrar un endpoint (URL) que recibirá los avisos.
"Ver os webhooks" (Ver los webhooks)Propietario
En la pestaña Entregas, vuelve a la pestaña Webhooks.
"Como funciona" (Cómo funciona)
En la pestaña "Conversões" (Conversiones), abre la guía de conversiones en el "Central de ajuda" (Centro de ayuda).
  • Título "Integrações" (Integraciones) y la frase "Receber leads, avisar seus sistemas e medir anúncios" (Recibir leads, avisar a sus sistemas y medir anuncios).
  • Los botones de la esquina derecha dependen de la pestaña: "Entrada de leads", Webhooks, Entregas y "Conversões" (Conversiones) tienen botones propios; Pedidos no tiene.

Pestañas de la pantalla

La franja de pestañas que cambia el contenido sin salir de la pantalla.

Botones y acciones

Entrada de leads
Muestra las integraciones que reciben leads por API, con el número de integraciones junto al nombre.
Webhooks
Muestra los endpoints (URL) que reciben avisos del panel, con la cantidad de webhooks junto al nombre (solo para el Propietario).
Entregas
Muestra el registro de todo lo que se envió a sus sistemas mediante webhooks.
"Conversões" (Conversiones)
Muestra la configuración y el registro de las conversiones devueltas a los anuncios de Meta. Lleva la insignia "Novo" (Nuevo).
Pedidos
Muestra la clave y el ejemplo para que su sistema envíe los pedidos de venta.
  • Con el foco en una pestaña, las flechas hacia la derecha y hacia la izquierda pasan a la pestaña vecina.
  • En una pantalla estrecha, la franja de pestañas se desplaza sola hasta la pestaña elegida.

Pestaña Pedidos

Recibe las ventas de su ERP, tienda virtual u otro sistema para alimentar el RFV del "Monitor de sucesso" (Monitor de éxito).

Campos y filtros

"URL de ingestão" (URL de ingesta)
El endpoint (URL) al que su sistema envía los pedidos, con el botón de copiar al lado.
"Chave de API (X-Api-Key)" (Clave de API (X-Api-Key))
La clave de la cuenta para los pedidos, mostrada enmascarada. Sin clave, aparece "Nenhuma chave gerada" (Ninguna clave generada).
"Exemplo (curl)" (Ejemplo (curl))
Un ejemplo listo para enviar un pedido, con la clave en el lugar correcto una vez generada.

Botones y acciones

"Gerar chave" (Generar clave)
Crea la primera clave de pedidos y muestra la clave completa una sola vez, con el aviso de copiarla en el momento.
"Gerar nova chave" (Generar nueva clave)
Crea una clave nueva al instante, sin pedir confirmación, y la anterior deja de funcionar de inmediato.
Copiar
Copia el endpoint (URL), la clave recién generada o el ejemplo.
"Ver o guia passo a passo" (Ver la guía paso a paso)
Abre la guía de integración de pedidos en una pestaña nueva. Solo aparece cuando el panel está en la dirección de la plataforma.
  • Tarjeta "Receber pedidos" (Recibir pedidos): su sistema envía las ventas y alimenta el RFV del "Monitor de sucesso" (Monitor de éxito).
  • El pedido se acepta de nuevo sin duplicarse cuando llega con el mismo identificador externo; se asocia al contacto por el teléfono o por el correo electrónico.
  • Si la clave no carga, la pantalla muestra "Não foi possível carregar a sua chave de API" (No fue posible cargar su clave de API) y oculta el botón de generar, para que nadie cambie sin querer la clave que está en uso.

Estados de la pantalla

Cargando
Cada pestaña muestra bloques grises con la forma del contenido mientras llegan los datos.
Si hay un error
Cada pestaña tiene su propio mensaje de falla, siempre con el botón "Tentar de novo" (Intentar de nuevo); los leads, los avisos y las conversiones siguen funcionando, solo la pantalla no cargó.

Entrada de leads

La pestaña Entrada de leads sirve para crear integraciones que reciben leads de otros sistemas por API, hacer seguimiento de cada lead que llegó y probar el camino hasta el primer contacto por WhatsApp.

Dirección en el panel: /app/integracoes/entrada

La pantalla Entrada de leads en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: "Integrações" (Integraciones), pestaña Entrada de leads (es la pestaña que se abre por defecto). El botón Ver entradas de la pantalla "Primeiro contato automático" (Primer contacto automático) vuelve a esta pestaña con la integración ya elegida y se desplaza hasta el registro.

Banner de apertura

La explicación del camino del lead, que se puede ocultar.

Botones y acciones

"Entendi" (Entendido)
Oculta el banner de apertura. El panel recuerda la elección para su usuario en este navegador.
  • Título "Receba leads de qualquer sistema e responda em segundos" (Reciba leads de cualquier sistema y responda en segundos).
  • El camino del lead en seis etapas: "Seu sistema" (Su sistema), Entrada de leads, "Primeiro contato" (Primer contacto), "IA qualifica" (La IA califica), "Rodízio" (Asignación rotativa) y "Atendente" (Agente).

Sus integraciones

La cuadrícula con una tarjeta por integración y los números de los últimos 7 días.

Botones y acciones

Ver entradas
Elige la integración y se desplaza hasta la lista "Últimos leads recebidos" (Últimos leads recibidos).
EditarPropietario
Abre el asistente de la integración con los datos actuales para cambiar nombre, origen, base legal, primer contacto y destino. No aparece en la integración interna.
"Mais" (Más)Propietario
Abre el menú de la integración. Las flechas hacia arriba y hacia abajo se mueven entre los elementos; Esc lo cierra y devuelve el foco al botón.
PausarPropietario
En el menú "Mais" (Más), pausa la integración: los envíos de su sistema se rechazan hasta que usted la reactive. En la integración interna, los pedidos entran al CRM sin primer contacto.
"Reativar" (Reactivar)Propietario
En el menú "Mais" (Más), vuelve a aceptar los leads de la integración pausada.
"Gerar nova chave" (Generar nueva clave)Propietario
En el menú "Mais" (Más), abre la confirmación para cambiar la clave de la integración.
"Excluir" (Eliminar)Propietario
En el menú "Mais" (Más), abre la confirmación para eliminar la integración.
  • Cada tarjeta muestra el nombre, el origen, la fecha de creación y la insignia "Ativa" (Activa) o Pausada.
  • La clave aparece enmascarada, con cuándo se usó por última vez o que aún no se ha usado. Una integración interna, creada por la propia plataforma para un formulario de sitio, aparece como "Sem chave" (Sin clave).
  • Números de los últimos 7 días: "Recebidos" (Recibidos), "Novos" (Nuevos), "Já existiam" (Ya existían) y "Recusados" (Rechazados) (en rojo cuando hay rechazos).
  • Cuando el sistema envió el mismo lead de nuevo, aparece cuántos reenvíos repetidos se ignoraron, sin costo.
  • La línea del primer contacto indica si está activado, con la plantilla de mensaje y quién cobra el envío; detenido, con el motivo en rojo; o desactivado, cuando la IA solo habla después de que el lead escribe.
  • Hacer clic en cualquier parte de la tarjeta que no sea un botón elige la integración y cambia el detalle que se muestra debajo de la cuadrícula.

Detalle de la integración elegida

El encabezado del detalle, con el nombre de la integración y su situación en vivo.

  • Sobre el nombre, la etiqueta "Receber leads por API" (Recibir leads por API) (o el formulario de origen, en la integración interna).
  • Insignia en vivo: "Recebendo" (Recibiendo), con la hora del último lead o ningún lead aún; o Pausada, los envíos se rechazan.

Cómo conectar

Todo lo que necesita quien administra su sistema para enviar leads.

Campos y filtros

"Endereço do envio" (Dirección de envío)
El endpoint (URL) al que su sistema envía cada lead. Aparece en la pantalla y en la documentación.
"Chave da integração" (Clave de la integración)
La clave enmascarada, solo con el comienzo y el final. Va en el encabezado X-Api-Key de cada envío; la clave completa solo aparece cuando se crea.
"Exemplo de envio" (Ejemplo de envío)
Ejemplo listo en tres pestañas: JSON, cURL y la "Resposta" (Respuesta) que recibe el sistema.

Botones y acciones

"Copiar endereço do envio" (Copiar dirección de envío)
Copia el endpoint (URL) de envío.
"Gerar nova" (Generar nueva)Propietario
Abre la confirmación para generar una clave nueva para esta integración.
JSON
Muestra el ejemplo del cuerpo del lead.
cURL
Muestra el ejemplo de llamada completa, listo para probar en la terminal.
"Resposta" (Respuesta)
Muestra lo que su sistema recibe de vuelta cuando el lead ingresa.
"Copiar o exemplo" (Copiar el ejemplo)
Copia el ejemplo de la pestaña abierta.
"Receber no formato do seu sistema" (Recibir en el formato de su sistema)Propietario
Abre el diálogo para vincular los campos de un formato propio de su sistema con los campos del panel.
"Documentação completa" (Documentación completa)
Abre la documentación de la API de entrada de leads.
  • Aviso "Use a chave só de servidor para servidor: nunca coloque a chave no código do site ou do aplicativo" (Use la clave solo de servidor a servidor: nunca ponga la clave en el código del sitio ni de la aplicación).
  • En la integración interna, en lugar de esta tarjeta aparece "Como os pedidos chegam" (Cómo llegan los pedidos), con la página de origen, la base legal y la plantilla de mensaje usada, sin clave ni API.

Últimos leads recibidos

El registro de entradas de la integración, que se actualiza solo.

Campos y filtros

Todos
Filtro por situación, con el conteo de cada grupo: Todos, "Novos" (Nuevos), "Contatados" (Contactados), "Responderam" (Respondieron) y "Com problema" (Con problemas).

Botones y acciones

"Novos" (Nuevos)
Muestra solo los leads nuevos.
"Contatados" (Contactados)
Muestra los leads que recibieron el primer contacto.
"Responderam" (Respondieron)
Muestra los leads que respondieron al primer contacto.
"Com problema" (Con problemas)
Muestra las entradas rechazadas, bloqueadas, sin saldo o con falla en el envío.
"Carregar mais" (Cargar más)
Trae las entradas más antiguas de la lista.
Ver todas
Cuando un filtro no tiene resultados, vuelve al filtro Todos.
"Reativar integração" (Reactivar integración)Propietario
Aparece cuando la integración está pausada y no llegó nada en los últimos 7 días; reactiva la integración allí mismo.
  • Cada fila muestra el nombre del lead (o "Entrada recusada" (Entrada rechazada)), el teléfono, el rastro de lo que ocurrió, el motivo cuando lo hay, la situación y la hora.
  • Las situaciones vienen escritas en portugués y con colores: "novo" (nuevo), "agendado" (programado), "na fila" (en cola), "contatado" (contactado), "respondeu" (respondió), "sem envio" (sin envío), bloqueado, "não confirmado" (no confirmado), "falhou" (falló), "sem saldo" (sin saldo) y "recusado" (rechazado).
  • El lead de prueba tiene la insignia "Teste" (Prueba).
  • Las filas que llegan con la pantalla abierta entran resaltadas y se anuncian al lector de pantalla.
  • El pie de página indica cuántas entradas están a la vista del total de los últimos 7 días.

Panel lateral de la entrada

Se abre al hacer clic en el nombre de un lead del registro y muestra todo lo que llegó.

Botones y acciones

"Reenviar primeiro contato" (Reenviar primer contacto)
Aparece cuando el envío se puede repetir. Muestra la confirmación con quién cobra el nuevo envío y, si el mensaje puede haber llegado ya, pide verificar antes en el Inbox.
"Reenviar agora" (Reenviar ahora)
Confirma el reenvío: el mensaje sale en segundos hacia el lead.
Cancelar
Cancela el reenvío.
"Abrir conversa" (Abrir conversación)
Abre la conversación del lead en el Inbox.
"Abrir ficha do lead" (Abrir ficha del lead)
Abre la ficha del lead en el CRM.
"Entendi" (Entendido)
Cierra el panel lateral de una entrada rechazada.
  • Insignias del resultado y de la situación; cuando hay un problema, un aviso con el motivo y qué hacer.
  • "Origem" (Origen): plataforma, campaña, conjunto de anuncios, anuncio y el ID en su sistema.
  • "Dados recebidos" (Datos recibidos): los campos extra que envió el sistema; los datos sensibles aparecen ocultos.
  • Base legal: cuál fue, de dónde vino y la prueba del consentimiento, cuando existe.
  • "Linha do tempo" (Línea de tiempo): cada paso del primer contacto, con la hora.
  • La entrada rechazada muestra solo el motivo, el origen y el ID.

"Enviar lead de teste" (Enviar lead de prueba)

Envía un lead real por la integración, marcado como prueba, y muestra cada paso mientras ocurre.

Campos y filtros

"Seu celular" (Su celular)obligatorio
Aparece con el interruptor activado: el número con código de área que recibe el mensaje tal como lo recibe el lead.

Botones y acciones

"Mandar o primeiro contato para o meu WhatsApp" (Enviar el primer contacto a mi WhatsApp)
Activa el envío del primer contacto de la prueba a su celular. Usa un envío de la plantilla de mensaje, con el costo de la plantilla cuando la cuenta debita del saldo.
"Enviar lead de teste" (Enviar lead de prueba)
Envía la prueba. Después de la primera, el botón dice "Enviar outro teste" (Enviar otra prueba).
  • Pasos seguidos en vivo: "Requisição recebida" (Solicitud recibida), "Lead criado e marcado como teste" (Lead creado y marcado como prueba), "Primeiro contato enviado" (Primer contacto enviado) y "Entregue no seu WhatsApp" (Entregado en su WhatsApp).
  • Cuando el mensaje no sale, el paso dice "Nada foi cobrado" (No se cobró nada) y qué falta hacer.
  • Debajo de los pasos aparece la "Resposta da API" (Respuesta de la API), línea por línea.
  • Con la integración pausada, la prueba avisa que es necesario reactivarla antes.
  • Solo aparece para el Propietario, y no aparece en la integración interna sin primer contacto.

"Primeiro contato automático" (Primer contacto automático)

El resumen del primer contacto de la integración, junto al registro.

Botones y acciones

"Ajustar primeiro contato" (Ajustar primer contacto)
Abre la pantalla "Primeiro contato automático" (Primer contacto automático) de esta integración.
  • Insignia "Ligado" (Activado) o "Desligado" (Desactivado).
  • Plantilla de mensaje con el nombre y la categoría, "Custo" (Costo), "Horário" (Horario), "Teto por dia" (Tope por día), "Teto do mês com modelos pagos" (Tope del mes con plantillas pagadas) y "Recontato" (Recontacto).
  • Últimos 7 días: cuántos respondieron de cuántos recibieron el mensaje, con la barra de la tasa.

Base legal predeterminada

Por qué usted puede hablar con los leads de esta integración.

  • Muestra la base elegida en el asistente y su resumen; si el sistema envía la base legal de cada lead, vale la del lead.
  • Sin base predeterminada, aparece "Sem base legal padrão" (Sin base legal predeterminada): cada lead debe traer la base en el campo legal_basis, o se rechaza.

Diálogo "Nova integração" (Nueva integración)

El asistente en cuatro pasos: "Nome e origem" (Nombre y origen), Base legal, "Primeiro contato" (Primer contacto) y Destino. El mismo diálogo se abre como "Editar integração" (Editar integración).

Campos y filtros

"Nome da integração" (Nombre de la integración)obligatorio
Un nombre para reconocer la integración después; solo usted y su equipo lo ven. Enter en el campo avanza.
"De onde vêm esses leads?" (¿De dónde vienen estos leads?)
El origen: "Anúncios da Meta" (Anuncios de Meta), "Outra plataforma de anúncios" (Otra plataforma de anuncios), "Formulário do site" (Formulario del sitio), "Portal ou marketplace" (Portal o marketplace) u "Outro sistema" (Otro sistema). Cada elección muestra una explicación.
"Por que você pode falar com essas pessoas?" (¿Por qué usted puede contactar a estas personas?)obligatorio
La base legal: "Pediram para eu entrar em contato" (Me pidieron que los contactara), que lleva la nota "Recomendado para anúncio" (Recomendado para anuncios); "São meus clientes" (Son mis clientes); o "Já coletei o consentimento deles" (Ya recopilé su consentimiento). La declaración queda registrada con su nombre, la fecha y la hora en cada lead.
"Conta do WhatsApp" (Cuenta de WhatsApp)
La cuenta de WhatsApp que envía el primer contacto; solo aparecen las cuentas activas.
"Modelo aprovado" (Plantilla aprobada)
La plantilla aprobada por Meta que se usa en el primer mensaje. Una plantilla con multimedia en el encabezado o sin precio confirmado aparece deshabilitada, con el motivo.
"Teto por dia" (Tope por día)
Cuántos primeros mensajes envía esta integración como máximo por día.
"Quadro do Funil" (Tablero del Embudo)
El tablero donde nace la tarjeta del lead; el predeterminado viene marcado.
"Coluna de entrada" (Columna de entrada)
La columna del tablero donde nace la tarjeta.
Etiquetas automáticas
Etiquetas que recibe todo lead de esta integración. Ya viene una sugerencia según el origen; Enter agrega, Retroceso en el campo vacío quita la última.

Botones y acciones

"Anúncios da Meta" (Anuncios de Meta)
Elige el origen "Anúncios da Meta" (Anuncios de Meta) (la campaña, el conjunto de anuncios y el anuncio vienen juntos).
"Outra plataforma de anúncios" (Otra plataforma de anuncios)
Elige el origen de formularios de anuncios de otra plataforma.
"Formulário do site" (Formulario del sitio)
Elige el origen del formulario de su sitio o página de lanzamiento.
"Portal ou marketplace" (Portal o marketplace)
Elige el origen de portales y marketplaces de su sector.
"Outro sistema" (Otro sistema)
Elige cualquier otro sistema que haga una llamada HTTP.
"Mandar a primeira mensagem sozinho pelo WhatsApp" (Enviar el primer mensaje automáticamente por WhatsApp)
En el paso 3, activa o desactiva el primer contacto automático. Queda bloqueado con la base "São meus clientes" (Son mis clientes), sin cuenta de WhatsApp conectada o cuando no es posible confirmar quién paga el envío.
"Este sistema pode atualizar as etapas do funil" (Este sistema puede actualizar las etapas del embudo)
En el paso 4, permite que la clave de la integración cambie la etapa del lead, incluidas la venta y la pérdida. La venta marcada por el sistema también va a las conversiones de Meta.
"Receber no formato do seu sistema" (Recibir en el formato de su sistema)
En el paso 4, abre el diálogo de formato propio; el formato se guarda junto con la integración.
"Voltar" (Volver)
Vuelve al paso anterior.
Continuar
Revisa el paso y avanza. Sin nombre, sin base legal o sin plantilla con el primer contacto activado, muestra el error en el campo.
"Criar integração" (Crear integración)
En el paso 4, crea la integración y muestra la pantalla "Integração criada" (Integración creada).
"Salvar alterações" (Guardar cambios)
En la edición, guarda solo lo que cambió; vale para los próximos leads, y el permiso de etapas vale al instante.
"Copiar a chave" (Copiar la clave)
En la pantalla "Integração criada" (Integración creada), copia la clave, que no vuelve a aparecer.
"Copiar o endereço" (Copiar la dirección)
En la pantalla "Integração criada" (Integración creada), copia el endpoint (URL) de envío.
"Enviar lead de teste" (Enviar lead de prueba)
En la pantalla "Integração criada" (Integración creada), cierra el asistente y ejecuta de inmediato la prueba de la integración.
"Concluir" (Finalizar)
Cierra el asistente y abre el detalle de la integración creada.
  • En el paso 3, la vista previa del mensaje en WhatsApp y la franja de costo: quién cobra (la plataforma, debitando del saldo antes de cada envío, o Meta, directamente en la tarjeta de la cuenta de WhatsApp) y el máximo por día con el tope elegido.
  • El horario de envío viene de la cuenta y se ajusta después, en la pantalla "Primeiro contato automático" (Primer contacto automático).
  • Con la base "São meus clientes" (Son mis clientes), el primer contacto queda desactivado: un mensaje de marketing a un cliente con contrato requiere su consentimiento.

Diálogo "Receber no formato do seu sistema" (Recibir en el formato de su sistema)

Vincula los campos de un ejemplo real de su sistema con los campos del panel.

Campos y filtros

"Exemplo do seu sistema" (Ejemplo de su sistema)
Pegue un ejemplo completo del JSON que envía su sistema; el diálogo ya abre con un ejemplo y lee los campos.
Campos encontrados
Una fila por campo del ejemplo, con la elección del destino: "Não usar" (No usar), "Nome" (Nombre), "Telefone" (Teléfono), "E-mail" (Correo electrónico), "ID no seu sistema" (ID en su sistema), "Campanha de anúncio" (Campaña de anuncio), Conjunto, "Anúncio" (Anuncio) o "Dado recebido" (Dato recibido).

Botones y acciones

Encontrar campos
Lee el ejemplo pegado y sugiere el destino de cada campo.
"Salvar formato" (Guardar formato)
Guarda el formato: la integración pasa a aceptar un lead por envío en ese formato. Exige algún campo vinculado a "Telefone" (Teléfono).
Cancelar
Cierra sin guardar.
  • Así quedaría el lead: la vista previa con "Nome" (Nombre), "Telefone" (Teléfono), "E-mail" (Correo electrónico), "ID no seu sistema" (ID en su sistema), "Origem" (Origen) y los datos recibidos.
  • Sin teléfono vinculado, aparece el aviso de que el lead sería rechazado.

Diálogo "Gerar nova chave?" (¿Generar nueva clave?)

Confirma el cambio de la clave de la integración y muestra la clave nueva una sola vez.

Botones y acciones

"Gerar nova chave" (Generar nueva clave)
Genera la clave nueva; la actual deja de funcionar al instante.
"Copiar a chave nova" (Copiar la nueva clave)
Copia la clave nueva para pegarla en su sistema.
"Já guardei a chave" (Ya guardé la clave)
Cierra el diálogo y recuerda cambiar la clave en su sistema.
Cancelar
Mantiene la clave actual.
  • Hasta que la clave nueva se cambie en el sistema, sus envíos se rechazan; los leads que ya llegaron siguen en el panel.

Diálogo "Excluir esta integração?" (¿Eliminar esta integración?)

Confirma la eliminación de la integración.

Botones y acciones

"Excluir integração" (Eliminar integración)
Elimina: la clave deja de funcionar al instante. Los leads y las entradas que ya llegaron siguen en el panel.
Cancelar
Desiste de eliminar.

Estados de la pantalla

Cargando
Tres tarjetas grises en la cuadrícula y dos bloques del detalle mientras llegan las integraciones.
Aún sin datos
"Receba leads de qualquer sistema" (Reciba leads de cualquier sistema): la explicación, el botón "Nova integração" (Nueva integración) (solo para el Propietario) y el botón "Ver a documentação" (Ver la documentación). En el registro, "Esperando o primeiro lead" (Esperando el primer lead) hasta que llegue el primero.
Si hay un error
"Não conseguimos carregar as integrações agora" (No pudimos cargar las integraciones ahora), con "Tentar de novo" (Intentar de nuevo); los leads siguen llegando con normalidad.
Integración pausada sin nada en los últimos 7 días
No llegó nada en los últimos 7 días, con el botón "Reativar integração" (Reactivar integración).
Filtro del registro sin resultados
"Nenhuma entrada com esta situação" (Ninguna entrada con esta situación), con el botón Ver todas.
Primer contacto detenido
La tarjeta de la integración muestra "Primeiro contato parado" (Primer contacto detenido), en rojo, con el motivo.

"Primeiro contato automático" (Primer contacto automático)

La pantalla "Primeiro contato automático" (Primer contacto automático) sirve para activar y ajustar el primer mensaje que sale solo por WhatsApp cuando un lead llega por una integración: cuenta, plantilla de mensaje aprobada, variables, horario, recontacto, tope por día y costo.

Dirección en el panel: /app/integracoes/entrada/‹…›/primeiro-contato · Quién lo usa: Propietario, Administrador

La pantalla "Primeiro contato automático" (Primer contacto automático) en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: En "Integrações" (Integraciones), pestaña Entrada de leads, elija la integración y haga clic en "Ajustar primeiro contato" (Ajustar primer contacto).

Ruta de navegación y encabezado

Dónde está usted y el atajo al registro de la integración.

Botones y acciones

"Integrações" (Integraciones)
En la ruta de navegación, vuelve a la pestaña Entrada de leads.
Ver entradas
Vuelve a la pestaña Entrada de leads con la integración elegida y se desplaza hasta el registro.
  • Ruta de navegación: "Integrações" (Integraciones), Entrada de leads y el nombre de la integración.
  • Sobre el título, el nombre de la integración.

Aviso de saldo insuficiente

Aparece cuando hay leads esperando el primer mensaje por falta de saldo.

Botones y acciones

"Recarregar saldo" (Recargar saldo)
Abre la "Carteira" (Billetera) para recargar.
  • "O primeiro contato parou: saldo insuficiente" (El primer contacto se detuvo: saldo insuficiente), con cuántos leads están esperando. Al recargar, los mensajes salen solos para quienes llegaron en las últimas 24 horas.

Números de los últimos 7 días

  • "Enviados · 7 dias" (Enviados · 7 días), con la variación frente a la semana anterior.
  • "Responderam" (Respondieron), con el porcentaje de los contactados que respondieron y fueron asumidos por la IA.
  • "Até a mensagem" (Hasta el mensaje): el tiempo típico entre la llegada del lead y la salida del mensaje.
  • "Gasto · 7 dias" (Gasto · 7 días): lo que se cobró en la semana, o el aviso de que Meta cobra en la cuenta de WhatsApp.

"Mandar a primeira mensagem sozinho" (Enviar el primer mensaje automáticamente)

El interruptor general del primer contacto de esta integración.

Botones y acciones

"Mandar a primeira mensagem sozinho" (Enviar el primer mensaje automáticamente)Propietario
Activa o desactiva el envío automático. Desactivado, la IA solo habla cuando el lead escribe, y los ajustes de abajo quedan atenuados.
  • En la integración interna sin primer contacto, la frase dice que quien contacta es el equipo comercial y el interruptor queda bloqueado.
  • Sin cuenta de WhatsApp conectada, aparece el aviso con el enlace a "Conexões" (Conexiones).

Cuenta y plantilla

La cuenta de WhatsApp y las plantillas de mensaje aprobadas por Meta en esta cuenta.

Campos y filtros

"Conta do WhatsApp" (Cuenta de WhatsApp)
La cuenta que envía; la lista indica cuándo es la predeterminada y cuándo es una cuenta propia (Meta cobra directamente). Cambiar de cuenta actualiza sus plantillas.
"Modelo aprovado" (Plantilla aprobada)
Una tarjeta por plantilla, con título, nombre técnico, categoría, el texto y quién cobra. Una plantilla que no puede salir en el primer contacto aparece atenuada, con el motivo.

Botones y acciones

"Atualizar" (Actualizar)
Busca de nuevo la lista de plantillas aprobadas en Meta.
"Criar modelo" (Crear plantilla)
Abre la creación de una plantilla de mensaje, cuando la cuenta no tiene ninguna aprobada.
"Atualizar lista" (Actualizar lista)
Busca de nuevo las plantillas, en la lista vacía.
"Tentar de novo" (Intentar de nuevo)
Repite la actualización de las plantillas cuando falló; el primer contacto continúa con la plantilla elegida.
  • Línea "Lista atualizada com a Meta" (Lista actualizada con Meta), con hace cuánto tiempo.
  • Cuando la plantilla elegida fue pausada o eliminada en Meta, aparece "O primeiro contato parou" (El primer contacto se detuvo), con el motivo.
  • En la integración interna, la tarjeta solo muestra la cuenta, la plantilla y lo que va en cada variable, con la insignia de que las define el formulario: no se cambian en esta pantalla.

Qué va en cada variable del mensaje

Aparece cuando la plantilla tiene variables: cada variable numerada se convierte en un dato del lead.

Campos y filtros

"Preencher ‹n› com" (Completar ‹n› con)
El dato que entra en la variable: "Primeiro nome" (Nombre), "Nome completo" (Nombre completo), "Nome da empresa" (Nombre de la empresa), "Nome da persona" (Nombre de la persona), "Nome da campanha de anúncio" (Nombre de la campaña de anuncio) o "Campo recebido" (Campo recibido).
"Se faltar, usar" (Si falta, usar)
El texto que se usa cuando el lead no tiene el dato. En blanco, el mensaje no sale para quien no tenga el dato, y el motivo queda en el registro.
"Nome do campo recebido" (Nombre del campo recibido)
Con "Campo recebido" (Campo recibido), la clave que su sistema envía dentro de fields.
  • Con el nombre de la campaña, un aviso recuerda que el lead ve ese texto: úselo solo si es presentable.

Reglas de envío

Para que el mensaje llegue en el momento correcto, a la persona correcta, sin gastar de más.

Campos y filtros

"Das" (Desde)
La hora de inicio del envío, de 5h a 14h.
"às" (hasta las)
La hora de fin del envío, de 16h a 23h. La zona horaria de la cuenta aparece al lado.
"Teto por dia" (Tope por día)
Mensajes por día en esta integración, de 1 a 5.000. Si se pasa del tope, el resto sale al día siguiente y usted recibe un aviso.

Botones y acciones

"‹n› dias" (‹n› días)
Elige durante cuántos días la misma persona no recibe otro primer mensaje: 15, 30, 60 o 90 días, desde cualquier integración.
"Diminuir o teto em 50" (Reducir el tope en 50)
Baja el tope por día en 50.
"Aumentar o teto em 50" (Aumentar el tope en 50)
Sube el tope por día en 50.
Ajustar
Abre la parte de cobro de "Configurações" (Configuración), donde está el tope del mes.
  • Solo para quien tiene base legal y "Nunca interrompe o seu time" (Nunca interrumpe a su equipo): reglas con la insignia "Sempre ligada" (Siempre activa).
  • La barra de 24 horas muestra el horario elegido y la hora actual; la frase de abajo indica si quien llegue ahora recibe en segundos o a qué hora.
  • "Teto do mês com modelos pagos" (Tope del mes con plantillas pagadas): vale para toda la cuenta, sumando primeros contactos y cadencias, con la barra de cuánto ya se usó.
  • Aviso de que los mensajes de marketing en volumen alto pueden reducir la calidad del número en Meta.

Cómo lo recibe el lead

La vista previa del mensaje en WhatsApp con un lead de ejemplo.

Botones y acciones

"Lead sem nome" (Lead sin nombre)
Cambia la vista previa a un lead de ejemplo sin nombre, para ver el texto de cuando falta el dato.
"Ver a IA assumir a conversa" (Ver a la IA asumir la conversación)
Simula que el lead responde y la IA asume la conversación. La respuesta mostrada es ilustrativa. Después pasa a "Recomeçar a prévia" (Reiniciar la vista previa).
  • La burbuja con las variables ya completadas y los botones de la plantilla.
  • Con el primer contacto desactivado, la vista previa queda cubierta por el aviso "Primeiro contato desligado" (Primer contacto desactivado).
  • Cuando el mensaje no saldría para el lead de ejemplo, aparece el aviso con el dato que falta.

Costo por envío

El precio de la plantilla en esta cuenta y cuánto aguanta el saldo.

Campos y filtros

"Leads por mês" (Leads por mes)
Un control deslizante para simular el volumen del mes; abre cerca de lo que llegó el último mes por esta integración.
  • El valor por lead, debitado antes de cada envío; si Meta lo rechaza en el momento, el valor vuelve al saldo.
  • Estimación por mes y el máximo por día con el tope elegido.
  • Saldo actual y por cuántos días aproximadamente dura al ritmo estimado, contando la cuota incluida del mes.
  • En una cuenta propia de WhatsApp, la tarjeta dice que no hay costo en la plataforma: Meta cobra según su propia tabla.

Barra de cambios sin guardar

Aparece fija al pie de la pantalla cuando algo cambió.

Botones y acciones

"Salvar" (Guardar)Propietario
Guarda el primer contacto; vale para los próximos leads de esta integración.
DescartarPropietario
Vuelve a lo que estaba guardado.

Estados de la pantalla

Cargando
Números y tarjetas grises con el nombre de la integración todavía en blanco.
Si hay un error
"Não conseguimos carregar o primeiro contato agora" (No pudimos cargar el primer contacto ahora), con "Tentar de novo" (Intentar de nuevo); los leads siguen recibiendo el mensaje con normalidad.
La integración fue eliminada
"Esta integração não existe mais" (Esta integración ya no existe), con el botón "Ver integrações" (Ver integraciones).
La cuenta no tiene plantilla aprobada
"Nenhum modelo aprovado nesta conta" (Ninguna plantilla aprobada en esta cuenta), con "Criar modelo" (Crear plantilla) y "Atualizar lista" (Actualizar lista).
Quien abre es Administrador
Todo aparece, pero el interruptor y los ajustes quedan bloqueados y la barra de guardar no aparece.

API de entrada de leads

La pantalla API de entrada de leads es la documentación, dentro del panel, para quien programa el sistema que enviará leads: autenticación, campos, origen, base legal, respuestas, errores y motivos de rechazo.

Dirección en el panel: /app/integracoes/documentacao

La pantalla API de entrada de leads en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: Mediante los botones "Documentação da API" (Documentación de la API), "Documentação completa" (Documentación completa) y "Ver a documentação" (Ver la documentación) de la pestaña Entrada de leads, cuando el panel está en una dirección de marca propia; en la dirección de la plataforma, los mismos botones abren la página pública en una pestaña nueva.

Parte superior de la documentación

Botones y acciones

"Enviar o primeiro lead" (Enviar el primer lead)
Salta a la sección Enviar leads.
"Ver os campos" (Ver los campos)
Salta a la sección "Campos do lead" (Campos del lead).
  • Insignia "Documentação da API · versão 1" (Documentación de la API · versión 1), la fecha de actualización y las insignias "Chave por integração" (Clave por integración), JSON · UTF-8 y "Mensagens em português" (Mensajes en portugués).
  • Un ejemplo de lead enviado escribiéndose en el momento, con la respuesta de lead creado.
  • El endpoint (URL) de la API es el de su cuenta y aparece en los ejemplos de la propia pantalla.

"Nesta página" (En esta página)

El índice que acompaña la lectura, con una barra de progreso en la parte superior.

Botones y acciones

"Voltar ao topo" (Volver arriba)
Vuelve al comienzo de la documentación.
  • "Começando" (Comenzando): "Visão geral" (Resumen), "Autenticação" (Autenticación) y Enviar leads.
  • "Referência" (Referencia): "Campos do lead" (Campos del lead), "Origem do anúncio" (Origen del anuncio), Base legal (LGPD), "Primeiro contato" (Primer contacto), "Resposta" (Respuesta), "Erros" (Errores), "Motivos de recusa" (Motivos de rechazo) y "Atualizar a etapa" (Actualizar la etapa).
  • "Boas práticas" (Buenas prácticas): "Repetidos e reenvio" (Duplicados y reenvío), "Limites" (Límites), "Formato do seu sistema" (Formato de su sistema) y "Depois que o lead entra" (Después de que el lead ingresa).
  • En una pantalla estrecha, el índice se convierte en una lista que se abre y se cierra.
  • Cada título de sección tiene un botón que copia el enlace directo a ella.

Ejemplos de código

Botones y acciones

cURL
Muestra el envío en cURL.
JavaScript
Muestra el envío en JavaScript.
Python
Muestra el envío en Python.
PHP
Muestra el envío en PHP.
"Tudo certo" (Todo en orden)
Muestra la respuesta de cuando el lead ingresó.
"Com recusa" (Rechazadas)
Muestra la respuesta con un lead rechazado y el motivo.
"Chave inválida" (Clave inválida)
Muestra la respuesta de clave inválida.
"Muitas chamadas" (Demasiadas solicitudes)
Muestra la respuesta de cuando el sistema hace demasiadas llamadas.
"Copiar o endereço" (Copiar la dirección)
Copia el endpoint (URL) de envío.
"Copiar os cabeçalhos" (Copiar los encabezados)
Copia los encabezados de autenticación.
"Copiar o exemplo" (Copiar el ejemplo)
Copia el ejemplo del lenguaje abierto.
"Copiar o lead completo" (Copiar el lead completo)
Copia el ejemplo de lead con todos los campos.
"Copiar a resposta" (Copiar la respuesta)
Copia la respuesta abierta.
"Copiar o exemplo de atualizar a etapa" (Copiar el ejemplo de actualizar la etapa)
Copia el ejemplo de cambio de etapa hecho por su sistema.

¿Le resultó útil esta página?

Campos y filtros

"O que faltou?" (¿Qué faltó?)
Después de "Não" (No), un campo para contar qué buscaba y no encontró.

Botones y acciones

"Sim" (Sí)
Registra que la página fue útil.
"Não" (No)
Abre el campo "O que faltou?" (¿Qué faltó?).
Enviar
Envía el comentario; el equipo lee cada mensaje.
"Abrir Integrações no painel" (Abrir Integraciones en el panel)
Al final de la página, vuelve a la pestaña Entrada de leads.

"Webhooks de saída" (Webhooks de salida)

La pantalla "Webhooks de saída" (Webhooks de salida) es la documentación, dentro del panel, para quien programa la recepción de los avisos: cómo recibir, cómo verificar la firma, el envelope, los eventos, los encabezados, los nuevos intentos y la pausa automática.

Dirección en el panel: /app/integracoes/documentacao/webhooks

La pantalla "Webhooks de saída" (Webhooks de salida) en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: Mediante el botón "Documentação dos webhooks" (Documentación de los webhooks) de la tarjeta "Para quem vai programar o recebimento" (Para quien va a programar la recepción), en la pestaña Webhooks, cuando el panel está en una dirección de marca propia; en la dirección de la plataforma, el botón abre la página pública en una pestaña nueva.

Parte superior de la documentación

Botones y acciones

"Conferir a assinatura" (Verificar la firma)
Salta a la sección que explica cómo verificar la firma del aviso.
"Ver os eventos" (Ver los eventos)
Salta a la lista de eventos.
  • Insignia "Documentação dos webhooks · versão 1" (Documentación de los webhooks · versión 1), la fecha de actualización y las insignias de eventos, JSON · UTF-8 y firma.
  • Un ejemplo de aviso de lead calificado llegando a su sistema.

"Nesta página" (En esta página)

Botones y acciones

"Voltar ao topo" (Volver arriba)
Vuelve al comienzo de la documentación.
Node.js
Muestra la verificación de la firma en Node.js.
  • "Começando" (Comenzando): "Visão geral" (Resumen), "Receber um aviso" (Recibir un aviso) y "Conferir a assinatura" (Verificar la firma).
  • "Referência" (Referencia): Envelope, "Os 13 eventos" (Los 13 eventos), "Dados pessoais" (Datos personales) y "Cabeçalhos" (Encabezados).
  • "Boas práticas" (Buenas prácticas): "Novas tentativas" (Nuevos intentos), Pausa automática, "Ordem e duplicidade" (Orden y duplicidad), "Evento de teste" (Evento de prueba) y Registro de entregas.
  • Ejemplos de verificación de la firma en Node.js, Python y PHP.

Final de la página

Botones y acciones

"Sim" (Sí)
Registra que la página fue útil.
"Não" (No)
Abre el campo "O que faltou?" (¿Qué faltó?).
"Abrir Webhooks no painel" (Abrir Webhooks en el panel)
Vuelve a la pestaña Webhooks de "Integrações" (Integraciones).

Webhooks

La pestaña Webhooks sirve para registrar los endpoints (URL) de su CRM u otro sistema que reciben un aviso firmado en el momento en que un lead llega, se califica, pasa a un agente, cambia de etapa o se convierte en venta, y la pestaña Entregas muestra cada aviso enviado con la respuesta.

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

La pantalla Webhooks en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: "Integrações" (Integraciones), pestaña Webhooks. La pestaña Entregas está al lado; el botón "Abrir o registro completo" (Abrir el registro completo) del panel lateral de un webhook abre la pestaña Entregas ya filtrada por él.

Acceso directo a los webhooks de entrada

Aparece solo con el módulo "Base avançada" (Base avanzada) activo.

  • Tarjeta Webhooks de entrada · en la "Base avançada" (Base avanzada): lleva a los avisos que su sistema envía al panel, con reglas de "cuando llegue X, haga Y".

Números de los webhooks

  • "Entregues · 7 dias" (Entregadas · 7 días), con la variación frente a la semana pasada.
  • Tasa de entrega de las entregas de los últimos 7 días; cuando parte de las fallas vino de un endpoint (URL) ya pausado, la frase indica cuántas.
  • Respuesta promedio de los sistemas que reciben.
  • "Tentando de novo" (Reintentando), con la hora del próximo intento o ninguno en la cola.

Tarjeta del webhook

Una tarjeta por endpoint (URL) registrado.

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; las fallas se reenvían desde el registro de entregas.
"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). Con el webhook pausado, queda deshabilitado con la sugerencia "Ative o webhook para testar" (Active el webhook para probar).
"Editar webhook ‹endereço›" (Editar webhook ‹dirección›)
Botón de lápiz: abre el formulario de edición del webhook.
"Excluir webhook ‹endereço›" (Eliminar webhook ‹dirección›)
Botón de papelera: abre la confirmación de eliminación.
"Ver na lista de entregas" (Ver en la lista de entregas)
En el resultado de la prueba, abre el panel lateral de entregas.
  • El endpoint (URL) dividido en dominio y ruta.
  • Insignia "Ativo" (Activo), Pausado o "Pausado automaticamente" (Pausado automáticamente); insignia "Com dados pessoais" (Con datos personales) o "Sem dados pessoais" (Sin datos personales); quién lo creó y cuándo.
  • Los eventos que recibe el endpoint (URL), en etiquetas; los que pasan de cinco quedan en un +N con la lista al pasar el mouse.
  • Salud de los últimos 7 días: el porcentaje entregado, las fallas, el último envío con "Entregue" (Entregado), "Não entregue" (No entregado), "Tentando de novo" (Reintentando) o "Nunca disparado" (Nunca disparado), y la barra (roja cuando fallan más de las que se entregan).
  • El resultado de la prueba aparece en la propia tarjeta: "Enviando o teste" (Enviando la prueba), "Entregue" (Entregado) con el tiempo, "Não entregue" (No entregado) con el motivo, o "Aguardando" (Pendientes).

Para quien va a programar la recepción

La tarjeta para mostrar al equipo que administra su CRM.

Botones y acciones

"Documentação dos webhooks" (Documentación de los webhooks)
Abre la documentación completa de los webhooks de salida.
"Copiar os cabeçalhos de cada aviso" (Copiar los encabezados de cada aviso)
Copia el ejemplo de los encabezados.
  • Cómo saber que el aviso es suyo: leer los encabezados X-Webhook-Timestamp y X-Webhook-Signature-V2, calcular la firma con el secreto y comparar, y usar X-Webhook-Id para no procesar el mismo aviso dos veces.
  • Encabezados de cada aviso, en ejemplo.
  • Si su sistema no responde: la secuencia de nuevos intentos, hasta que la plataforma deja de intentar; una respuesta de éxito cuenta como entregada.
  • Después de muchos avisos seguidos sin éxito, el webhook se pausa y usted recibe un aviso por correo electrónico y en la campana; todo queda en el registro con el botón Reenviar.

Diálogo "Novo webhook" (Nuevo webhook)

Indique adónde enviar y qué avisar; el mismo diálogo se abre como "Editar webhook" (Editar webhook).

Campos y filtros

"Endereço que vai receber" (Dirección que recibirá)obligatorio
El endpoint (URL) seguro (https) que su sistema reservó para los avisos. Un endpoint sin https, inválido o de red interna se rechaza con una explicación.
"O que avisar" (Qué avisar)obligatorio
Los eventos en grupos (Leads, "Funil" (Embudo), "Atendimento" (Atención) y Pedidos), con el conteo de los marcados. Un webhook nuevo ya viene con "lead criado" (lead creado), "qualificado" (calificado), "atribuído" (asignado), "mudou de etapa" (cambió de etapa), "venda" (venta) y perdido marcados.
"Segredo de assinatura" (Secreto de firma)
En la edición, el secreto enmascarado. Solo aparece completo una vez, cuando se crea el webhook.

Botones y acciones

Marcar todos
Marca todos los eventos del grupo; con el grupo completo marcado, pasa a Desmarcar.
"Enviar dados pessoais" (Enviar datos personales)
Cuando aparece, activa el envío de nombre, teléfono, correo electrónico y resumen de la conversación a este endpoint (URL), después de una confirmación. Desactivarlo es directo.
"Gerar segredo novo" (Generar secreto nuevo)
En la edición, pide confirmación y genera un secreto nuevo; el actual deja de valer al instante.
"Manter o atual" (Mantener el actual)
Desiste de generar el secreto nuevo.
"Excluir" (Eliminar)
En la edición, abre la confirmación de eliminación.
Cancelar
Cierra sin guardar.
"Criar webhook" (Crear webhook)
Crea el webhook y muestra la pantalla "Webhook criado" (Webhook creado), con el secreto de firma.
"Salvar alterações" (Guardar cambios)
Guarda; los cambios valen a partir del próximo aviso.
"Copiar o segredo de assinatura" (Copiar el secreto de firma)
En la pantalla "Webhook criado" (Webhook creado), copia el secreto, que no vuelve a aparecer.
"Enviar evento de teste" (Enviar evento de prueba)
En la pantalla "Webhook criado" (Webhook creado), abre la prueba del webhook.
"Concluir" (Finalizar)
Cierra y lleva el foco al botón "Testar" (Probar) de la tarjeta nueva.
  • Cada evento tiene un nombre en portugués y una descripción: "Lead criado" (Lead creado), "Lead qualificado" (Lead calificado), "Lead quente" (Lead caliente), "Pediu para não receber mensagens" (Pidió no recibir mensajes), "Dados apagados (LGPD)" (Datos eliminados (LGPD)), "Mudou de etapa" (Cambió de etapa), "Venda (ganho)" (Venta (ganada)), "Perdido" (Perdido), "Negócio reaberto" (Negocio reabierto), "Atribuído a um atendente" (Asignado a un agente), "Transbordo para humano" (Traspaso a una persona), "Primeiro contato" (Primer contacto) y "Pedidos importados" (Pedidos importados).
  • Sin el interruptor de datos personales, el formulario advierte que el sistema recibe solo identificadores: ID del lead, etapa, puntaje, valores y campos del negocio que no son sensibles.
  • Cada aviso se envía firmado en el encabezado X-Webhook-Signature-V2.

Diálogo "Ligar dados pessoais?" (¿Activar datos personales?)

La confirmación antes de activar los datos personales en un webhook.

Botones y acciones

"Manter desligado" (Mantener desactivado)
Se cierra sin activarlo.
"Ligar dados pessoais" (Activar datos personales)
Lo activa solo para este webhook; el cambio queda en la auditoría con quién lo activó y cuándo.
  • Muestra lo que pasará a salir en el aviso "Lead qualificado" (Lead calificado), con las líneas nuevas resaltadas.

Diálogo "Enviar evento de teste" (Enviar evento de prueba)

Envía un ejemplo con datos ficticios al endpoint (URL).

Campos y filtros

Evento
Solo los eventos que recibe el webhook, en grupos, con la descripción del evento elegido.

Botones y acciones

"Copiar corpo" (Copiar cuerpo)
Copia el cuerpo del ejemplo que se enviará.
"Enviar teste" (Enviar prueba)
Envía el ejemplo; el resultado aparece en la tarjeta en unos segundos.
Cancelar
Cierra sin enviar.

Diálogo "Excluir este webhook?" (¿Eliminar este webhook?)

Botones y acciones

"Excluir webhook" (Eliminar webhook)
Lo elimina: el endpoint (URL) deja de recibir avisos de inmediato y su registro de entregas se elimina junto con él.
Cancelar
Cancela la eliminación; el foco pasa a este botón.

Panel lateral "Entregas do webhook" (Entregas del webhook)

Las entregas de un webhook, sin salir de la pestaña.

Botones y acciones

Todas
Muestra todas las entregas del webhook.
"Entregues" (Entregadas)
Muestra solo las entregadas.
"Falharam" (Fallidos)
Muestra solo las que fallaron.
Reenviar
Reenvía la entrega abierta con el mismo ID de evento, para que su sistema no la duplique.
"Abrir o registro completo" (Abrir el registro completo)
Abre la pestaña Entregas ya filtrada por este webhook.
  • Cada entrega se abre con la respuesta, el error y el cuerpo enviado, con el botón "Copiar corpo" (Copiar cuerpo).
  • El distintivo "Atualiza sozinho" (Se actualiza solo) mientras la lista sigue los envíos.

Pestaña Entregas: "Registro de entregas" (Registro de entregas)

Todo lo que se envió a sus sistemas en los últimos 30 días.

Campos y filtros

Filtrar por webhook
Todos los webhooks o un solo endpoint (URL).
Filtrar por evento
Todos los eventos o uno solo, en grupos.
"Buscar por lead ou ID do evento" (Buscar por lead o ID del evento)
Busca por el nombre del lead o por el ID del evento.

Botones y acciones

Todas
Muestra todas las entregas, con el total.
"Entregues" (Entregadas)
Muestra las entregadas.
"Falharam" (Fallidos)
Muestra las que fallaron.
"Ver só esse endereço" (Ver solo esta dirección)
Filtra la lista por el endpoint (URL) pausado que causó las fallas.
"Corpo enviado" (Cuerpo enviado)
Muestra el cuerpo que se envió.
"Resposta" (Respuesta)
Muestra el inicio de la respuesta de su sistema.
"Cabeçalhos" (Encabezados)
Muestra los encabezados enviados.
Reenviar
Reenvía con el mismo ID de evento. En un webhook pausado, primero pide "Reativar e reenviar" (Reactivar y reenviar).
"Reativar e reenviar" (Reactivar y reenviar)
Reactiva el webhook pausado y reenvía la entrega.
"Copiar corpo" (Copiar cuerpo)
Copia el cuerpo enviado para probarlo en su sistema.
"Limpar filtros" (Limpiar filtros)
En el resultado vacío de un filtro, quita todos los filtros.
"Carregar mais antigas" (Cargar anteriores)
Carga entregas más antiguas.
"Ir para os webhooks" (Ir a los webhooks)
En el registro vacío, vuelve a la pestaña Webhooks.
  • "Saúde · últimos 7 dias" (Salud · últimos 7 días): la tasa destacada, "Entregues" (Entregadas), "Falharam" (Fallidos), "Tentando de novo" (Reintentando) y "Resposta média" (Respuesta promedio).
  • Gráfico de entregas por día: cada barra es un botón que muestra el día, las entregas, las fallas con el motivo y las pausas.
  • Lista agrupada por día, de la más reciente a la más antigua, en hora de Brasilia. Cada fila muestra el evento, el lead, la hora, el resumen, el endpoint (URL), el intento y el estado: "Entregue" (Entregado), "Tentando de novo" (Reintentando), "Não entregue" (No entregado) o "Na fila" (En la fila).
  • Al abrir una entrega: el aviso, cada intento con su código y tiempo, y las pestañas "Corpo enviado" (Cuerpo enviado), "Resposta" (Respuesta) y "Cabeçalhos" (Encabezados).

Estados de la pantalla

Cargando
Números y tarjetas grises mientras se cargan los webhooks y el registro.
Aún sin datos
Aún no hay webhooks, con "Novo webhook" (Nuevo webhook) y "Ver como funciona" (Ver cómo funciona). En el registro, "Nenhuma entrega ainda" (Aún no hay entregas), con "Ir para os webhooks" (Ir a los webhooks).
Si hay un error
"Não conseguimos carregar os seus webhooks agora" (No pudimos cargar sus webhooks en este momento) (o el registro), con "Tentar de novo" (Intentar de nuevo); los avisos siguen saliendo con normalidad.
Quien abre no es el Propietario de la cuenta
Los webhooks son del Propietario de la cuenta: solo el Propietario crea, modifica y supervisa los avisos. Esto se aplica a las pestañas Webhooks y Entregas.
El webhook se pausó automáticamente
La tarjeta muestra el distintivo "Pausado automaticamente" (Pausado automáticamente) y el aviso muestra "Reativar" (Reactivar) y "Ver as falhas" (Ver las fallas).
Filtro del registro sin resultados
"Nenhuma entrega com estes filtros" (Ninguna entrega con estos filtros), con "Limpar filtros" (Limpiar filtros).

"Conversões" (Conversiones)

La pestaña "Conversões" (Conversiones) sirve para devolver a Meta, mediante la API de Conversiones, cada lead calificado, etapa del embudo y venta, para que las campañas busquen personas parecidas a quienes compran y no solo a quienes hacen clic.

Dirección en el panel: /app/integracoes/conversoes

La pantalla "Conversões" (Conversiones) en la cuenta de demostración, con datos ficticios y los valores desenfocados.

Cómo llegar: "Integrações" (Integraciones), pestaña "Conversões" (Conversiones). El aviso de la campana por token rechazado también lleva a esta pestaña.

Encabezado y "Enviar conversões" (Enviar conversiones)

La explicación, el camino del anuncio a la venta y el control general del envío.

Botones y acciones

"Enviar conversões" (Enviar conversiones)Propietario
Interruptor que activa o desactiva el envío de todas las etapas a Meta. Solo se activa después de verificar la conexión.
  • Título "Ensine seus anúncios a trazer quem compra, não só quem clica." (Enseñe a sus anuncios a atraer a quienes compran, no solo a quienes hacen clic.)
  • El camino "Anúncio" (Anuncio), "Lead qualificado" (Lead calificado), "Etapas do quadro" (Etapas del tablero) y "Venda" (Venta), con el ciclo de vuelta a la campaña.
  • Enviadas · 7 días y "Casadas" (Coincidentes) (el porcentaje que coincide por el ID del formulario del anuncio).
  • La frase de estado: activado desde cuándo y por quién, desactivado, listo para activar, o detenido hasta cambiar el token, con cuántas conversiones están en espera.
  • Distintivo "Enviando em tempo real" (Enviando en tiempo real), "Envio desligado" (Envío desactivado) o "Parado até trocar o token" (Detenido hasta cambiar el token).

Franja de token rechazado

Aparece en la parte superior cuando Meta rechazó el token o cuando es necesario pegar el token de nuevo.

Botones y acciones

"Trocar token" (Cambiar token)Propietario
Lleva al paso 1 y abre el campo del token.
  • Indica cuántas conversiones están en espera; salen solas cuando se cambia el token. Para quien no es Propietario, pide que el Propietario lo cambie.

Paso 1: Conectar a su conjunto de datos

Usted genera el token en su cuenta de Meta y lo pega aquí, junto con el código de prueba; no se solicita contraseña ni acceso a la cuenta de anuncios.

Campos y filtros

"ID do conjunto de dados" (ID del conjunto de datos)obligatorio
Solo números; en el Administrador de eventos, el número en Identificación, debajo del nombre del conjunto de datos.
"Token de acesso" (Token de acceso)obligatorio
Pegue el token; una vez guardado, no se vuelve a mostrar completo.
"Código de teste" (Código de prueba)obligatorio
El código TEST de la pestaña Eventos de prueba, canal Sitio web; la verificación envía un evento de prueba con él.

Botones y acciones

Mostrar tokenPropietario
Muestra el token escrito; pasa a ser Ocultar token.
"Conferir conexão" (Verificar conexión)Propietario
Envía un evento de prueba a Meta y guarda la conexión cuando se acepta.
"Trocar token" (Cambiar token)Propietario
Abre el formulario para pegar un token nuevo.
"Conferir de novo" (Verificar de nuevo)Propietario
Verifica de nuevo la conexión ya guardada.
CancelarPropietario
Cierra el cambio de token sin modificar nada.
  • Distintivo del paso: "Conectado" (Conectado), "Falta conectar" (Falta conectar), "Token recusado" (Token rechazado) o "Cole o token de novo" (Pegue el token de nuevo).
  • Cuando está conectado, muestra el "Conjunto de dados" (Conjunto de datos), el "Token de acesso" (Token de acceso) guardado de forma segura y la "Última conferência" (Última verificación).
  • Dónde generar el token: tres pasos ilustrados en el Administrador de eventos.

Paso 2: Elegir qué enviar

Cada etapa del tablero se convierte en un evento en Meta; la venta ganada va con el valor del negocio. Se habilita después de verificar la conexión.

Campos y filtros

"Quadro" (Cuadro)
El tablero del "Funil" (Embudo) cuyas etapas se convierten en eventos; cada columna declara su papel en el embudo.

Botones y acciones

"Evento na Meta:" (Evento en Meta:)Propietario
Cada fila tiene la etapa, el papel, el evento en Meta y un interruptor que activa o desactiva esa etapa; el cambio se guarda al instante y muestra "Salvo" (Guardado).
"Abrir o Funil" (Abrir Embudo)
Cuando no hay tablero, abre el "Funil" (Embudo) para crear uno.
  • Distintivo que indica cuántas de las etapas disponibles están activadas.
  • La columna de entrada y la de perdido no se convierten en evento; la venta ganada sale como "Compra" (Compra), con el valor del negocio.
  • En sectores de salud, las conversiones aún no se envían, y las filas muestran "Não sai neste segmento" (No se envía en este sector).

Paso 3: Probar

Envíe un evento de prueba y verifique en la pestaña de pruebas del Administrador de eventos que llegó.

Campos y filtros

"Código de teste" (Código de prueba)
El código de la pestaña de pruebas; sin él, el evento contaría como real.
Evento
Qué etapa activada se usa en la prueba.

Botones y acciones

"Enviar evento de teste" (Enviar evento de prueba)Propietario
Envía el evento de prueba con un identificador inventado que no coincide con ningún cliente suyo.
"Ver o que sai no evento de teste" (Ver qué se envía en el evento de prueba)
Muestra el cuerpo enviado a Meta.

Calidad de la coincidencia

Cómo se vinculó cada conversión a una persona en Meta.

Botones y acciones

"7 dias" (7 días)
Muestra el período de 7 días.
"30 dias" (30 días)
Muestra el período de 30 días.
  • Enviadas, "Aguardando" (Pendientes), "Recusadas" (Rechazadas) y "Puladas" (Omitidas).
  • La barra dividida entre "ID do formulário" (ID del formulario) y "Telefone e e-mail criptografados" (Teléfono y correo electrónico cifrados).
  • "Por etapa" (Por etapa): cuántas de cada etapa se enviaron.
  • La nota de calidad que calcula Meta está en el Administrador de eventos; la pantalla no inventa ese número.

"Registro de envios" (Registro de envíos)

Cada conversión que salió, está en la fila o se omitió, con el motivo.

Botones y acciones

Todos
Muestra todos los envíos.
Enviados
Muestra los enviados.
"Aguardando" (Pendientes)
Muestra los que están en espera.
"Recusados" (Rechazados)
Muestra los rechazados por Meta.
"Pulados" (Omitidos)
Muestra los omitidos, con el motivo.
ReenviarPropietario
Reenvía la conversión rechazada con el mismo ID, sin duplicarla.
"Mostrar mais" (Mostrar más)
Carga más filas del registro.
  • Columnas "Quando" (Cuándo), Lead, Evento, "Casamento" (Coincidencia), "Situação" (Estado), "Tentativas" (Intentos) y "Ação" (Acción), en hora de Brasilia.
  • La venta marcada por su sistema aparece como "Marcada pelo seu sistema" (Marcada por su sistema).

Qué se envía a Meta y qué nunca se envía

Botones y acciones

"Política de privacidade" (Política de privacidad)
Abre la política de privacidad.
  • Se envía: la etapa alcanzada y la hora, el valor de la venta, el ID del formulario del anuncio y, sin él, el teléfono y el correo electrónico cifrados.
  • Nunca se envía: el nombre del lead, la conversación y el resumen de la IA, el teléfono o el correo electrónico en texto abierto, los campos del negocio, y nada de quien pidió no recibir mensajes o tuvo sus datos eliminados.
  • Meta no cobra por estos envíos y su saldo no se toca.

Estados de la pantalla

Cargando
Bloques grises para el encabezado y los tres pasos.
Aún sin datos
Aún no se envió ninguna conversión: aparece en lugar del registro hasta que se conecte y se active el envío.
Si hay un error
"Não conseguimos carregar as conversões agora" (No pudimos cargar las conversiones en este momento), con "Tentar de novo" (Intentar de nuevo); el envío a Meta sigue funcionando.
Primera vez, sin conexión
Los pasos 2 y 3 quedan bloqueados con "Liberado depois que a conexão for conferida" (Se habilita después de verificar la conexión).
Quien abre no es el Propietario
Solo el Propietario de la cuenta conecta, activa el envío y envía la prueba; los campos y los interruptores aparecen bloqueados.
La cuenta aún no tiene la función
Las conversiones aún no están disponibles en esta cuenta.

Paso a paso

Cómo crear una integración para recibir leads de otro sistema

  1. Abra "Integrações" (Integraciones) en el menú y permanezca en la pestaña Entrada de leads.
  2. Haga clic en "Nova integração" (Nueva integración).
  3. En "Nome da integração" (Nombre de la integración), escriba un nombre fácil de reconocer y elija el origen en "De onde vêm esses leads?" (¿De dónde vienen estos leads?). Haga clic en Continuar.
  4. Elija la base legal en "Por que você pode falar com essas pessoas?" (¿Por qué usted puede contactar a estas personas?) y haga clic en Continuar.
  5. Decida si el primer contacto sale automáticamente: con "Mandar a primeira mensagem sozinho pelo WhatsApp" (Enviar el primer mensaje automáticamente por WhatsApp) activado, elija la "Conta do WhatsApp" (Cuenta de WhatsApp), la "Modelo aprovado" (Plantilla aprobada) y el "Teto por dia" (Tope por día). Haga clic en Continuar.
  6. Elija el "Quadro do Funil" (Tablero del Embudo), la "Coluna de entrada" (Columna de entrada) y las Etiquetas automáticas, y haga clic en "Criar integração" (Crear integración).
  7. En la pantalla "Integração criada" (Integración creada), haga clic en "Copiar a chave" (Copiar la clave) y en "Copiar o endereço" (Copiar la dirección) y entregue ambos a quien se encarga de su sistema. La clave no se vuelve a mostrar.
  8. Haga clic en "Enviar lead de teste" (Enviar lead de prueba) para ver el camino funcionando, o en "Concluir" (Finalizar).

Cómo recibir en su propio WhatsApp el primer contacto de un lead de prueba

  1. En "Integrações" (Integraciones), pestaña Entrada de leads, haga clic en la tarjeta de la integración.
  2. En la tarjeta "Enviar lead de teste" (Enviar lead de prueba), active "Mandar o primeiro contato para o meu WhatsApp" (Enviar el primer contacto a mi WhatsApp).
  3. Complete "Seu celular" (Su celular) con el código de área.
  4. Haga clic en "Enviar lead de teste" (Enviar lead de prueba) y siga los cuatro pasos hasta "Entregue" (Entregado) en su WhatsApp.
  5. Responda el mensaje en su celular para ver a la IA asumir la conversación. El lead aparece en la parte superior de "Últimos leads recebidos" (Últimos leads recibidos) con el distintivo "Teste" (Prueba).

Cómo ajustar el horario, el recontacto y el tope del primer contacto automático

  1. En "Integrações" (Integraciones), pestaña Entrada de leads, elija la integración y haga clic en "Ajustar primeiro contato" (Ajustar primer contacto).
  2. Verifique que "Mandar a primeira mensagem sozinho" (Enviar el primer mensaje automáticamente) esté activado.
  3. En "Conta e modelo" (Cuenta y plantilla), elija la plantilla aprobada y, si la plantilla tiene espacios variables, indique qué va en cada uno y el texto de "Se faltar, usar" (Si falta, usar).
  4. En "Regras de envio" (Reglas de envío), elija el horario en "Das" (Desde) y "às" (hasta las), cuántos días esperar para no escribir de nuevo a la misma persona y el "Teto por dia" (Tope por día).
  5. Revise la vista previa en "Como o lead recebe" (Cómo recibe el lead) y el costo en "Custo por envio" (Costo por envío).
  6. Haga clic en "Salvar" (Guardar) en la barra inferior de la pantalla.

Cómo generar una nueva clave de integración cuando la anterior se filtró o se perdió

  1. Coordine con quien se encarga de su sistema: la clave anterior deja de funcionar de inmediato.
  2. En "Integrações" (Integraciones), pestaña Entrada de leads, haga clic en "Mais" (Más) en la tarjeta de la integración y elija "Gerar nova chave" (Generar nueva clave) (o haga clic en "Gerar nova" (Generar nueva) en la tarjeta "Como conectar" (Cómo conectar)).
  3. Confirme en "Gerar nova chave" (Generar nueva clave).
  4. Haga clic en "Copiar a chave nova" (Copiar la nueva clave), cambie la clave en su sistema y haga clic en "Já guardei a chave" (Ya guardé la clave).

Cómo recibir leads de un sistema que envía un formato propio

  1. En la tarjeta "Como conectar" (Cómo conectar) de la integración, haga clic en "Receber no formato do seu sistema" (Recibir en el formato de su sistema).
  2. Pegue en "Exemplo do seu sistema" (Ejemplo de su sistema) un ejemplo real de lo que envía el sistema y haga clic en Encontrar campos.
  3. En Campos encontrados, elija el destino de cada campo y vincule al menos uno a "Telefone" (Teléfono).
  4. Revise la vista previa en "Assim ficaria o lead" (Así quedaría el lead) y haga clic en "Salvar formato" (Guardar formato).

Cómo crear un webhook para avisar al CRM cuando un lead se califica o se convierte en venta

  1. En "Integrações" (Integraciones), abra la pestaña Webhooks y haga clic en "Novo webhook" (Nuevo webhook).
  2. Complete "Endereço que vai receber" (Dirección que recibirá) con el endpoint (URL) https de su sistema.
  3. En "O que avisar" (Qué avisar), marque los eventos; Marcar todos marca un grupo completo.
  4. Haga clic en "Criar webhook" (Crear webhook) y luego en "Copiar o segredo de assinatura" (Copiar el secreto de firma): aparece una sola vez.
  5. Haga clic en "Enviar evento de teste" (Enviar evento de prueba), elija el Evento y haga clic en "Enviar teste" (Enviar prueba). El resultado aparece en la tarjeta.

Cómo reenviar un aviso de webhook que no se entregó

  1. Primero corrija el problema en el sistema que recibe.
  2. En "Integrações" (Integraciones), abra la pestaña Entregas y haga clic en "Falharam" (Fallidos).
  3. Abra la entrega y revise la pestaña "Resposta" (Respuesta).
  4. Haga clic en Reenviar. Si el webhook está pausado, confirme en "Reativar e reenviar" (Reactivar y reenviar). El aviso sale con el mismo ID de evento, sin duplicarse en su sistema.

Cómo activar las conversiones de Meta para que los anuncios aprendan de las ventas

  1. En el Administrador de eventos de Meta, genere el token de acceso del conjunto de datos y copie el código de prueba.
  2. En "Integrações" (Integraciones), abra la pestaña "Conversões" (Conversiones).
  3. En el paso 1, complete "ID do conjunto de dados" (ID del conjunto de datos), "Token de acesso" (Token de acceso) y "Código de teste" (Código de prueba) y haga clic en "Conferir conexão" (Verificar conexión).
  4. En el paso 2, elija el "Quadro" (Cuadro) y active las etapas que deben convertirse en eventos.
  5. En el paso 3, haga clic en "Enviar evento de teste" (Enviar evento de prueba) y verifique que llegó al Administrador de eventos.
  6. Active "Enviar conversões" (Enviar conversiones) en la parte superior de la pestaña.

Preguntas frecuentes

¿Dónde encuentro el endpoint (URL) para que mi sistema envíe los leads?

En la tarjeta "Como conectar" (Cómo conectar) de la integración, en el campo "Endereço do envio" (Dirección de envío), con el botón de copiar. El mismo endpoint (URL) aparece en los ejemplos de la pantalla de documentación de la API.

¿El lead de prueba entra en los números y en los informes?

No. Aparece en la parte superior de "Últimos leads recebidos" (Últimos leads recibidos) con el distintivo "Teste" (Prueba), pero no entra en los números de la integración, en los informes ni en los webhooks.

¿Qué pasa si mi sistema envía el mismo lead dos veces?

El reenvío repetido se ignora, sin costo y sin mensaje nuevo. La tarjeta de la integración y el registro muestran cuántos reenvíos repetidos se ignoraron en los últimos 7 días.

¿Por qué no puedo activar el primer contacto en una integración?

El interruptor queda bloqueado cuando la base legal es "São meus clientes" (Son mis clientes), cuando no hay una cuenta de WhatsApp conectada, cuando no es posible confirmar quién paga el envío de la plantilla o cuando quien abre no es el Propietario de la cuenta.

Se acabó el saldo. ¿Los leads pierden el primer contacto?

No de inmediato. La pantalla del primer contacto muestra cuántos leads están esperando y, al recargar el saldo, los mensajes salen solos para quienes llegaron en las últimas 24 horas.

Pausé un webhook. ¿Se conservan los avisos de ese período?

No. Mientras está pausado, no se envía nada y los eventos de ese período no quedan en la fila. Lo que falló antes de la pausa permanece en el registro de entregas y se puede reenviar después de reactivarlo.

¿Eliminar un webhook borra el historial de entregas?

Sí. El endpoint (URL) deja de recibir avisos de inmediato y su registro de entregas se elimina junto con él.

¿El Administrador de la cuenta puede crear integraciones y webhooks?

No. El Administrador ve las integraciones, el registro y la pantalla del primer contacto sin los botones de cambio. Los webhooks, las entregas y el envío de conversiones quedan con el Propietario de la cuenta.

¿Mi sistema puede cambiar la etapa del lead en el Embudo?

Sí, si el interruptor "Este sistema pode atualizar as etapas do funil" (Este sistema puede actualizar las etapas del embudo) está activado en la integración. Desactivado, la clave solo envía leads. La venta marcada por el sistema también va a las conversiones de Meta.

Guía del Centro de ayuda

"Integrações" (Integraciones)

Cuatro pestañas: recibir leads de otros sistemas, avisar a su sistema cuando algo ocurre aquí, dar seguimiento a cada aviso entregado y recibir los pedidos de sus ventas.

"Integrações" (Integraciones) es la pantalla que se conecta con los demás sistemas de su empresa. Tiene cuatro pestañas: Entrada de leads trae leads de otros sistemas hacia aquí, Webhooks avisa a su sistema cuando algo ocurre aquí, Entregas muestra cada aviso que salió y la respuesta de su sistema, y Pedidos recibe las ventas que alimentan el "Monitor de sucesso" (Monitor de éxito). Puede usar solo una, y la mayoría comienza por la entrada de leads.

Cada pestaña tiene su propia URL, así que puede enviar el enlace directo de cualquiera de ellas a quien se encarga de su sistema. Los webhooks, que antes estaban en "Configurações" (Configuración), ahora están aquí, tal como los dejó.

Entrada de leads

Cada sistema que envía leads (el distribuidor de sus anuncios, el formulario del sitio, un portal, su CRM) obtiene una integración con clave propia. El lead entra con el origen completo, va directo a la columna del "Funil" (Embudo) que usted elija y, si lo activa, recibe el primer mensaje por WhatsApp en segundos. El paso a paso completo, con base legal, costo y el lead de prueba, está en Recibir leads de otros sistemas.

El botón "Documentação da API" (Documentación de la API), en la parte superior de la pestaña, abre la página para quien programa: endpoint (URL), formato, ejemplos listos en varios lenguajes y el significado de cada respuesta.

En la pantalla: Pantalla de "Integrações" (Integraciones) en la pestaña Entrada de leads, con las pestañas Webhooks, Entregas y Pedidos al lado y las tarjetas de las integraciones. Las cuatro pestañas en la parte superior; Entrada de leads se abre primero.

Webhooks y Entregas: avisar a su sistema

En la pestaña Webhooks usted registra el endpoint (URL) de su sistema y elige, entre 13 eventos, qué avisar: lead creado, calificado, asignado a un agente, traspaso a una persona, cambió de etapa, venta, perdido y otros. Cada aviso sale firmado, se intenta hasta 6 veces y queda en la pestaña Entregas durante 30 días, con el botón Reenviar. Los avisos llevan identificadores y los campos del negocio que no son sensibles: el nombre, el teléfono y el correo electrónico del lead no salen.

El paso a paso, los eventos, los datos personales y qué hacer cuando una entrega falla están en Webhooks: avise a su CRM en cada paso. Un lead de prueba, creado con el botón "Enviar lead de teste" (Enviar lead de prueba) de la entrada de leads, nunca sale en un webhook: su sistema solo recibe avisos de leads reales.

Pedidos: recibir las ventas de su sistema

  1. Genere la clave: "Gerar chave" (Generar clave) crea la credencial que usará su sistema. Aparece completa una única vez: cópiela de inmediato y guárdela donde guarda sus contraseñas.
  2. Envíe el ejemplo a quien programa: El bloque de ejemplo ya viene con el endpoint (URL) de ingesta completado. "Copiar o exemplo" (Copiar el ejemplo) y la clave son todo lo que necesita el otro lado para la primera llamada.
  3. Envíe los pedidos: Cada pedido lleva un identificador de su lado (external_id). Enviar el mismo pedido de nuevo no lo duplica: se reconoce y se actualiza.
  4. Verifique en el "Monitor de sucesso" (Monitor de éxito): Un pedido que entró se convierte en el historial de compras del contacto y aparece en el Monitor de éxito. Si no apareció, el problema es la coincidencia con el contacto, el siguiente aviso.

Quién puede modificar

Cómo se ve cuando todo está bien

  • Cada sistema que envía leads con su propia integración, y los "Últimos leads recebidos" (Últimos leads recibidos) sin nada en "Com problema" (Con problemas).
  • Webhooks con la salud de los 7 días cerca del 100%, ninguno "Pausado automaticamente" (Pausado automáticamente) y el "Último envio" (Último envío) coincidiendo con el movimiento del día.
  • Las claves guardadas fuera del panel, junto con las demás credenciales de su sistema.
  • El aviso "Pediu para não receber mensagens" (Pidió no recibir mensajes) integrado con cualquier otra herramienta suya que envíe mensajes.
  • Pedidos entrando solos y el Monitor de éxito con datos del mes completo, y no del día en que alguien se acordó de subir una hoja de cálculo.

Los webhooks, los pedidos y las claves no debitan saldo. Lo que cuesta es el "Primeiro contato automático" (Primer contacto automático) de la entrada de leads, cuando usted lo activa en una cuenta de WhatsApp de la plataforma: el valor aparece antes de activarlo, y las reglas están en Recibir leads de otros sistemas.

En el panel: "Abrir Integrações" (Abrir Integraciones). Ábralo junto con quien se encarga de su sistema: las claves aparecen una sola vez.

Recibir leads de otros sistemas

Su distribuidor de leads, el formulario del sitio o su CRM envían el lead aquí, y la IA envía el primer mensaje por WhatsApp en segundos.

Entrada de leads es la primera pestaña de "Integrações" (Integraciones). Cada sistema que envía leads aquí recibe su propia integración: un nombre, una clave propia, la base legal declarada, el primer contacto por WhatsApp y el lugar del "Funil" (Embudo) donde nace la tarjeta. Todo lead que entra queda registrado, con el origen completo: campaña, conjunto, anuncio y UTM. El ID del anuncio vincula el lead con el gasto de la planilla en "Investimento → Venda" (Inversión → Venta).

Quien programa encuentra el endpoint (URL), los ejemplos de código y las respuestas de la API en el botón "Documentação da API" (Documentación de la API), en la parte superior de la pantalla. Esta guía es para quien configura y supervisa.

En la pantalla: La pestaña Entrada de leads con la presentación arriba y las tarjetas de tres integraciones activas, cada una con los números de los últimos 7 días. Cada tarjeta muestra la clave enmascarada, los números de la semana y si el primer contacto está activado.

Crear una integración

  1. Nombre y origen: "Nova integração" (Nueva integración) abre un asistente de cuatro pasos. Póngale un nombre que reconozca después ("Distribuidor — anuncios de Meta") e indique de dónde vienen los leads. El origen solo cambia el ícono y la ayuda del paso.
  2. Base legal: Indique por qué puede comunicarse con estas personas. Ninguna opción viene marcada: es una declaración suya, y queda registrada con su nombre. Las reglas de cada base están justo debajo.
  3. Primer contacto: Elija la cuenta de WhatsApp y la plantilla aprobada que sale sola para cada lead nuevo. La vista previa muestra el mensaje con un lead de ejemplo, y la franja de costo muestra cuánto cuesta cada envío antes de que usted lo active.
  4. Destino: El tablero y la columna del "Funil" (Embudo) donde nace la tarjeta, y las etiquetas que cada lead recibe al entrar. El asistente ya sugiere una etiqueta según el origen ("anuncio meta", por ejemplo): quítela con la X si no la quiere.
  5. Guarde la clave: Al crearla, la clave aparece una sola vez. Cópiela y entréguela a quien cuida de su sistema, junto con el endpoint (URL). Después de eso, la pantalla muestra solo su inicio y su final.
  6. Envíe un lead de prueba: Antes de activar su sistema, use "Enviar lead de teste" (Enviar lead de prueba) y observe cada paso mientras ocurre. La prueba se explica más abajo.

En la pantalla: Paso 3 del asistente de nueva integración: la cuenta de WhatsApp, la plantilla aprobada, la vista previa del mensaje con un lead de ejemplo y la franja de costo. En el paso 3, la vista previa muestra el mensaje con un lead de ejemplo y la franja indica cuánto cuesta cada envío.

La base legal de cada lead

Sin base legal, el lead se rechaza en la entrada y no se guarda ningún dato suyo. La base puede venir en el propio lead, enviada por su sistema, o ser la base predeterminada de la integración, la que usted eligió en el paso 2. Cuando existen las dos, vale la del lead, y el registro indica que vino de su sistema.

"Pediram para eu entrar em contato" (Me pidieron que los contactara)
La persona completó un formulario o un anuncio pidiendo contacto. Es la base correcta para leads de anuncios, y la que habilita el primer contacto automático.
"Já coletei o consentimento deles" (Ya recopilé su consentimiento)
La persona autorizó recibir mensajes de su empresa. También habilita el primer contacto automático.
"São meus clientes" (Son mis clientes)
Personas con quienes usted ya tiene contrato. El lead entra normalmente, pero el primer contacto automático no se envía: un mensaje de marketing a un cliente por contrato necesita su consentimiento.

En la ficha del lead, la base aparece como una frase: "Pediram para entrar em contato · declarada por Marcelo Antunes pela integração Distribuidor em 22/09/2026" (Pidieron ser contactados · declarada por Marcelo Antunes mediante la integración Distribuidor el 22/09/2026). Cambiar la base predeterminada después no borra quién la declaró en su momento.

El primer contacto automático

Con esta opción activada, todo lead nuevo con base legal recibe una plantilla aprobada por la cuenta de WhatsApp que usted eligió, firmada por la persona de esa cuenta. En el Inbox, el mensaje aparece con la etiqueta "Primeiro contato automático" (Primer contacto automático) y el nombre de la plantilla. Si el lead responde, la IA asume la conversación como siempre.

Al abrir la integración, "Ajustar primeiro contato" (Ajustar primer contacto) lleva a la pantalla completa: cuenta y plantilla, qué va en cada marcador del mensaje, las reglas de envío, la vista previa de cómo lo recibe el lead y el costo por envío. Nada cambia hasta que usted haga clic en "Salvar" (Guardar), en la barra que aparece abajo.

En la pantalla: La pantalla del primer contacto automático: los números de la semana, el interruptor, la cuenta y la plantilla elegidas, y la vista previa de cómo el lead recibe el mensaje. Si la plantilla elegida se pausa o se elimina en Meta, la pantalla y la tarjeta de la integración avisan que el primer contacto se detuvo.

"Horário de envio" (Horario de envío)
De 8h a 21h, en la zona horaria de su cuenta (hora de Brasilia, si no se configuró ninguna). El lead que llegue fuera de ese horario recibe el mensaje al comienzo del siguiente horario, y lo mismo vale para el mensaje que quedó esperando una recarga, respetando el tope por día. La IA sigue respondiendo las 24 horas si el lead escribe.
"Variáveis da mensagem" (Variables del mensaje)
Cada marcador de la plantilla recibe un dato del lead: nombre de pila, nombre completo, nombre de la empresa, de la persona, de la campaña o un campo que su sistema envió. Al crear la integración, el primer marcador ya viene con el nombre de pila y el segundo con el nombre de la persona. Un marcador sin valor usa el texto predeterminado que usted escriba a su lado. Sin texto predeterminado, el mensaje no se envía.
"Não mandar de novo para a mesma pessoa" (No enviar de nuevo a la misma persona)
Quien se registre de nuevo dentro del plazo elegido, por cualquier integración, no recibe otro primer mensaje.

Aun activado, el primer contacto no se envía, y el registro indica el motivo, cuando:

  • la persona pidió no recibir mensajes, aunque se registre de nuevo;
  • el contacto está marcado para no recibir campañas;
  • el número no es un celular de Brasil (el lead entra, y la IA responde si escribe);
  • un agente está en la conversación: el mensaje queda fuera y el historial del lead lo registra;
  • el lead ya está conversando con usted: la IA continúa sin gastar una plantilla;
  • ya hubo un primer contacto con esa persona dentro del plazo.

Cuánto cuesta y cuándo se cobra

El costo aparece en el paso 3 y en la pantalla del primer contacto, antes de que usted lo active. Depende de la cuenta de WhatsApp elegida y de la categoría de la plantilla.

"Conta da plataforma" (Cuenta de la plataforma)
Cada envío se debita de su saldo antes de salir, primero de la franquia del plan y después del saldo. Consulte el valor por categoría en "Saldo & Recargas" (Saldo y recargas).
"Conta própria do WhatsApp" (Cuenta propia de WhatsApp)
Sin costo en la plataforma. Meta cobra directamente a la tarjeta de su cuenta, según su propia tarifa. En el selector "Conta do WhatsApp" (Cuenta de WhatsApp), aparece con "conta própria" (cuenta propia) junto al número.
"Não enviado" (No enviado)
Meta rechazó el envío de inmediato, o la cuenta se desconectó antes de que saliera: hay certeza de que el mensaje no salió. El monto vuelve al saldo y el extracto muestra la devolución.
"Falhou depois de sair" (Falló después de salir)
Meta aceptó el envío y luego avisó que no pudo entregarlo (un número sin WhatsApp, por ejemplo). La tarifa ya corrió, por lo que el monto no vuelve. El mensaje aparece como "Falhou" (Fallido) en el Inbox.
"Envio não confirmado" (Envío no confirmado)
WhatsApp no confirmó si el mensaje salió. El monto queda debitado, porque el mensaje pudo haber llegado. Revise la conversación en el Inbox antes de hacer clic en Reenviar: reenviar crea un envío nuevo y vuelve a cobrar.
"Sem saldo" (Sin saldo)
El mensaje espera la recarga hasta 24 horas y sale solo cuando el saldo vuelve. Pasado ese plazo, se descarta.

Cuando el primer contacto de una integración se detiene (saldo insuficiente, plantilla pausada o eliminada en Meta, cuenta de WhatsApp desconectada, tope mensual alcanzado), la campana muestra el aviso mientras dure el problema, y la tarjeta de la integración indica qué se detuvo. En el celular llega como máximo un aviso por integración por día.

Dónde aparece el lead

Con un destino elegido, la tarjeta se crea directamente en la columna del tablero que usted indicó. El destino de la integración prevalece en el tablero elegido; los demás tableros siguen sus propias reglas. Sin destino, la tarjeta se crea en cada tablero que tenga una regla para leads nuevos, como ya ocurre hoy.

Cuando el teléfono ya pertenece a un lead suyo, nada se duplica: solo se completa lo que está vacío, las etiquetas se suman, y la ficha recibe la línea "Entrou de novo pela campanha X" (Volvió a ingresar por la campaña X). No se borra nada de lo que su equipo escribió, y quien ya tiene una tarjeta en el tablero de destino no recibe otra.

En la ficha, en el Inbox y en la tarjeta del "Funil" (Embudo), el lead recibe la insignia "Veio da integração" (Vino de la integración), con la campaña y el conjunto. La ficha muestra también los "Dados recebidos" (Datos recibidos): cada campo que su sistema envió, con un nombre legible.

Un campo en fields con el "Nome na API" (Nombre en la API) de un campo del negocio (en "Funil" (Embudo) → "Configurar quadro" (Configurar tablero) → "Campos do cartão" (Campos de la tarjeta)) completa ese campo en la tarjeta. Los campos de moneda se envían en BRL (450000 o "450.000,00"); los webhooks los devuelven en centavos. Un valor que no sirve para el campo (una fecha que no existe, una opción fuera de la lista) queda en "Dados recebidos" (Datos recibidos), y el registro de la entrada indica qué campo fue ignorado y por qué.

Actualizar la etapa desde su sistema

Con el permiso "Atualizar etapas" (Actualizar etapas) activado (al abrir la integración, en Editar), la misma clave mueve la tarjeta del lead en el tablero de destino (o en el tablero predeterminado, sin destino) mediante la ruta stage de la API, usando el "Nome na API" (Nombre en la API) de cada columna, que se encuentra en "Configurar quadro" (Configurar tablero) → "Colunas e etapas" (Columnas y etapas). El permiso viene desactivado, vale solo para esta integración y cada cambio queda en la auditoría. Con el permiso desactivado, la clave solo envía leads.

Cuando su sistema envía un formato propio

Si su sistema no puede enviar en nuestro formato, use "Receber no formato do seu sistema" (Recibir en el formato de su sistema), en el paso 4 del asistente o en "Como conectar" (Cómo conectar), al abrir la integración. Pegue un ejemplo de lo que envía: los campos aparecen solos, y usted indica cuál es el teléfono, el nombre, el correo electrónico y la campaña. El teléfono es obligatorio. Lo que usted no vincule a nada llega a "Dados recebidos" (Datos recibidos). Al abrirlo de nuevo, el diálogo muestra los vínculos que guardó. "Enviar lead de teste" (Enviar lead de prueba) no pasa por el formato de su sistema: funciona igual, y el mensaje de prueba llega con su nombre.

Los últimos leads recibidos

Al abrir una integración, la lista "Últimos leads recebidos" (Últimos leads recibidos) se actualiza sola. Los filtros separan "Novos" (Nuevos), "Contatados" (Contactados), "Responderam" (Respondieron) y "Com problema" (Con problemas). Haga clic en una fila para ver todo lo que ingresó, la base legal, la línea de tiempo y los accesos directos a la conversación y a la ficha.

En la pantalla: Lista de los últimos leads recibidos con los filtros en la parte superior y filas en cola, respondidas, contactadas y una entrada rechazada por teléfono inválido. Cada fila muestra el origen del anuncio, la situación del primer contacto y, cuando la hay, el motivo.

"Na fila" (En la fila) y "Agendado" (Programado)
El mensaje saldrá en segundos, o al comienzo del próximo horario de envío.
"Contatado" (Contactado)
El primer contacto salió. Pasa a "Respondeu" (Respondió) cuando el lead escribe de vuelta.
"Sem envio" (Sin envío)
El lead ingresó, pero el mensaje no salió, por uno de los motivos de arriba. El motivo aparece en la fila.
"Bloqueado" (Bloqueado)
La persona pidió no recibir mensajes. La entrada queda registrada solo con el origen, y su ficha avisa que se registró de nuevo y que no se envía ningún mensaje automático.
"Não confirmado" (No confirmado), "Falhou" (Fallido) y "Sem saldo" (Sin saldo)
Vea qué significa cada uno en costo.
"Recusado" (Rechazado)
El lead no ingresó (sin base legal o sin teléfono, por ejemplo). La fila muestra solo el teléfono enmascarado y el motivo, con el detalle cuando el teléfono es inválido ("veio sem DDD" (vino sin código de área)), y desaparece después de 7 días.

El mismo lead reenviado por su sistema no crea una fila nueva ni cuesta nada: la tarjeta de la integración cuenta esos reenvíos repetidos por separado.

El lead de prueba

"Enviar lead de teste" (Enviar lead de prueba) envía un lead real por la integración, marcado como prueba. Aparece al inicio de la lista con la insignia "Teste" (Prueba) y queda fuera de los números de leads, de los informes de leads y de los webhooks. En la ficha, el botón "Apagar lead de teste" (Eliminar lead de prueba) quita el lead y la conversación del panel.

Clave, pausa y eliminación

"Gerar nova chave" (Generar nueva clave)
Solicita confirmación. Una vez confirmada, la clave actual deja de funcionar de inmediato, y el sistema que usa esta integración necesita recibir la nueva.
Pausar
La integración pasa a rechazar los envíos hasta que usted la reactive. Los primeros mensajes que aún esperaban para salir (fuera de horario o sin saldo) tampoco salen. No se elimina nada.
"Excluir" (Eliminar)
Solicita confirmación. La clave se detiene de inmediato. Los leads y las entradas que ya llegaron permanecen en el panel.

En el panel: "Abrir Integrações" (Abrir Integraciones). Cree la primera integración y envíe un lead de prueba antes de conectar su sistema.

Webhooks: avise a su CRM en cada paso

Su CRM se entera al instante cuando un lead llega, se califica, pasa a un agente, cambia de etapa o se convierte en venta, con cada entrega registrada y el botón Reenviar.

Los Webhooks son la segunda pestaña de "Integrações" (Integraciones). Cada webhook es un endpoint (URL) de su sistema que recibe un aviso por cada evento que usted eligió, firmado con un secreto propio. Todo lo que sale queda en la pestaña Entregas por 30 días, con el cuerpo enviado, la respuesta y cada intento.

Quien programa encuentra los ejemplos de cada evento, la verificación de la firma y las reglas de los reintentos en el botón "Documentação dos webhooks" (Documentación de los webhooks), en la tarjeta "Para quem vai programar o recebimento" (Para quien va a programar la recepción). Esta guía es para quien configura y supervisa.

Crear un webhook

  1. Abra el formulario: Abra "Integrações" (Integraciones) → Webhooks → "Novo webhook" (Nuevo webhook).
  2. Endpoint y eventos: Pegue el endpoint (URL) de su sistema (HTTPS) y elija los eventos, por grupos: lead, atención, embudo y pedidos.
  3. Guarde el secreto: Guarde el secreto de firma: aparece una sola vez.
  4. Pruebe: Haga clic en "Testar" (Probar): el resultado aparece en la propia tarjeta.

En la pantalla: Pestaña Webhooks: los números de los últimos 7 días y las tarjetas de tres endpoints, uno de ellos pausado automáticamente. La pestaña Webhooks, con el estado de salud de cada endpoint.

El interruptor "Ativo" (Activo) pausa el webhook: no se envía nada hasta que usted lo reactive, y los eventos de ese período no quedan en cola. Editar cambia el endpoint y los eventos, y allí también está "Gerar segredo novo" (Generar secreto nuevo): el secreto actual deja de valer de inmediato, así que actualice su sistema enseguida.

Los 13 eventos

Lead creado, lead calificado, lead caliente, asignado a un agente, traspaso a una persona, primer contacto, cambió de etapa, venta, perdido, negocio reabierto, pidió no recibir mensajes, datos eliminados y pedidos importados. El “lead calificado” sale una vez por lead. El aviso de cambio de etapa trae el rol de la columna en el campo role (entrada, calificado, atención, intermedia, ganado o perdido), para que su sistema entienda cualquier tablero (puede venir vacío mientras las columnas del tablero no tengan rol).

Datos personales: no salen

Los avisos llevan identificadores: el ID del lead, el ID en su sistema, la etapa, la nota y los valores. El cambio de etapa y la venta llevan también los campos del negocio que no son sensibles; un campo de texto libre lleva lo que el equipo escribió en él. El nombre, el teléfono, el correo electrónico y el resumen de la conversación no salen, y un campo marcado como sensible nunca sale.

Cuando un titular pide que se eliminen sus datos, sale el aviso "Dados apagados (LGPD)" (Datos eliminados (LGPD)) para que su sistema elimine lo que guardó sobre él, y el comienzo de la respuesta de su sistema se borra del registro de entregas.

Entregas, reintentos y reenvío

Cada aviso se intenta hasta 6 veces: de inmediato, y luego a 1 min, 5 min, 30 min, 2 h y 6 h. En la pestaña Entregas usted ve cada intento; al abrir una entrega, aparecen la respuesta de su sistema y el cuerpo enviado. Reenviar envía con el mismo ID de evento, para que su sistema no duplique. Después de 50 avisos seguidos sin éxito, el webhook se pausa y usted recibe una advertencia.

En la pantalla: Pestaña Entregas: el estado de salud de los últimos 7 días con el gráfico por día y la lista de entregas con sus filtros. El registro de entregas: la salud de los 7 días, el gráfico por día y cada entrega, con Reenviar en las que fallaron.

El aviso de pausa aparece en la tarjeta, en la campana y por correo electrónico. Corrija el endpoint en el sistema que recibe y haga clic en "Reativar" (Reactivar); las entregas que quedaron fuera siguen en el registro, con el botón Reenviar. Los avisos del período en que estuvo pausado solo también están allí, como "Não entregue" (No entregado): no se pierde nada. Reenviar una entrega de un webhook pausado pide "Reativar e reenviar" (Reactivar y reenviar).

Orden y duplicados

Los avisos pueden llegar fuera de orden cuando hay reintentos. Ordene por el campo occurred_at e ignore un event_id que ya llegó. En el traspaso automático con asignación rotativa llegan dos avisos de traspaso, uno de la IA y otro de la asignación.

Endpoints que no se aceptan

El rechazo viene con el motivo específico, debajo del campo del endpoint. Las reglas:

  • https, siempre. http no pasa.
  • Puerto estándar. Un endpoint con un puerto alternativo se rechaza.
  • Sin usuario ni contraseña incluidos en el endpoint.
  • Endpoint público. Un endpoint de la red interna de su empresa se bloquea.

Si el sistema que debe ser avisado existe solo dentro de la red de la empresa, el camino es publicar un endpoint en internet que se comunique con él, en lugar de insistir en registrar aquí el interno.

Quién puede modificar

Los webhooks y las entregas son del propietario de la cuenta. Para los demás roles, las dos pestañas muestran que quedan con el propietario, sin los endpoints y sin el registro. Los webhooks y las entregas no debitan saldo.

En el panel: Abrir Webhooks. Ábralo junto con quien se ocupa de su CRM: el secreto aparece una sola vez.

Conversiones para sus anuncios

Devuelva a Meta a quienes calificaron y compraron

Qué es

Cuando un lead califica, avanza por las etapas de su tablero o cierra un negocio, el panel avisa a Meta. Las campañas aprenden a buscar personas parecidas a quienes avanzaron en su embudo, y no solo a quienes hicieron clic.

En el paso "Escolher o que enviar" (Elegir qué enviar), elija el tablero: cada columna entre la entrada y el cierre ganado puede convertirse en un evento, y el cierre ganado sale como Compra, con el valor.

En la pantalla: La pestaña "Conversões" (Conversiones) de "Integrações" (Integraciones) con la conexión verificada: el control "Enviar conversões" (Enviar conversiones) activado, con las conversiones enviadas de la semana y las coincidentes, y los tres pasos de la configuración — el conjunto de datos conectado, las etapas del tablero "Imobiliária" (Inmobiliaria) con el evento de cada una y la prueba. La pestaña "Conversões" (Conversiones), con el tablero "Imobiliária" (Inmobiliaria).

Antes de comenzar: el conjunto de datos, el token y el código de prueba

Todo ocurre en el "Gerenciador de Eventos" (Administrador de eventos) de Meta, con la cuenta que administra sus anuncios. No requiere revisión ni aprobación de Meta, y usted no entrega contraseña ni acceso al panel.

  1. Cree o elija el conjunto de datos: Si su sitio web ya tiene el Pixel de Meta, use su conjunto de datos. Si no lo tiene, haga clic en "Conectar dados" (Conectar datos), elija Web, luego "Criar novo conjunto de dados" (Crear nuevo conjunto de datos), asígnele un nombre y vincúlelo a la cuenta publicitaria que ejecuta las campañas. No use un conjunto con ícono de celular: pertenece a una aplicación.
  2. Anote el ID: En "Conjuntos de dados" (Conjuntos de datos), abra el conjunto. El ID es el número que aparece debajo del nombre, como "Identificação" (Identificación).
  3. Genere el token: En la pestaña "Configurações" (Configuración) del conjunto, baje hasta "API de Conversões" (API de Conversiones) y, en "Configurar integração direta" (Configurar integración directa), haga clic en "Gerar token de acesso" (Generar token de acceso). Copie el token de inmediato: Meta lo muestra una sola vez. Si elige la opción con la Dataset Quality API, deje marcado solo este conjunto, porque Meta no permite deshacer esa elección.
  4. Copie el código de prueba: En la pestaña "Eventos de teste" (Eventos de prueba), elija el canal "Site" (Sitio web) y abra "Confirme se os eventos do seu servidor estão configurados corretamente" (Confirme que los eventos de su servidor estén configurados correctamente). El código comienza con TEST.
  5. Pegue y verifique: En "Integrações" (Integraciones) → "Conversões" (Conversiones), pegue el ID, el token y el código de prueba y haga clic en "Conferir conexão" (Verificar conexión). La verificación envía a Meta un evento de prueba de "Lead qualificado" (Lead calificado), con un identificador inventado que no coincide con ningún cliente suyo. Los tres campos son obligatorios.
  6. Elija, pruebe y active: Elija las etapas en el paso 2, envíe un evento de prueba en el paso 3 y active "Enviar conversões" (Enviar conversiones) en la parte superior.

Qué se envía y qué nunca se envía

  • Sí: La etapa que el lead alcanzó y la hora en que ocurrió.
  • Sí: El valor de la venta, en reales brasileños.
  • Sí: El ID del formulario del anuncio; sin él, teléfono y correo electrónico cifrados.
  • No: Nombre, conversación, resumen de la IA y datos del negocio.
  • No: Nada de quien pidió no recibir mensajes, fue retirado de las campañas o tuvo sus datos eliminados.

Cómo leer el registro

Cada fila muestra la etapa, el lead, cómo se hizo la coincidencia y el estado: Enviado, "Aguardando" (Pendientes) (nuevo intento programado, o un token nuevo cuando Meta rechazó el token), "Recusado" (Rechazado) (con el motivo y el botón Reenviar) o "Pulado" (Omitido) (sin datos para hacer la coincidencia, solicitud del titular de los datos, plazo que Meta acepta, venta sin valor, sin base legal registrada, etapa desactivada o tablero cambiado antes de que el evento saliera, o dato de salud, que por ahora no se envía).

En la pantalla: El "Registro de envios" (Registro de envíos) de la pestaña "Conversões" (Conversiones): el filtro por estado con los conteos y la tabla con la hora, el lead, el evento, la coincidencia, el estado con el motivo y los intentos. El registro. Reenviar aparece solo en los rechazados y envía el mismo evento, sin duplicar.

"Casadas" (Coincidentes)
Las conversiones que se enviaron con el ID del formulario del anuncio, la coincidencia más precisa.
"Telefone e e-mail" (Teléfono y correo electrónico)
Sin el ID del formulario, se envían el teléfono y el correo electrónico cifrados. Meta los compara sin recibir el número en texto plano.
"Qualidade na Meta" (Calidad en Meta)
La nota que calcula Meta está en el "Gerenciador de Eventos" (Administrador de eventos). El panel no inventa ese número.

Quién responde por la base legal

Su empresa es la responsable de los datos de los leads, y el panel trata esos datos en su nombre. Activar las conversiones es una decisión suya, registrada con su nombre; la sección "O que vai para a Meta" (Lo que se envía a Meta), en la propia pestaña, muestra lo que se envía y lo que nunca se envía.

Preguntas frecuentes

¿Por qué no coincide el clic del anuncio de WhatsApp?
Esa coincidencia depende de un permiso de Meta que todavía no está habilitado. Hoy la conversión coincide por el ID del formulario del anuncio o por el teléfono y el correo electrónico cifrados.
¿Se envía la venta de hace meses?
No. Meta solo acepta eventos de los últimos 7 días. Lo que pasó de ese plazo aparece en el registro como "Pulado" (Omitido), con la fecha del hecho.
Reabrí el negocio y lo gané de nuevo. ¿Se duplica?
No. Cada lead tiene un ID de evento fijo para el cierre ganado, y Meta ignora el segundo envío con el mismo ID.
Marqué la venta sin valor. ¿Se puede corregir?
Sí. Reabra el negocio y marque el cierre ganado de nuevo con el valor: la misma conversión, que estaba como "Pulado" (Omitido) por venta sin valor, vuelve a quedar en espera y se envía con el valor, sin duplicar.
¿Se puede reenviar con el envío desactivado?
No. Con "Enviar conversões" (Enviar conversiones) desactivado, nada se envía a Meta, ni siquiera mediante Reenviar. Active el envío en la parte superior de la pestaña y reenvíe la conversión rechazada.
Meta rechazó mi token. ¿Perdí las conversiones?
No. Quedan en espera y se envían solas cuando usted pega un token nuevo en el paso 1, siempre que el hecho haya ocurrido en los últimos 7 días.