一份有效的债务纠纷私了协议书，应当详细、明确地反映双方的债务关系及还款安排，以确保在发生争议时能够作为有力的法律证据。以下是一份有效的债务纠纷私了协议书应包含的关键要素和撰写建议：

一、明确当事人信息

• 详细列出双方当事人的信息：包括姓名、身份证号码（或统一社会信用代码，如涉及企业）、联系方式（电话、邮箱、住址等），确保能够准确识别协议主体，方便后续联系和法律责任追究。

二、债务具体内容

• 清晰列出债务金额：具体到个位数，避免模糊表述。
• 说明债务产生的原因：如借款、买卖交易欠款、服务费用等，提供债务产生的背景。
• 阐述债务的用途：如用于购房、经营、个人消费等，这有助于理解债务的性质和合理性。

三、约定还款条款

• 确定还款方式：明确是一次性还清还是分期偿还。
  • 如为分期偿还，应详细列出每期还款的日期和金额，确保还款计划清晰可行。
• 考虑利息和费用：如有约定利息或其他费用，应明确计算方式和支付时间。

四、规定违约责任

• 明确违约责任：若一方未按协议履行义务，应明确其需承担的后果，如支付逾期利息、违约金等。
• 设定合理的违约条款：确保违约条款既具有威慑力又符合法律法规的要求，避免过高或过低的违约金导致协议无效。

五、确保自愿签订

• 强调双方自愿：协议必须是双方自愿签订的，不存在欺诈、胁迫、乘人之危等影响意思表示真实性的情况。
• 建议录音录像：在签订协议时，可考虑录音录像以证明签订过程的自愿性和合法性。

六、协议形式与签字

• 书面形式：协议应采用书面形式，避免口头协议带来的不确定性。
• 双方签字或盖章：协议应由双方当事人亲自签字或盖章，并注明签订日期。
• 考虑公证：如有必要，可对协议进行公证，以增强其法律效力。

七、其他注意事项

• 语言清晰准确：避免使用模糊、含糊的语言，确保协议内容清晰易懂。
• 遵守法律法规：协议内容应符合国家法律法规的强制性规定，不得违反公序良俗。
• 保留证据：签订协议后，双方应妥善保管协议原件，以备不时之需。

综上所述，一份有效的债务纠纷私了协议书应包含明确的当事人信息、详细的债务内容、清晰的还款条款、合理的违约责任以及双方自愿的签字确认。在撰写协议时，应确保内容合法、语言清晰、条款合理，以充分保障双方的合法权益。