TikTok Business y Widget WebChat

Amplía tu cobertura digital capturando conversaciones en TikTok Business Messaging y directamente desde las páginas de tu sitio corporativo o e-commerce mediante el Widget WebChat nativo.

1. TikTok Business Messaging

Matias Impulso soporta tanto el flujo oficial OAuth 2.0 de TikTok Business como el registro manual de credenciales empresariales verificadas:

• Autorización guiada: solicita la URL firmada en GET /tiktok/oauth/url, completa el consentimiento en TikTok y canjea el código mediante POST /tiktok/oauth/exchange.
• Recepción en tiempo real: configura el webhook de TikTok apuntando a https://api.matiasimpulso.com/tiktok/webhook para recibir mensajes entrantes, enrutarlos al Router Multi-Agente de IA y clasificar cada lead en tu Embudo Kanban.

---

2. Widget WebChat Embebible

El módulo WebChat te permite incrustar un asistente en vivo (atendido por IA, flujos o asesores humanos) en cualquier sitio HTML, Astro, WordPress, Shopify, VTEX o aplicación SPA sin dependencias externas.

Creación e Instalación del Widget

1. Crea el widget en el panel

   Ve a Administración → Conexiones → WebChat (POST /webchat/widgets) y personaliza el título, subtítulo, color de marca, posición en pantalla, dominios autorizados (allowedOrigins) y el Agente de IA asignado.

2. Copia e inserta el script ligero en tu sitio web

   Pega el fragmento antes del cierre de </body> reemplazando <YOUR_WIDGET_KEY> por la llave pública del widget:

Snippet HTML Embebible

<script
  src="https://api.matiasimpulso.com/webchat/widget.js"
  data-widget-key="<YOUR_WIDGET_KEY>"
  async
  defer
></script>

Integración Headless (SDK REST)

// 1. Iniciar o reanudar sesión de visitante
const sessionRes = await fetch(
  'https://api.matiasimpulso.com/webchat/public/<YOUR_WIDGET_KEY>/session',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      visitorName: 'Laura Gómez',
      visitorEmail: 'laura@ejemplo.com',
    }),
  },
);
const { sessionToken } = await sessionRes.json();

// 2. Enviar mensaje desde interfaz propia
await fetch(
  'https://api.matiasimpulso.com/webchat/public/<YOUR_WIDGET_KEY>/messages',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Webchat-Session': sessionToken,
    },
    body: JSON.stringify({ body: 'Hola, deseo cotizar el plan Empresarial' }),
  },
);

Rotación de Llaves sin Tiempo de Inactividad

Si sospechas exposición no deseada o cambias de agencia web, utiliza POST /webchat/widgets/:id/rotate-key para invalidar la llave pública anterior y emitir una nueva al instante.