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.
- 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.
- Elija su espacio de trabajo y cree la aplicación.
- Instale la aplicación en su espacio de trabajo y apruebe los permisos.
- En OAuth & Permissions, copie el Bot User OAuth Token. Empieza por
xoxb-.
Conéctelo en Phynxa
- Integrations, Connect en Slack.
- Pegue el Bot User OAuth Token. Opcionalmente escriba un Default channel, por ejemplo
#sales. - 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).
| Ajuste | Significado |
|---|---|
| Bot User OAuth Token | Obligatorio. Debe empezar por xoxb-. Un token de usuario (xoxp-) o de aplicación (xapp-) se rechaza. |
| Default channel | Opcional. 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ón | Qué hace | Se ejecuta |
|---|---|---|
| Send message | Publica texto en un canal (text obligatorio, channel opcional; si no, el canal predeterminado). | En segundo plano |
| Send direct message | Encuentra 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
- Test connection debe responder «Slack is responding.»
- 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
/inviteen 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.
