SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Status do lead

lead_status

Consulte a prospecção por LinkedIn e e-mail de um lead: datas de contato, aceitação e ações na fila. Encontre-o por perfil do LinkedIn, lead_id ou e-mail. O bloco email lista seus endereços, os últimos e-mails enviados e recebidos e os e-mails agendados. invitation_status verifica um perfil e os bloqueios locais sem percorrer todos os convites. pending está confirmado; eligible indica a elegibilidade do perfil, sem comprovar a ausência de convite; unknown não confirma o estado atual. Envios anteriores incertos e períodos de espera bloqueiam o envio. message acompanha somente o follow-up de linkedin_invite_then_message. message.status=none não comprova a ausência de linkedin_message direto; consulte last_contacted_at. queued indica apenas o agendamento local.

Quando usar

Consulte o miniperfil, o status no CRM, o status da caixa de entrada, as tags, as fontes, o relacionamento, o acompanhamento e o estado das mensagens na fila de um lead.

Escopos necessários
linkedin:accesssalestouch:use
Execução
Chamada síncrona de ferramenta MCP

Requisitos

Forneça lead_id, followup_id ou um membro-alvo do LinkedIn.

Exemplo

Peça ao seu agente

Verifique o status do lead da SalesTouch para https://www.linkedin.com/in/example.

Argumentos da ferramenta
{
  "linkedin_url": "https://www.linkedin.com/in/example"
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: O registro do diretório de leads junto com o estado atual do relacionamento e da prospecção.

Parâmetros

crm_scope
string

Escopo do CRM: organization, member:<id> ou group:<id>. Por padrão, seu grupo compartilhado ou CRM pessoal.

account_id
string

ID, nome de usuário, e-mail, identificador ou URL da conta da SalesTouch conectada.

identifier
string

Identificador, ID público, ID da conta ou URL do perfil do membro do LinkedIn.

lead_id
string

ID canônico do lead da SalesTouch retornado por lead_status or leads_search.

followup_id
string

ID opcional do acompanhamento após o convite.

email
string

E-mail do lead. Encontra um lead importado ou contatado nesse endereço.

Os aliases são exibidos separadamente porque os clientes MCP enviam um objeto JSON plano. Use apenas um alias de cada grupo obrigatório, não todos os aliases.

Erros comuns

insufficient_scope

Reconecte o MCP e aprove a permissão solicitada do LinkedIn.

paid_plan_required

Siga a action_url do erro: inicie o período de teste gratuito, escolha um plano se o teste ou a assinatura terminou, ou atualize a forma de pagamento após um pagamento recusado. details.reason indica o caso.

trial_payment_method_required

Tente novamente em um minuto se o checkout acabou de ser concluído; caso contrário, adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.