Salesforce
Conecte Salesforce con su propia aplicación OAuth para que un agente pueda crear clientes potenciales, asociar notas y leer la actividad durante una llamada.
Qué conseguirá
Un agente podrá crear un Lead en Salesforce, asociar una nota a un registro y leer la actividad reciente.
Descripción general y casos de uso
- Convertir a cada nuevo interlocutor en un Lead de Salesforce.
- Asociar una nota de la llamada a un registro.
- Consultar lo registrado de un contacto a partir de su correo.
Requisitos previos
- Una organización de Salesforce en la que pueda crear una aplicación OAuth (una Connected App o una External Client App), normalmente un administrador.
- Para usar un sandbox, el host de inicio de sesión de este.
Configuración de la cuenta externa (en Salesforce)
Salesforce controla estas pantallas. La referencia de Salesforce: REST API resources.
- En Setup, cree una aplicación OAuth con la URL de callback (de redireccionamiento) que muestra el cuadro Connect de Phynxa.
- Permita los ámbitos
api,refresh_tokenyoffline_access. - Copie la Consumer Key (Client ID) y el Consumer Secret (Client secret).
Conéctelo en Phynxa
- Integrations, Connect en Salesforce.
- Escriba el Client ID, el Client secret y el Login host:
https://login.salesforce.compara producción,https://test.salesforce.compara un sandbox. - Continúe hasta Salesforce y apruebe. La tarjeta muestra Connected.
Permisos y ajustes
| Elemento | Para qué |
|---|---|
Ámbito api | Leer y escribir registros |
Ámbitos refresh_token, offline_access | Seguir conectado sin volver a pedírselo |
| Login host | Los sandboxes inician sesión en test.salesforce.com |
Phynxa llama a la URL de instancia que Salesforce devuelve con el token (nunca al host de inicio de sesión), con la versión de API v67.0.
Úselo en una llamada
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Create lead | Crea un Lead. Si falta el apellido o la empresa, se rellena con «Unknown». | En segundo plano |
| Add note | Crea una Note en un registro. Necesita un contact id; sin él devuelve «A contact_id is needed to attach the note.» | En segundo plano |
| Fetch customer history | Enumera las tareas recientes del contacto, por contact id o por correo. | Espera |
| Update contact | Cambia el nombre, el correo, el teléfono o la empresa de un contacto; solo se cambia lo que indique. Necesita el id del contacto de una consulta de historial. | En segundo plano |
| Create task | Crea una tarea de seguimiento para su equipo (subject, y opcionales body y due_date como 2026-11-02), vinculada a un contacto si indica su id. | En segundo plano |
| Create ticket | Abre un caso de soporte con un subject y un body opcional, vinculado a un contacto si indica su id. | En segundo plano |
Pruébelo
Test connection en la tarjeta. Después asocie Create lead a un agente, pídale en Chat que guarde un cliente potencial y revise Leads en Salesforce.
Resultado esperado
Aparece un Lead en Salesforce y la tarjeta cuenta una solicitud correcta.
Solución de problemas
- invalid_client o discrepancia de redireccionamiento. La URL de callback de su aplicación debe coincidir exactamente con la de Phynxa.
- El sandbox no puede iniciar sesión. Use
https://test.salesforce.comcomo host de inicio de sesión. - Se rechaza el acceso a REST. El usuario que inició sesión necesita acceso a la API y su aplicación debe permitir el ámbito
api.
Seguridad y credenciales
El consumer secret se almacena cifrado. Conéctese como un usuario cuyos permisos correspondan a lo que quiere que haga el agente. Remove elimina la conexión; revoque la aplicación en Salesforce si deja de usarla.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.