Saltar al contenido principal

Slack

Conecte Slack con un token de bot para que un agente avise a un canal o escriba a un miembro del equipo cuando una llamada necesite a una persona.

Qué conseguirá

Un agente podrá publicar un mensaje en un canal de Slack, o escribir a una persona por su correo de trabajo, por ejemplo cuando quien llama es un cliente potencial caliente o pide que le devuelvan la llamada.

Descripción general y casos de uso

  • Avisar a #sales en el momento en que llama un cliente potencial caliente, con su número y lo que quiere.
  • Decir a un miembro del equipo concreto que alguien preguntó por él.
  • Señalar un problema urgente en el canal adecuado.

Slack no sustituye a su CRM: es el aviso, y el CRM es el registro.

Requisitos previos

  • Un espacio de trabajo de Slack en el que pueda instalar una aplicación. Algunos espacios de trabajo de empresas exigen que un administrador apruebe las aplicaciones nuevas.
  • En el plan gratuito de Slack, el número de aplicaciones instaladas es limitado.

Configuración de la cuenta externa (en Slack)

Slack controla estas pantallas. La referencia de Slack: chat.postMessage.

  1. En el cuadro Connect de Slack en Phynxa, elija Get them here. Slack abre su pantalla create an app con la definición de la aplicación de Phynxa (su nombre y los permisos de abajo) ya rellenada.
  2. Elija su espacio de trabajo y cree la aplicación.
  3. Instale la aplicación en su espacio de trabajo y apruebe los permisos.
  4. En OAuth & Permissions, copie el Bot User OAuth Token. Empieza por xoxb-.

Conéctelo en Phynxa

  1. Integrations, Connect en Slack.
  2. Pegue el Bot User OAuth Token. Opcionalmente escriba un Default channel, por ejemplo #sales.
  3. Elija Check and connect. Phynxa pide a Slack que confirme el token antes de guardarlo. La tarjeta muestra Connected con el nombre de su espacio de trabajo.

Permisos y ajustes

Ámbitos del bot: chat:write (publicar mensajes), chat:write.public (publicar en canales públicos sin unirse), im:write (abrir un mensaje directo), users:read y users:read.email (encontrar a una persona por su correo).

AjusteSignificado
Bot User OAuth TokenObligatorio. Debe empezar por xoxb-. Un token de usuario (xoxp-) o de aplicación (xapp-) se rechaza.
Default channelOpcional. Adónde van los mensajes cuando una herramienta no nombra ninguno. Para un canal privado, use su ID de canal y añada la aplicación a él.

Úselo en una llamada

AcciónQué haceSe ejecuta
Send messagePublica texto en un canal (text obligatorio, channel opcional; si no, el canal predeterminado).En segundo plano
Send direct messageEncuentra a una persona por su correo y le envía un mensaje directo (email y text obligatorios).En segundo plano

Indique al agente en su system prompt cuándo usarlo, por ejemplo: «If the caller is ready to buy or asks for a callback, send a Slack message to #sales with their name, number and what they want.» Sin esa regla, puede publicar con demasiada frecuencia.

Los mensajes se envían como texto sin formato. Los caracteres &, < y > se escriben de forma literal, de modo que un agente no pueda avisar a @channel por accidente, y se desactivan las vistas previas de enlaces.

Pruébelo

  1. Test connection debe responder «Slack is responding.»
  2. En el Chat de un agente, pídale que envíe un mensaje de prueba a su canal y mire en Slack.

Resultado esperado

El mensaje aparece en el canal, enviado por la aplicación que usted creó.

Solución de problemas

  • «Slack did not accept the token.» Vuelva a copiar el Bot User OAuth Token.
  • «Paste the Bot User OAuth Token. It starts with xoxb-…» Pegó un token distinto.
  • «Slack cannot find that channel.» En un canal privado, añada la aplicación (escriba /invite en el canal y elija la aplicación) y use el ID del canal.
  • «The app is not in that channel.» Añádala con /invite.
  • «The Slack app is missing a permission.» Añada el ámbito indicado en OAuth & Permissions, reinstale la aplicación y pegue el token nuevo.
  • «No active Slack user has that email address.» La persona debe estar en su espacio de trabajo de Slack y activa.
  • «Slack is limiting how fast the app can post.» Slack permite aproximadamente un mensaje por segundo y canal; inténtelo de nuevo en breve.

Seguridad y credenciales

El token se almacena cifrado y no se vuelve a mostrar. Puede publicar y buscar personas, pero no leer el historial de los canales. Las transcripciones y los números de teléfono son datos personales: limite los mensajes a los hechos que una persona necesita y publique en canales privados cuando proceda. Para revocarlo, desinstale la aplicación en Slack; Remove elimina el token aquí.

Guías relacionadas

¿Algo de esto no coincide con lo que ve en el panel? Avísenos.