Somente leituraEmail

Conversas de e-mail

email_conversations

Liste e pesquise conversas de e-mail com leads nas caixas que você pode ler, das mais recentes às mais antigas. Filtre por needs_reply (o lead escreveu por último), awaiting_reply, caixa, data ou texto em assuntos, mensagens, remetentes e nomes de leads.

Quando usar

Encontre as conversas de e-mail que aguardam resposta ou pesquise e-mails anteriores com leads em todas as suas caixas.

Escopos necessários

email:accesssalestouch:use

Execução

Chamada síncrona de ferramenta MCP

Requisitos

Conecte pelo menos uma caixa; apenas conversas com leads são armazenadas.

Exemplo

Peça ao seu agente

Quais leads responderam aos meus e-mails e ainda aguardam resposta?

Argumentos da ferramenta

{
  "status": "needs_reply",
  "limit": 20
}

Envelope da resposta MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Conversas das mais recentes às mais antigas com o lead, a caixa, o indicador needs_reply, o número de mensagens e um trecho da última mensagem, além de next_cursor.

Parâmetros

NomeTipoDescrição

query

string

Texto comparado com assuntos, conteúdo das mensagens, remetentes, nomes dos leads e seus endereços de e-mail.

status

string

all (padrão), needs_reply (o lead escreveu por último) ou awaiting_reply (você escreveu por último).

account_id

string

Id ou endereço da caixa retornado por email_accounts. Por padrão, todas as caixas que você pode ler.

since

string

Apenas conversas com atividade desde esta data ISO 8601.

limit

integer

Número máximo de conversas retornadas. Padrão: 20.

cursor

string

next_cursor retornado pela página anterior, reutilizado com os mesmos filtros.

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

Use um espaço de trabalho da SalesTouch com acesso ao MCP do LinkedIn.

trial_payment_method_required

Adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.

EMAIL_ACCOUNT_NOT_FOUND

Use um id ou endereço de caixa retornado por email_accounts.

INVALID_CURSOR

Recomece sem cursor ou reutilize next_cursor exatamente como foi retornado.

Conversas de e-mail

Quando usar

Requisitos

Exemplo

Parâmetros

Erros comuns

Ferramentas relacionadas

Nesta página