Enviar e-mail
email_sendEnvie um e-mail pessoal 1:1 a partir da caixa de correio conectada do próprio usuário, como nova conversa ou como resposta. Os envios respeitam os limites diários, o aquecimento e o horário de trabalho da caixa; envios na fila informam scheduled_for. Uma resposta em qualquer canal cancela a prospecção colocada na fila antes dela, a menos que stop_on_reply seja false. Não serve para newsletters nem envios em massa.
Quando usar
Envie um e-mail pessoal a um lead a partir da sua própria caixa de correio ou responda em uma conversa de e-mail existente.
email:accesssalestouch:useRequisitos
Exemplo
Envie para Ada um breve follow-up por e-mail sobre a demo da semana passada e coloque-o na fila dentro dos meus limites de envio.
{
"lead_id": "lead_example",
"subject": "Following up on the demo",
"body": "Hi Ada,\n\nThanks again for your time last week. Would a short call on Thursday work?\n\nBest,",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: Um resultado enviado com os ids da conversa e da mensagem, ou um resultado na fila com queued_action_id e scheduled_for.
Parâmetros
account_idstringId ou endereço de e-mail de uma caixa de correio conectada retornado por email_accounts. Padrão: a caixa já usada com o lead e, depois, a que tem mais capacidade diária livre.
lead_idstringID canônico do lead da SalesTouch retornado por lead_status or leads_search.
tostringEndereço de e-mail do destinatário. Obrigatório sem lead_id; com lead_id, ele é associado a esse lead.
first_namestringPrimeiro nome do destinatário, salvo quando o endereço cria um novo lead.
last_namestringSobrenome do destinatário, salvo quando o endereço cria um novo lead.
subjectstringAssunto do e-mail. Obrigatório para uma nova conversa; as respostas reutilizam o assunto da conversa.
bodyobrigatóriostringCorpo do e-mail em texto simples. A assinatura da caixa de correio é adicionada.
reply_to_thread_idstringId da conversa de e-mail retornado por email_threads. A resposta é enviada pela caixa de correio dessa conversa.
stop_on_replybooleanIgnora este e-mail na fila se o lead responder em qualquer canal antes do envio. Padrão: true.
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.
queuebooleanDefina como true para colocar esta ação na fila quando não puder ser executada agora.
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_requiredUse um espaço de trabalho da SalesTouch com acesso ao MCP do LinkedIn.
trial_payment_method_requiredAdicione 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.
email_account_requiredConecte uma caixa de correio nas configurações da SalesTouch e tente novamente.
email_reconnect_requiredReconecte a caixa de correio nas configurações da SalesTouch e tente novamente.
lead_email_missingImporte um endereço de e-mail para o lead com leads_import ou informe to.
email_recipient_suppressedNão tente novamente: este endereço já retornou erro de entrega. Encontre outro endereço para o lead.