PortalFirma

api-integration · Session

Session

Resuelve la sesión de un partner por teléfono y emite un access_token MCP sellado (sin IDs en claro). Puente habitual hacia MCP para WhatsApp / N8N.

POST{URL}/session/resolveByPhone

Resuelve partner por teléfono y puede devolver access_token MCP (`pf_mcp_at_*`).

  • El controller no exige JWT; sí el header `id` global.
  • Si no hay partner para el teléfono: `access_token: null`.
  • IDs de partner van cifrados dentro del access_token.
  • Puente típico hacia MCP (WhatsApp / N8N).
Body
{
  phone: string
}
Headers
id
{api-key}

Response

Success
{
  success: true,
  data: {
    access_token: string | null,
    token_type: "Bearer" | null,
    expires_in: number | null
  },
  error: null
}
Error
{
  success: false,
  data: null,
  error: <error description>
}