Convite do LinkedIn
linkedin_inviteEnvie um convite do linkedin diretamente após resolver a identidade e obter um bloqueio persistente por destinatário. IDs de perfil conhecidos não exigem verificação prévia do perfil nem consulta aos convites enviados. Trate explicitamente as recusas do provedor; um prazo de 3 semanas não comprova que já existe um convite pendente. Envios confirmados exigem autorização explícita para reenviar. Resultados incertos bloqueiam novas tentativas.
Quando usar
Envie um convite de conexão no LinkedIn, opcionalmente com uma nota curta.
linkedin:accesssalestouch:useRequisitos
Exemplo
Convide https://www.linkedin.com/in/example para se conectar com a nota “Gostaria muito de me conectar.”
{
"linkedin_url": "https://www.linkedin.com/in/example",
"message": "Would love to connect.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: Um resultado de convite enviado ou colocado na fila.
Parâmetros
account_idstringID, nome de usuário, e-mail, identificador ou URL da conta da SalesTouch conectada.
identifierobrigatóriostringIdentificador, ID público, ID da conta ou URL do perfil do membro do LinkedIn.
queuebooleanDefina como true para colocar esta ação na fila quando não puder ser executada agora.
scheduled_forstringData e hora ISO 8601 futura com fuso horário. A ação nunca será executada antes desse horário e o enfileiramento é implícito.
textstringNota de convite opcional.
retry_invitationbooleanAutorização explícita para outra tentativa após um envio confirmado. Nunca ignora resultados incertos nem o prazo de 3 semanas registrado; não percorre todos os convites.
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_scopeReconecte o MCP e aprove a permissão solicitada do LinkedIn.
paid_plan_requiredSiga 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_requiredTente 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.
action_limit_queue_requiredRepita a chamada com queue definido como true.
invitation_cooldownNão tente novamente automaticamente. Consulte lead_status para distinguir um convite pendente de uma solicitação tratada recentemente; um reenvio posterior exige autorização explícita.
invitation_status_unknownConsulte lead_status novamente. Não envie nem tente de novo automaticamente enquanto invitation_status for unknown.
invitation_outcome_unknownConsulte lead_status novamente. Não envie nem tente de novo automaticamente enquanto invitation_status for unknown.
invitation_note_too_longMantenha a nota abaixo de 300 caracteres (200 em contas gratuitas) ou chame retry_tool com retry_with para enviá-la sem nota.
invitation_note_unavailableA conta esgotou seus convites personalizados. Chame retry_tool com retry_with para enviar o convite sem nota.
invitation_limit_reachedA conta atingiu o limite semanal de convites do LinkedIn. Pare de convidar a partir dela por vários dias; coloque os convites na fila ou agende-os.
invitation_already_pendingUm convite já foi enviado. Verifique lead_status; não envie outro.
invitation_requires_emailEste membro só aceita convites de pessoas que conhecem seu e-mail. Entre em contato de outra forma.